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.
• Mapa de caminho : desenha uma linha para cada linha a partir de uma coluna GEOMETRY ou GEOGRAPHY. Use-o para rotas, linhas de trânsito, rios ou fronteiras desenhadas como linhas. Para obter um exemplo, consulte Mapa de caminho.

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.

Opções de mapa de caminho

Um mapa de caminho desenha uma linha para cada linha em seus dados a partir de uma coluna de geometria.

Configurar um mapa de caminho

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

datasetde amostra

SQL

SELECT line_name, line_type, ST_GEOMFROMTEXT(wkt, 4326) AS route
FROM VALUES
  ('Line 1 Yonge-University', 'Subway',     'LINESTRING(-79.4103 43.7804, -79.4065 43.7442, -79.3985 43.7057, -79.3860 43.6709, -79.3826 43.6612, -79.3790 43.6524, -79.3807 43.6453, -79.3868 43.6509, -79.3884 43.6549, -79.3934 43.6672, -79.3998 43.6681, -79.4041 43.6674, -79.4160 43.6840, -79.4353 43.6987, -79.4473 43.7247, -79.4617 43.7497, -79.4936 43.7647, -79.5022 43.7740, -79.5273 43.7942)'),
  ('Line 2 Bloor-Danforth',  'Subway',     'LINESTRING(-79.5357 43.6375, -79.5115 43.6482, -79.4843 43.6497, -79.4595 43.6558, -79.4526 43.6570, -79.4263 43.6622, -79.4111 43.6659, -79.3998 43.6681, -79.3860 43.6709, -79.3585 43.6767, -79.3450 43.6801, -79.3126 43.6866, -79.3016 43.6890, -79.2886 43.6952, -79.2795 43.7113, -79.2635 43.7325)'),
  ('Line 4 Sheppard',        'Subway',     'LINESTRING(-79.4106 43.7615, -79.3866 43.7669, -79.3762 43.7691, -79.3661 43.7714, -79.3462 43.7757)'),
  ('Line 5 Eglinton',        'Light rail', 'LINESTRING(-79.4880 43.6835, -79.4770 43.6900, -79.4650 43.6930, -79.4540 43.6952, -79.4420 43.6975, -79.4353 43.6987, -79.4190 43.7015, -79.4090 43.7035, -79.3985 43.7057, -79.3830 43.7085, -79.3660 43.7112, -79.3470 43.7150, -79.3250 43.7180, -79.3050 43.7220, -79.2850 43.7270, -79.2635 43.7325)'),
  ('Line 6 Finch West',      'Light rail', 'LINESTRING(-79.4936 43.7647, -79.5170 43.7638, -79.5330 43.7628, -79.5500 43.7580, -79.5680 43.7500, -79.5850 43.7410, -79.6030 43.7285)')
AS lines(line_name, line_type, wkt);

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

1. Defina o tipo de visualização como Mapa de caminhos .
2. Em Caminho , ao lado de Geometria , clique em e selecione route.
3. Em Cor , clique em e selecione line_name.
4. Em Padrão de linha , clique em e selecione line_type.

Geometria

Selecione uma coluna GEOMETRY ou GEOGRAPHY que contenha a geometria de linha a ser desenhada. Cada linha é desenhada como uma linha. Ao contrário de um mapa de pontos, um mapa de caminhos não aceita colunas separadas de latitude e longitude. Consulte Dados geográficos personalizados.

Cor

Para dados não agrupados, clique na amostra de cor para alterar a cor da linha exibida no mapa. Para colorir linhas por um campo, clique em na seção Cor e selecione um campo. 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 numérico que varia a espessura da linha com base no valor dos dados.

Padrão de linha

Clique em na seção Padrão de linha para escolher um campo categórico que varia o estilo de traço de cada linha.

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.

Criar um mapa de caminho

Os mapas de caminho oferecem suporte às formas LineString e MultiLineString. Use uma medida de geometria com valor LineStringou combine segmentos por linha em um único caminho por grupo com ST_UNION_AGG.

1. Adicionar a view de métricas como um dataset.
2. Defina o tipo de visualização como Mapa de caminhos .
3. Em Caminho , selecione sua medida de geometria.
4. Opcional: Em Cor , selecione um campo para colorir as linhas.

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.