Visualizações de mapa

As visualizações de mapa mostram os resultados em um mapa geográfico. O conjunto de resultados de consulta deve incluir os dados geográficos apropriados:

• Choroplata: localidades geográficas, como países ou estados, são coloridas de acordo com os valores agregados de cada coluna chave. A consulta deve retornar locais geográficos por nome ou como uma coluna GEOMETRY ou GEOGRAPHY . Para obter um exemplo, consulte exemplo de mapa coroplético.
• Mapa de pontos: um marcador é colocado em um conjunto de coordenadas no mapa. O resultado da consulta deve retornar pares de latitude e longitude ou uma coluna GEOMETRY ou GEOGRAPHY . Para obter um exemplo, consulte exemplo de marcador.

Você também pode renderizar formas de uma coluna GEOMETRY ou GEOGRAPHY em vez de depender de limites administrativos predefinidos ou colunas separadas de latitude e longitude. Consulte dados geográficos personalizados.

Opções de mapa coroplético

Um mapa choroplata colore regiões geográficas , como países, estados ou condados, com base em um valor numérico em seus dados.

Exemplo

Na guia Dados , clique em + Adicionar conjunto de dados SQL, cole a seguinte consulta e execute-a:

Conjunto de dados de exemplo

SELECT state, total_sales
FROM VALUES
  ('California', 98750),
  ('Texas', 87200),
  ('New York', 76300),
  ('Florida', 65100),
  ('Illinois', 54800),
  ('Pennsylvania', 48200),
  ('Ohio', 43500),
  ('Georgia', 41200),
  ('North Carolina', 39700),
  ('Michigan', 36100),
  ('New Jersey', 34800),
  ('Virginia', 32500),
  ('Washington', 31200),
  ('Arizona', 29700),
  ('Massachusetts', 28400),
  ('Tennessee', 26900),
  ('Indiana', 25100),
  ('Missouri', 23800),
  ('Maryland', 22600),
  ('Wisconsin', 21300),
  ('Minnesota', 20100),
  ('Colorado', 19400),
  ('Alabama', 18200),
  ('South Carolina', 17600),
  ('Louisiana', 16900),
  ('Kentucky', 15800),
  ('Oregon', 14700),
  ('Oklahoma', 13600),
  ('Connecticut', 12500),
  ('Utah', 11900),
  ('Iowa', 11200),
  ('Nevada', 10800),
  ('Arkansas', 10100),
  ('Mississippi', 9600),
  ('Kansas', 9200),
  ('New Mexico', 8700),
  ('Nebraska', 8300),
  ('West Virginia', 7900),
  ('Idaho', 7400),
  ('Hawaii', 7100),
  ('New Hampshire', 6800),
  ('Maine', 6400),
  ('Montana', 6100),
  ('Rhode Island', 5800),
  ('Delaware', 5400),
  ('South Dakota', 5100),
  ('North Dakota', 4800),
  ('Alaska', 4500),
  ('Vermont', 4200),
  ('Wyoming', 3900)
AS t(state, total_sales);

No editor de visualização, configure o seguinte:

1. Defina o tipo de visualização como o mapa Choropleth.
2. Na seção Região , em País, clique no Ícone de adição. Em Values, clique em Selecionar um país e selecione Estados Unidos.
3. Na seção Região , em Estado/Província , clique no Ícone de adição. Em Campos, selecione state.
4. Em Cor, clique no Mais ícone, selecione total_salese defina a transformação como SOMA.

Region

A configuração região informa ao mapa como interpretar os valores de localização em seus dados. Escolha o formato que corresponde aos seus dados:

• Administrativo: País, Estado/Província, Condado/Cidade, Cidade/Município ou Cidade/Vila
• Postal: CEP ou cep.
• CSA/CSAB: Designações de área estatística do Us Census Bureau. A CSA (Áreas Estatísticas Combinadas) agrupa áreas metropolitanas e micropolitanas adjacentes com laços econômicos. A CBSA (Áreas Estatísticas Baseadas em Núcleo) abrange áreas metropolitanas e micropolitanas individuais.
• Legislativo: distritos legislativos dos EUA, incluindo distritos congressionais e distritos do Senado estadual.
• NUTs: Nomenclatura da UE de Unidades Territoriais para Estatísticas. Dá suporte a três níveis: NUTS 1 (regiões socioeconômicas principais), NUTS 2 (regiões básicas para a aplicação de políticas regionais) e NUTS 3 (regiões pequenas para diagnósticos específicos).
• Geometria personalizada: selecione uma coluna GEOMETRY ou GEOGRAPHY para renderizar limites de região diretamente de seus dados. Consulte dados geográficos personalizados.

Se um valor em sua coluna de localização não corresponder ao formato selecionado, nenhum dado será mostrado para essa região. Baixe as seguintes tabelas de pesquisa para verificar quais nomes e abreviações têm suporte:

• country-names.csv
• state-province-names.csv
• county-district-names.csv
• town-names.csv
• city-village-names.csv
• senate-names.csv
• congressional-district-codes.csv
• zipcode-codes.csv
• us-csa-codes.csv
• us-cbsa-codes.csv
• eu-nuts-1-codes.csv
• eu-nuts-2-codes.csv
• eu-nuts-3-codes.csv

Observação

Use a name_en coluna para localizar valores, mas use uma das outras colunas como o identificador em sua consulta.

Cores

As cores são preenchidas automaticamente para cada região que tem dados. Clique na amostra de cores para escolher uma cor diferente.

Para colorir regiões por um campo numérico, clique no Mais ícone na seção Cor e selecione um campo. Você pode aplicar uma transformação como SUM ou MEDIAN. O mapa aplica um gradiente de cor entre o intervalo de valores. Para personalizar as cores, o gradiente e os rótulos, clique na amostra de cores.

Opções de mapa de pontos

Esta seção descreve as opções para gráficos de mapa de pontos.

Exemplo

Na guia Dados , clique em + Adicionar conjunto de dados SQL, cole a seguinte consulta e execute-a:

SELECT city, latitude, longitude, population
FROM VALUES
  ('New York',     40.7128,  -74.0060, 8336817),
  ('Los Angeles',  34.0522, -118.2437, 3979576),
  ('Chicago',      41.8781,  -87.6298, 2693976),
  ('Houston',      29.7604,  -95.3698, 2320268),
  ('Phoenix',      33.4484, -112.0740, 1608139),
  ('Philadelphia', 39.9526,  -75.1652, 1603797),
  ('San Antonio',  29.4241,  -98.4936, 1434625),
  ('San Diego',    32.7157, -117.1611, 1386932),
  ('Dallas',       32.7767,  -96.7970, 1304379),
  ('San Jose',     37.3382, -121.8863, 1013240)
AS t(city, latitude, longitude, population);

No editor de visualização, configure o seguinte:

1. Em Coordenadas, selecione Longitude/Latitude.
   1. Em Longitude, clique no mais ícone e selecione longitude.
   2. Em Latitude, clique no mais ícone e selecione latitude.
2. Em Tamanho, clique no mais ícone e selecione population.

Coordenadas

Use o editor de visualização para configurar as Coordenadas:

• Longitude/Latitude: escolha a coluna que contém os componentes longitude e latitude das coordenadas do mapa.
• Geometria: selecione uma coluna GEOMETRY ou GEOGRAPHY para usar como o local do ponto em vez de colunas de latitude e longitude separadas. Consulte dados geográficos personalizados.

Cor

Para dados desagrupados, clique na amostra de cores para alterar as cores de ponto mostradas no mapa. Para aplicar uma estratégia de agrupamento, clique no Mais ícone na seção Cor do editor de visualização. Você pode ajustar as cores atribuídas automaticamente clicando na amostra de cores ao lado de cada rótulo de grupo no editor.

Tamanho

Clique no mais um ícone na seção Tamanho para escolher um campo que reflita a quantidade, permitindo que você exiba pontos de tamanhos variados com base no valor dos dados.

Dados geográficos personalizados

Você pode renderizar mapas diretamente de uma coluna GEOMETRY ou GEOGRAPHY em qualquer conjunto de dados. Use isso para visualizar formas personalizadas, como territórios de vendas, distritos escolares e áreas de captação de armazenamento, ou para plotar pontos sem dividir coordenadas em colunas separadas de latitude e longitude.

Cada linha é desenhada de forma independente, portanto, formas ou pontos podem se sobrepor se seus dados tiverem várias linhas por região. Para combinar linhas em uma única forma por região, use uma medida de geometria em uma exibição de métrica. Consulte limitações e exibiçõesde métrica local.

Definir uma exibição de métrica com uma medida de geometria

Em seu yaml de exibição de métrica, defina a coluna de geometria ou geografia como uma medida usando uma das agregações com suporte: ST_UNION_AGG, , ST_ENVELOPE_AGGou FIRSTLAST. Use dimensões para as colunas não geométricas pelas quais você deseja agrupar.

A seguinte exibição de métrica local define region como uma dimensão, total_sales como uma medida numérica, e usa ST_UNION_AGG para combinar limites por linha em uma única forma por região:

version: 0.1
source: sales.territories

dimensions:
  - name: region
    expr: region

measures:
  - name: total_sales
    expr: SUM(sales_amount)
  - name: region_shape
    expr: ST_UNION_AGG(boundary)

Se os dados geográficos forem armazenados como uma cadeia de caracteres serializada ou valor binário, converta-os GEOMETRY para ou GEOGRAPHY na expressão de medida.

Criar um mapa choroplato

O Choropleth mapeia o suporte Polygon e MultiPolygon as formas.

1. Adicione a exibição de métrica como um conjunto de dados.
2. Defina o tipo de visualização como o mapa Choropleth.
3. Em Região, selecione Geometria personalizada e selecione sua medida de geometria (por exemplo, region_shape).
4. Em Cor, selecione uma medida numérica, como total_sales.

Criar um mapa de pontos

O ponto mapeia o suporte Point e MultiPoint as formas. Use uma Pointmedida de geometria com valor como FIRST(location) ou ST_UNION_AGG(location).

1. Adicione a exibição de métrica como um conjunto de dados.
2. Defina o tipo de visualização como mapa de ponto.
3. Em Coordenadas, selecione Geometria e selecione sua medida de geometria.
4. (Opcional) Em Tamanho, selecione uma medida numérica para variar os tamanhos dos pontos.

Limitações

• GROUP BY não há suporte em colunas ou colunas GEOMETRYGEOGRAPHY . Para combinar várias linhas em uma única forma por grupo, agregar geometria como uma medida de exibição de métrica usando ST_UNION_AGG, ST_ENVELOPE_AGG, FIRSTou LAST. Caso contrário, cada linha será renderizada de forma independente e as formas poderão se sobrepor.
• O renderizador de mapa usa WGS84 (SRID 4326). GEOMETRY colunas em outros SRIDs são reprojetadas automaticamente; GEOGRAPHY as colunas já devem ser SRID 4326. Use ST_Transform na expressão de medida para reprojetar, se necessário.
• GEOMETRY colunas com SRID 0 (sistema de coordenadas desconhecido) não são renderizadas.
• GeometryCollection não há suporte para valores e colunas que misturam vários tipos de forma.
• Não há suporte para codificações de rótulo em mapas que usam uma coluna de geometria ou geografia.