Visualizações de mapas

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

• Coroplético : 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 localizações geográficas por nome ou como uma coluna GEOMETRY ou GEOGRAPHY. Para ver 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 ver um exemplo, consulte exemplo de marcador.

Também é possível renderizar formas a partir de uma coluna de GEOMETRIA ou GEOGRAFIA, em vez de depender de limites administrativos predefinidos ou de colunas separadas de latitude e longitude. Consulte Dados geográficos personalizados.

opções de coroplética

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

Exemplo

Na **tab Data**, clique em **+ Adicionar dataset SQL**, cole a seguinte consulta e execute-a:

datasetde amostra

SQL

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 Mapa coroplético .
2. Na seção Região , em País , clique no ícone de mais . Em Valores , clique em Selecione um país e selecione Estados Unidos .
3. Na seção **Região**, em **Estado/província**, clique no ícone de mais. Em **Campos**,state selecione.
4. Em Cor , clique em ícone de mais, selecione total_sales e defina a transformação para SOMA .

Região

A **configuração de 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 , Município/cidade , Cidade/Município ou Cidade/Vila
• Postal: CEP ou códigos postais.
• CSA / CSAB: Designações de áreas estatísticas do Departamento do Census dos EUA. 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 do congresso e distritos do senado estadual.
• NUTs: Nomenclatura das Unidades Territoriais para Fins Estatísticos da União Europeia. Suporta três níveis: **NUTS 1** (grandes regiões socioeconômicas), **NUTS 2** (regiões básicas para a aplicação de políticas regionais) e **NUTS 3** (pequenas regiões para diagnósticos específicos).
• Geometria personalizada: Selecione uma coluna GEOMETRY ou GEOGRAPHY para renderizar limites de região diretamente dos seus dados. Consulte Dados geográficos personalizados.

Se um valor na sua coluna de localização não corresponder ao formato selecionado, nenhum dado será exibido para essa região. Faça o download das seguintes tabelas de consulta para verificar quais nomes e abreviações são suportados:

• nomes-de-países.csv
• nomes-de-estados-províncias.csv
• nomes-distritos-condado.csv
• nomes-das-cidades.csv
• nomes-cidades-vilas.csv
• nomes-do-senado.csv
• códigos-distritais-congressuais.csv
• códigos-zip.csv
• us-csa-codes.csv
• us-cbsa-codes.csv
• eu-nuts-1-codes.csv
• eu-nuts-2-codes.csv
• eu-nuts-3-codes.csv

nota

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

Cores

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

Para colorir regiões por um campo numérico, clique em Clique no ícone de mais (+) na seção Cor e selecione um campo. Você pode aplicar transformações como SUM ou MEDIAN. O mapa aplica um gradiente de cores ao longo da gama de valores. Para personalizar as cores, o gradiente e o rótulo, clique na amostra de cor.

Opções de mapa de pontos

Esta seção descreve as opções para mapas de pontos.

Exemplo

Na **tab Data**, clique em **+ Adicionar dataset SQL**, cole a seguinte consulta e execute-a:

SQL

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 ícone de mais e selecione longitude.
   2. Em Latitude,clique no ícone de mais e latitude selecione.

2. Em **Tamanho**, clique no ícone de adicionar e selecione.population

Coordenadas

Utilize o Editor de visualizações para configurar as Coordenadas :

• **Longitude / Latitude**: escolha a coluna que contém os componentes de **Longitude** e **Latitude** das coordenadas do mapa.
• Geometria : Selecione uma coluna GEOMETRIA ou GEOGRAFIA para ser usada como a localização do ponto em vez de colunas separadas de latitude e longitude. Consulte Dados geográficos personalizados.

Cor

Para dados não agrupados, clique na amostra de cor para alterar as cores dos pontos exibidas no mapa. Para aplicar uma estratégia de agrupamento, clique Ícone de adição (+) na seção Cor do editor de visualização. Você pode ajustar as cores atribuídas automaticamente clicando na amostra de cor ao lado de cada rótulo de grupo no editor.

Tamanho

Clique Clique no ícone de adição (+) na seção Tamanho para escolher um campo que reflita a quantidade, permitindo exibir pontos de tamanhos variados com base no valor dos dados.

Dados geográficos personalizados

É possível renderizar mapas diretamente de uma coluna GEOMETRY ou GEOGRAPHY em qualquer dataset. Utilize isso para visualizar formas personalizadas, como territórios de ventas, distritos escolares e áreas de abrangência de lojas, ou para graficar pontos sem dividir coordenadas em colunas separadas de latitude e longitude.

Cada linha é desenhada independentemente, 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, utilize uma medida de geometria em uma view de métrica. Consulte Limitações e visualizações de métricas locais.

Defina uma view de métricas com uma medida de geometria

No seu view de métricas YAML, defina a coluna de geometria ou geografia como uma medida usando uma das agregações suportadas: ST_UNION_AGG, ST_ENVELOPE_AGG, FIRST ou LAST. Utilize dimensões para as colunas não-geométricas que se deseja agrupar.

A seguinte view de métricas 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.

YAML

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 seus dados geográficos estiverem armazenados como uma string serializada ou um valor binário, converta-os para GEOMETRY ou GEOGRAPHY na expressão de medida.

Criar um mapa coroplético

Mapas coropléticos oferecem suporte a Polygon e MultiPolygon formas.

1. Adicionar a view de métricas como um dataset.
2. Defina o tipo de visualização como Mapa coroplético .
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

Mapas de pontos suportam formas Point e MultiPoint. Use uma medida de geometria com valor Point, como FIRST(location) ou ST_UNION_AGG(location).

1. Adicionar a view de métricas como um dataset.
2. Defina o tipo de visualização como Mapa de pontos .
3. Em Coordenadas , selecione Geometria e selecione sua medida de geometria.
4. (Opcional) Em **Tamanho**, selecione uma medida numérica para variar os tamanhos de ponto.

Limitações

• GROUP BY não é suportado em GEOMETRY ou GEOGRAPHY colunas. Para combinar várias linhas em uma única forma por grupo, agrupe a geometria como uma medida de view de métrica usando ST_UNION_AGG, ST_ENVELOPE_AGG, FIRST ou LAST. Caso contrário, cada linha é renderizada de forma independente e as formas podem se sobrepor.
• O renderizador de mapa usa WGS84 (SRID 4326). GEOMETRY colunas em outros SRIDs são reprojetadas automaticamente; GEOGRAPHY colunas já devem ser SRID 4326. Use ST_Transform em sua expressão de medida para reprojetar, se necessário.
• GEOMETRY Colunas com SRID 0 (sistema de coordenadas desconhecido) não são renderizadas.
• GeometryCollection Valores e colunas que misturam múltiplos tipos de forma não são suportados.
• Codificações de rótulo não são compatíveis em mapas que usam uma coluna de geometria ou geografia.