Visualizações de mapa

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

  • Coropleth: Colora localidades geográficas, como países ou estados, de acordo com os valores agregados de cada coluna chave. A consulta deve devolver as localizações geográficas pelo nome (ver tabelas de consulta por Região para nomes suportados) ou como uma coluna GEOMETRY ou GEOGRAPHY . Para um exemplo, veja o mapa Choropleth.
  • Mapa de pontos: Coloca um marcador num conjunto de coordenadas no mapa. O resultado da consulta deve devolver pares de latitude e longitude ou uma coluna GEOMETRY ou GEOGRAPHY . Para um exemplo, veja mapa de pontos.
  • Mapa de caminho: Desenha uma linha para cada linha a partir de uma coluna de GEOMETRIA ou GEOGRAFIA . Usa-o para rotas, linhas de transporte, rios ou fronteiras desenhadas como linhas. Para um exemplo, veja Mapa de caminhos.

Também pode renderizar formas a partir de uma coluna de GEOMETRIA ou GEOGRAFIA em vez de depender de limites administrativos pré-definidos ou colunas separadas de latitude e longitude. Ver Dados geográficos personalizados.

Opções de mapa coroplético

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

Configurar um mapa coropleto

No separador 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. Define o tipo de visualização para o mapa Coropleth.
  2. Na secção Região , em País, clica no ícone Plus.. Em Valores, clique em Selecione um país e selecione Estados Unidos.
  3. Na secção Região , em Estado/Província, clique no ícone Plus.. Em Campos, selecione state.
  4. Em Cor, clique no ícone Plus., selecione total_sales, e defina a transformação para SUM.

Exemplo de mapa Coropleth mostrando vendas totais por estado dos EUA.

Region

A definição Região indica ao mapa como interpretar os valores de localização nos seus dados. Escolha o formato que corresponde aos seus dados. O Databricks suporta limites administrativos, códigos postais, áreas estatísticas do Censo 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, abreviaturas ou códigos que aceitam, consulte tabelas de consulta por região.

Se um valor na sua coluna de localização não corresponder ao formato selecionado, não são apresentados dados para essa região.

Alternativamente, selecione Geometria Personalizada para renderizar os limites das regiões diretamente a partir de uma coluna GEOMETRY ou GEOGRAPHY nos seus dados. Ver Dados geográficos personalizados.

Cor

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

A seção de configuração de cores no editor de visualização mostra a cor selecionada e um sinal de adição com mais opções.

Para colorir regiões por um campo numérico, clique no ícone Plus. na secção Cor e selecione um campo. Pode aplicar uma transformação como SUM ou MEDIAN. O mapa aplica um gradiente de cor ao longo do intervalo de valores. Para personalizar as cores, gradiente e etiquetas, clique na amostra de cor.

Tabelas de consulta por regiões

Encontre a secção que corresponda à sua configuração de Região e descarregue a sua tabela de consulta para verificar quais nomes, abreviaturas ou códigos são suportados.

Administrativo

Nível Tabela de consulta
País country-names.csv
State/Province state-province-names.csv
Condado/Cidade county-district-names.csv
Vila/Freguesia town-names.csv
Cidade/Vila city-village-names.csv

Observação

Para os limites admin-0 (país), pode usar nomes ingleses diretamente da name_en coluna como identificador na sua consulta. Para outros níveis de região, usa a name_en coluna para procurar valores suportados, mas usa uma das outras colunas como identificador na tua consulta.

Correios

Os códigos postais ou postais usamzipcode-codes.csv.

CSA / CBSA

CSA (Áreas Estatísticas Combinadas) agrupa áreas metropolitanas e micropolitanas adjacentes com ligações económicas. A CBSA (Core Based Statistical Areas) abrange áreas metropolitanas e micropolitanas individuais.

Nível Tabela de consulta
Áreas Estatísticas Combinadas us-csa-codes.csv
Áreas Estatísticas Centrais us-cbsa-codes.csv

Legislativo

Nível Tabela de consulta
Distritos do senado estadual senate-names.csv
Distritos congressionais congressional-district-codes.csv

FRUTOS SECOS

A NUTS é a Nomenclatura da UE das Unidades Territoriais para Estatística, com três níveis: NUTS 1 (principais 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 consulta
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 num conjunto de coordenadas para cada linha dos seus dados.

Configurar um mapa de pontos

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

Conjunto de dados de exemplo
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 Plus. e selecione longitude.
    2. Em Latitude, clique no ícone Plus. e selecione latitude.
  2. Em Tamanho, clique no ícone Plus. e selecione population.

Exemplo de mapa pontual que mostra cidades dos EUA dimensionadas por população.

Coordenadas

Use o editor de visualização 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 usar como localização do ponto em vez de colunas separadas de latitude e longitude. Ver Dados geográficos personalizados.

Cor

Para dados não agrupados, clique na amostra de cores para alterar as cores de ponto mostradas no mapa. Para aplicar uma estratégia de agrupamento, clique no ícone Mais na secçã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.

Dimensão

Clique no ícone Mais na secção Tamanho para escolher um campo que reflita a quantidade. Isto permite-lhe mostrar 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 dos teus dados a partir de uma coluna de geometria.

Configurar um mapa de caminho

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

Conjunto de dados de exemplo
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 para Path map.
  2. Em Caminho, ao lado de Geometria, clique no ícone Plus. e selecione route.
  3. Em Cor, clique no ícone Mais. e selecione line_name.
  4. Em Padrão de linha, clique no ícone Plus. e selecione line_type.

Exemplo de mapa de percurso mostrando linhas da TTC de Toronto coloridas por linha e padronizadas por modo.

Geometria

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

Cor

Para dados não agrupados, clique na amostra de cor para alterar a cor da linha mostrada no mapa. Para colorir linhas junto a um campo, clique no ícone Mais na secção Colorir e selecione um campo. Você pode ajustar as cores atribuídas automaticamente clicando na amostra de cores ao lado de cada rótulo de grupo no editor.

Dimensão

Clique no ícone Mais na secção Tamanho para escolher um campo numérico que varie a espessura da linha com base no valor dos dados.

Padrão das linhas

Clique no ícone Plus. na secção do padrão de linhas para escolher um campo categórico que varie o estilo de traço de cada linha.

Dados geográficos personalizados

Pode renderizar mapas diretamente a partir de uma coluna de GEOGRAFIA ou GEOMETRIA em qualquer conjunto de dados. Use-o para visualizar formas personalizadas como territórios de vendas, distritos escolares e áreas de captação de lojas, ou para representar pontos sem dividir coordenadas em colunas separadas de latitude e longitude.

O mapa desenha cada linha de forma independente, por isso formas ou pontos podem sobrepor-se se os seus dados tiverem várias linhas por região. Para combinar linhas numa única forma por região, use uma medida de geometria numa vista métrica. Veja Limitações e Vistas métricas locais.

Defina uma vista métrica com uma medida geométrica

Na sua vista métrica YAML, defina a coluna de geometria ou geografia como medida usando uma das agregações suportadas: ST_UNION_AGG, ST_ENVELOPE_AGG, FIRST, ou LAST. Use dimensões para as colunas não geométricas pelas quais quer agrupar.

A seguinte vista métrica local define region como uma dimensão, total_sales como uma medida numérica, e é usada ST_UNION_AGG para combinar limites por linha numa ú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 seus dados geográficos estiverem armazenados como uma string serializada ou valor binário, conjure-os para GEOMETRY ou GEOGRAPHY na expressão de medida.

Criar um mapa coropleto

Choropleth mapeia suporte Polygon e MultiPolygon formas.

  1. Adicione a vista métrica como um conjunto de dados.
  2. Define o tipo de visualização para o mapa Coropleth.
  3. Em Região, selecione Geometria Personalizada e selecione a 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 de suporte Point e MultiPoint formas. Use uma Pointmedida geométrica com valores em , como FIRST(location) ou ST_UNION_AGG(location).

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

Criar um mapa de caminho

Mapas de caminho suporte LineString e MultiLineString formas. Use uma LineStringmedida geométrica com valores em , ou combine segmentos por linha num único caminho por grupo com ST_UNION_AGG.

  1. Adicione a vista métrica como um conjunto de dados.
  2. Defina o tipo de visualização para Path map.
  3. Em Caminho, seleciona a tua medida de geometria.
  4. Opcional: Em Cor, selecione um campo para colorir as linhas.

Limitações

Os dados geográficos personalizados têm as seguintes limitações:

  • GROUP BY Não é suportado nas GEOMETRY colunas nem GEOGRAPHY ON. Para combinar várias linhas numa única forma por grupo, agregue a geometria como uma medida métrica de vista usando ST_UNION_AGG, ST_ENVELOPE_AGG, FIRST, ou LAST. Caso contrário, cada linha é renderizada independentemente e as formas podem sobrepor-se.
  • O renderizador de mapas utiliza o WGS84 (SRID 4326). O Databricks reprojeta GEOMETRY automaticamente colunas noutros SRIDs; GEOGRAPHY as colunas já devem ser SRID 4326. Usa ST_Transform na expressão da tua 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 vários tipos de forma não são suportados.
  • Codificações de etiquetas não são suportadas em mapas que usem uma coluna de geometria ou geografia.