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 : colore localidades geográficas, como países ou estados, de acordo com os valores agregados de cada coluna key. A query deve retornar localizações geográficas por nome (consulte Tabelas de pesquisa de região para nomes suportados) ou como uma coluna GEOMETRY ou GEOGRAPHY. Para ver um exemplo, consulte Mapa coroplético.
• Mapa de pontos : coloca um marcador em um conjunto de coordenadas no mapa. O resultado da query deve retornar pares de latitude e longitude ou uma coluna GEOMETRY ou GEOGRAPHY. Para um exemplo, consulte Mapa de pontos.

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.

Configurar um mapa coroplético

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 em . Em Valores , clique em Selecione um país e selecione United States .
3. Na seção Região , em Estado/província , clique em . Em Campos , selecione state.
4. Em Cor , clique em , selecione total_sales e defina a transformação como SUM .

Região

A configuração Region informa ao mapa como interpretar os valores de localização em seus dados. Escolha o formato que corresponde aos seus dados. O Databricks oferece suporte a limites administrativos, códigos postais, áreas estatísticas do Census dos EUA (CSA e CBSA), distritos legislativos dos EUA e regiões NUTS da UE. Para os níveis disponíveis em cada formato, juntamente com os nomes, abreviações ou códigos aceitos, consulte Tabelas de pesquisa de região.

Se um valor na sua coluna de localização não corresponder ao formato selecionado, nenhum dado será exibido para essa região.

Alternativamente, selecione Geometria personalizada para renderizar limites de região diretamente de uma coluna GEOMETRY ou GEOGRAPHY em seus dados. Consulte Dados geográficos personalizados.

Cor

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 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 em toda a faixa de valores. Para personalizar as cores, o gradiente e os rótulos, clique na amostra de cor.

Tabelas de pesquisa de região

Encontre a seção que corresponde à sua configuração de Região e faça o download da sua tabela de pesquisa para verificar quais nomes, abreviações ou códigos são suportados.

Administrativo

Nível	Tabela de pesquisa
País	nomes-de-países.csv
Estado/Província	nomes-de-estados-províncias.csv
Condado/Cidade	nomes-distritos-condado.csv
Cidade/Município	nomes-das-cidades.csv
Cidade/Vila	nomes-cidades-vilas.csv

Nível	Tabela de pesquisa
País	nomes-de-países.csv
Estado/Província	nomes-de-estados-províncias.csv
Condado/Cidade	nomes-distritos-condado.csv
Cidade/Município	nomes-das-cidades.csv
Cidade/Vila	nomes-cidades-vilas.csv

nota

Para limites admin-0 (país), você pode usar nomes em inglês da coluna name_en diretamente como o identificador na sua query. Para outros níveis de região, use a coluna name_en para procurar valores suportados, mas use uma das outras colunas como o identificador na sua query.

Postal

CEPs ou códigos postais usam zipcode-codes.csv.

CSA / CBSA

A CSA (Combined Statistical Areas) agrupa áreas metropolitanas e micropolitanas adjacentes com vínculos econômicos. A CBSA (Core Based Statistical Areas) abrange áreas metropolitanas e micropolitanas individuais.

Nível	Tabela de pesquisa
Áreas Estatísticas Combinadas	us-csa-codes.csv
Áreas Estatísticas Baseadas no Núcleo	us-cbsa-codes.csv

Nível	Tabela de pesquisa
Áreas Estatísticas Combinadas	us-csa-codes.csv
Áreas Estatísticas Baseadas no Núcleo	us-cbsa-codes.csv

Legislativo

Nível	Tabela de pesquisa
Distritos do senado estadual	nomes-do-senado.csv
Distritos congressionais	códigos-distritais-congressuais.csv

Nível	Tabela de pesquisa
Distritos do senado estadual	nomes-do-senado.csv
Distritos congressionais	códigos-distritais-congressuais.csv

NUTS

NUTS é a Nomenclatura das Unidades Territoriais para Fins Estatísticos da UE, com três níveis: NUTS 1 (grandes regiões socioeconômicas), NUTS 2 (regiões básicas para política regional) e NUTS 3 (pequenas regiões para diagnósticos específicos).

Nível	Tabela de pesquisa
NUTS 1	eu-nuts-1-codes.csv
NUTS 2	eu-nuts-2-codes.csv
NUTS 3	eu-nuts-3-codes.csv

Nível	Tabela de pesquisa
NUTS 1	eu-nuts-1-codes.csv
NUTS 2	eu-nuts-2-codes.csv
NUTS 3	eu-nuts-3-codes.csv

Opções de mapa de pontos

Um mapa de pontos coloca um marcador em um conjunto de coordenadas para cada linha em seus dados.

Configure um mapa de pontos

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

datasetde amostra

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 em e selecione longitude.
   2. Em Latitude , clique em e selecione latitude.

2. Em Tamanho , clique em 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 exibidos no mapa. Para aplicar uma estratégia de agrupamento, clique em 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 em na seção Tamanho para escolher um campo que reflita a quantidade. Isso permite 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.

O mapa desenha cada linha 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 view de métrica. Consulte Limitações e Views 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 dos pontos.

Limitações

Dados geográficos personalizados têm as seguintes 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). O Databricks reprojeta colunas GEOMETRY em outros SRIDs automaticamente; colunas GEOGRAPHY já devem estar em SRID 4326. Use ST_Transform na 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.