Visualisations cartographiques

Les visualisations cartographiques affichent les résultats sur une carte géographique. L'ensemble de résultats de la requête doit inclure les données géographiques appropriées :

• Choroplèthe : colore les localités géographiques, telles que les pays ou les États, en fonction des valeurs agrégées de chaque colonne clé. La query doit renvoyer des emplacements géographiques par nom (voir Tables de recherche de régions pour les noms pris en charge) ou sous forme de colonne GEOMETRY ou GEOGRAPHY. Pour un exemple, consultez Carte choroplèthe.
• Carte des points : place un marqueur à un ensemble de coordonnées sur la carte. Le résultat de la query doit renvoyer des paires de latitude et de longitude ou une colonne GEOMETRY ou GEOGRAPHY. Pour un exemple, voir Carte des points.

Vous pouvez également afficher des formes à partir d'une colonne GEOMETRY ou GEOGRAPHY, au lieu de vous fier aux limites administratives prédéfinies ou à des colonnes séparées de latitude et de longitude. Voir Données géographiques personnalisées.

Options choroplèthes

Une carte choroplèthe colore les régions géographiques — comme les pays, les états ou les comtés — en fonction d'une valeur numérique dans vos données.

Configurer une carte choroplèthe

Dans l’onglet Data tab , cliquez sur + Ajouter un dataset SQL , collez la query suivante, puis exécutez-la :

Exemple de dataset

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);

Dans l'éditeur de visualisation, configurez les éléments suivants :

1. Définissez le type de visualisation sur **Carte choroplèthe**.
2. Dans la section Région , sous Pays , cliquez sur . Sous Valeurs , cliquez sur Sélectionner un pays et sélectionnez États-Unis .
3. Dans la section Région , sous État/Province , cliquez sur . Sous Champs , sélectionnez state.
4. Sous Color , cliquez sur , sélectionnez total_sales et définissez la transformation sur SUM .

Région

Le paramètre Région indique à la carte comment interpréter les valeurs de localisation dans vos données. Choisissez le format qui correspond à vos données. Databricks prend en charge les limites administratives, les codes postaux, les zones statistiques du Census américain (CSA et CBSA), les districts législatifs américains et les régions NUTS de l'UE. Pour les niveaux disponibles sous chaque format, ainsi que les noms, abréviations ou codes qu’ils acceptent, consultez Region lookup tables.

Si une valeur de votre colonne d'emplacement ne correspond pas au format sélectionné, aucune donnée n'est affichée pour cette région.

Alternativement, sélectionnez Géométrie personnalisée pour rendre les limites de région directement à partir d'une colonne GEOMETRY ou GEOGRAPHY dans vos données. Voir Données géographiques personnalisées.

Couleur

Les couleurs sont renseignées automatiquement pour chaque région contenant des données. Cliquez sur l'échantillon de couleur pour choisir une couleur différente.

Pour colorer les régions selon un champ numérique, cliquez sur dans la section Couleur et sélectionnez un champ. Vous pouvez appliquer une transformation telle que SUM ou MEDIAN. La carte applique un dégradé de couleurs sur l'ensemble de la plage de valeurs. Pour personnaliser les couleurs, le dégradé et les libellés, cliquez sur l'échantillon de couleur.

Tables de recherche de région

Recherchez la section qui correspond à votre paramètre Region et download sa table de correspondance pour vérifier quels noms, abréviations ou codes sont pris en charge.

Administratif

Niveau	Table de recherche
Pays	noms-de-pays.csv
État/Province	state-province-names.csv
Comté/Ville	county-district-names.csv
Ville/commune	town-names.csv
Ville/Village	noms-ville-village.csv

Niveau	Table de recherche
Pays	noms-de-pays.csv
État/Province	state-province-names.csv
Comté/Ville	county-district-names.csv
Ville/commune	town-names.csv
Ville/Village	noms-ville-village.csv

remarque

Pour les limites administratives de niveau 0 (pays), vous pouvez utiliser les noms anglais de la colonne name_en directement comme identifiant dans votre query. Pour les autres niveaux de région, utilisez la colonne name_en pour rechercher les valeurs prises en charge, mais utilisez l'une des autres colonnes comme identifiant dans votre query.

Postal

Les codes postaux utilisent zipcode-codes.csv.

CSA / CBSA

Les CSA (Combined Statistical Areas) regroupent des zones métropolitaines et micropolitaines adjacentes ayant des liens économiques. Les CBSA (Core Based Statistical Areas) couvrent des zones métropolitaines et micropolitaines individuelles.

Niveau	Table de recherche
Zones statistiques combinées	us-csa-codes.csv
Zones statistiques basées sur le noyau	us-cbsa-codes.csv

Niveau	Table de recherche
Zones statistiques combinées	us-csa-codes.csv
Zones statistiques basées sur le noyau	us-cbsa-codes.csv

Législatif

Niveau	Table de recherche
Districts du sénat d'État	senate-names.csv
Districts congressionnels	congressional-district-codes.csv

Niveau	Table de recherche
Districts du sénat d'État	senate-names.csv
Districts congressionnels	congressional-district-codes.csv

NUTS

NUTS est la nomenclature des unités territoriales statistiques de l'UE, avec trois niveaux : NUTS 1 (grandes régions socio-économiques), NUTS 2 (régions de base pour la politique régionale) et NUTS 3 (petites régions pour des diagnostics spécifiques).

Niveau	Table de recherche
NUTS 1	eu-nuts-1-codes.csv
NUTS 2	eu-nuts-2-codes.csv
NUTS 3	eu-nuts-3-codes.csv

Niveau	Table de recherche
NUTS 1	eu-nuts-1-codes.csv
NUTS 2	eu-nuts-2-codes.csv
NUTS 3	eu-nuts-3-codes.csv

Options de carte ponctuelle

Une carte des points place un marqueur à un ensemble de coordonnées pour chaque ligne de vos données.

Configurer une carte des points

Dans l’onglet Data tab , cliquez sur + Ajouter un dataset SQL , collez la query suivante, puis exécutez-la :

Exemple de dataset

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);

Dans l'éditeur de visualisation, configurez les éléments suivants :

1. Sous Coordinates , sélectionnez Longitude/Latitude .

   1. Sous Longitude , cliquez sur et sélectionnez longitude.
   2. Sous Latitude , cliquez sur et sélectionnez latitude.

2. Sous Taille , cliquez sur et sélectionnez population.

Coordonnées

Utilisez l'éditeur de visualisation pour configurer les **Coordonnées** :

• Longitude/Latitude : choisissez la colonne qui contient les composants Longitude et Latitude des coordonnées cartographiques.
• Géométrie : sélectionnez une colonne GEOMETRY ou GEOGRAPHY à utiliser comme emplacement de point au lieu de colonnes de latitude et de longitude distinctes. Consultez les données géographiques personnalisées.

Couleur

Pour les données non regroupées, cliquez sur l’échantillon de couleur pour modifier les couleurs des points affichés sur la carte. Pour appliquer une stratégie de regroupement, cliquez sur dans la section Couleur de l’éditeur de visualisation. Vous pouvez ajuster les couleurs automatiquement attribuées en cliquant sur l’échantillon de couleur à côté de chaque libellé de groupe dans l’éditeur.

Taille

Cliquez sur dans la section Taille pour choisir un champ qui reflète la quantité. Cela vous permet d'afficher des points de tailles variables en fonction de la valeur des données.

Données géographiques personnalisées

Vous pouvez afficher des cartes directement à partir d'une colonne GEOMETRY ou GEOGRAPHY dans n'importe quel dataset. Utilisez ceci pour visualiser des formes personnalisées telles que les territoires de Ventes, les districts scolaires et les zones de chalandise des magasins, ou pour tracer des points sans diviser les coordonnées en colonnes de latitude et de longitude distinctes.

La carte dessine chaque ligne indépendamment, de sorte que les formes ou les points peuvent se chevaucher si vos données comportent plusieurs lignes par région. Pour combiner des lignes en une seule forme par région, utilisez une mesure de géométrie dans une vue métrique. Voir Limitations et Vues métriques locales.

Définir une vue Indicateur avec une mesure de géométrie

Dans le fichier YAML de votre vue métrique, définissez la colonne de géométrie ou de géographie comme mesure en utilisant l'une des agrégations prises en charge : ST_UNION_AGG, ST_ENVELOPE_AGG, FIRST ou LAST. Utilisez des dimensions pour les colonnes non-géométriques que vous souhaitez regrouper.

La vue métrique locale suivante définit region comme dimension, total_sales comme mesure numérique, et utilise ST_UNION_AGG pour combiner les limites par ligne en une seule forme par région :

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)

Si vos données géographiques sont stockées sous forme de chaîne sérialisée ou de valeur binaire, convertissez-la en GEOMETRY ou GEOGRAPHY dans l'expression de mesure.

Créez une carte choroplèthe

Les cartes choroplèthes prennent en charge les Polygon et les MultiPolygon formes.

1. Ajouter la vue métrique sous forme de dataset.
2. Définissez le type de visualisation sur **Carte choroplèthe**.
3. Sous Région , sélectionnez Géométrie personnalisée et sélectionnez votre mesure de géométrie (par exemple, region_shape).
4. Sous Couleur , sélectionnez une mesure numérique telle que total_sales.

Créer une carte de points

Les cartes de points prennent en charge les formes Point et MultiPoint. Utilisez une mesure géométrique à valeur Pointtelle que FIRST(location) ou ST_UNION_AGG(location).

1. Ajouter la vue métrique sous forme de dataset.
2. Définissez le type de visualisation sur Carte des points .
3. Sous **Coordonnées**, sélectionnez **Géométrie** et choisissez votre mesure géométrique.
4. Facultatif : sous Size , sélectionnez une mesure numérique pour faire varier les tailles de point.

Limitations

Les données géographiques personnalisées présentent les limitations suivantes :

• GROUP BY n'est pas pris en charge sur GEOMETRY ou GEOGRAPHY colonnes. Pour combiner plusieurs lignes en une seule forme par groupe, agréguez la géométrie en tant que mesure de vue métrique en utilisant ST_UNION_AGG, ST_ENVELOPE_AGG, FIRST, ou LAST. Autrement, chaque ligne est rendue indépendamment et les formes peuvent se chevaucher.
• Le moteur de rendu de carte utilise WGS84 (SRID 4326). Databricks reprojette automatiquement les colonnes GEOMETRY dans d’autres SRID ; les colonnes GEOGRAPHY doivent déjà être SRID 4326. Utilisez ST_Transform dans votre expression de mesure pour reprojeter si nécessaire.
• GEOMETRY les colonnes avec SRID 0 (système de coordonnées inconnu) ne sont pas rendues.
• GeometryCollection les valeurs et les colonnes qui mélangent plusieurs types de formes ne sont pas prises en charge.
• Les encodages d'étiquettes ne sont pas pris en charge sur les cartes qui utilisent une colonne de géométrie ou de géographie.