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.
- Carte de chemin : dessine une ligne pour chaque ligne à partir d'une colonne GEOMETRY ou GEOGRAPHY. Utilisez-la pour les itinéraires, les lignes de transport en commun, les rivières ou les frontières tracées sous forme de lignes. Pour un exemple, voir Carte de chemin.
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
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 :
- Définissez le type de visualisation sur **Carte choroplèthe**.
- Dans la section Région , sous Pays , cliquez sur
. Sous Valeurs , cliquez sur Sélectionner un pays et sélectionnez États-Unis .
- Dans la section Région , sous État/Province , cliquez sur
. Sous Champs , sélectionnez
state. - Sous Color , cliquez sur
, sélectionnez
total_saleset 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 | |
État/Province | |
Comté/Ville | |
Ville/commune | |
Ville/Village |
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 | |
Zones statistiques basées sur le noyau |
Législatif
Niveau | Table de recherche |
|---|---|
Districts du sénat d'État | |
Districts congressionnels |
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 | |
NUTS 2 | |
NUTS 3 |
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
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 :
-
Sous Coordinates , sélectionnez Longitude/Latitude .
- Sous Longitude , cliquez sur
et sélectionnez
longitude. - Sous Latitude , cliquez sur
et sélectionnez
latitude.
- Sous Longitude , cliquez sur
-
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.
Options de mappage de chemin
Une carte de chemin trace une ligne pour chaque ligne de vos données à partir d’une colonne de géométrie.
Configurer un mappage de chemin d’accès
Dans l’onglet Data tab , cliquez sur + Ajouter un dataset SQL , collez la query suivante, puis exécutez-la :
Exemple de dataset
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);
Dans l'éditeur de visualisation, configurez les éléments suivants :
- Définissez le type de visualisation sur Path map .
- Sous Path , à côté de Geometry , cliquez sur
et sélectionnez
route. - Sous Couleur , cliquez sur
et sélectionnez
line_name. - Sous Line pattern , cliquez sur
et sélectionnez
line_type.

Géométrie
Sélectionnez une colonne GEOMETRY ou GEOGRAPHY qui contient la géométrie de ligne à dessiner. Chaque ligne est dessinée comme une ligne. Contrairement à une carte de points, une carte de chemin n’accepte pas de colonnes de latitude et de longitude distinctes. Voir Données géographiques personnalisées.
Couleur
Pour les données non groupées, cliquez sur l’échantillon de couleur pour modifier la couleur de ligne affichée sur la carte. Pour colorer les lignes par champ, cliquez sur dans la section Color et sélectionnez un champ. 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 numérique qui fait varier l'épaisseur de la ligne en fonction de la valeur des données.
Modèle de ligne
Cliquez sur dans la section Modèle de ligne pour choisir un champ catégoriel qui fait varier le style de tiret de chaque ligne.
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 :
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.
- Ajouter la vue métrique sous forme de dataset.
- Définissez le type de visualisation sur **Carte choroplèthe**.
- Sous Région , sélectionnez Géométrie personnalisée et sélectionnez votre mesure de géométrie (par exemple,
region_shape). - 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).
- Ajouter la vue métrique sous forme de dataset.
- Définissez le type de visualisation sur Carte des points .
- Sous **Coordonnées**, sélectionnez **Géométrie** et choisissez votre mesure géométrique.
- Facultatif : sous Size , sélectionnez une mesure numérique pour faire varier les tailles de point.
Créer une carte de chemin
Les mappages de chemin prennent en charge les formes LineString et MultiLineString. Utilisez une mesure de géométrie à LineStringvaleurs, ou combinez les segments par ligne en un chemin unique par groupe avec ST_UNION_AGG.
- Ajouter la vue métrique sous forme de dataset.
- Définissez le type de visualisation sur Path map .
- Sous Chemin , sélectionnez votre mesure de géométrie.
- Facultatif : sous Couleur , sélectionnez un champ pour colorer les lignes.
Limitations
Les données géographiques personnalisées présentent les limitations suivantes :
GROUP BYn'est pas pris en charge surGEOMETRYouGEOGRAPHYcolonnes. 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 utilisantST_UNION_AGG,ST_ENVELOPE_AGG,FIRST, ouLAST. 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 colonnesGEOMETRYdans d’autres SRID ; les colonnesGEOGRAPHYdoivent déjà êtreSRID 4326. Utilisez ST_Transform dans votre expression de mesure pour reprojeter si nécessaire. GEOMETRYles colonnes avecSRID 0(système de coordonnées inconnu) ne sont pas rendues.GeometryCollectionles 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.