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 : les localités géographiques, telles que les pays ou les états, sont colorées selon les valeurs agrégées de chaque colonne clé. La query doit renvoyer des emplacements géographiques par nom ou en tant que colonne GEOMETRY ou GEOGRAPHY. Pour un exemple, voir l'exemple de carte choroplèthe.
- Carte de points : un marqueur est placé à un ensemble de coordonnées sur la carte. Le résultat de la query doit retourner des paires de latitude et de longitude ou une colonne GEOMETRY ou GEOGRAPHY. Pour un exemple, consultez l'exemple de marqueur.
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.
Exemple
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 l'icône
plus. Sous Valeurs , cliquez sur Sélectionner un pays et sélectionnez États-Unis .
- Dans la section Region , sous State/Province , cliquez sur l'icône plus
. Sous Fields , sélectionnez
state. - Sous Couleur , cliquez sur l'icône plus
, 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 d'emplacement dans vos données. Choisissez le format qui correspond à vos données :
- Administratif : Pays , État/Province , Comté/Ville , Ville/Commune ou Ville/Village
- Postal : Codes ZIP ou postaux.
- CSA / CSAB : désignations de zones statistiques du Bureau du Census des États-Unis. Les CSA (zones statistiques combinées) regroupent des zones métropolitaines et micropolitaines adjacentes ayant des liens économiques. CBSA (Core Based Statistical Areas) couvre les zones métropolitaines et micropolitaines individuelles.
- Législatif : circonscriptions législatives américaines, y compris les circonscriptions du Congrès et les circonscriptions sénatoriales des États.
- NUTs : Nomenclature des unités territoriales statistiques de l'UE. Prend en charge trois niveaux : NUTS 1 (grandes régions socio-économiques), NUTS 2 (régions de base pour l'application des politiques régionales) et NUTS 3 (petites régions pour des diagnostics spécifiques).
- Géométrie personnalisée : sélectionnez une colonne GEOMETRY ou GEOGRAPHY pour afficher les limites de région directement à partir de vos données. Voir Données géographiques personnalisées.
Si une valeur de votre colonne de localisation ne correspond pas au format sélectionné, aucune donnée n’est affichée pour cette région. Download les tables de correspondance suivantes pour vérifier les noms et abréviations pris en charge :
- noms-de-pays.csv
- state-province-names.csv
- county-district-names.csv
- town-names.csv
- noms-ville-village.csv
- senate-names.csv
- congressional-district-codes.csv
- zipcode-codes.csv
- us-csa-codes.csv
- us-cbsa-codes.csv
- eu-nuts-1-codes.csv
- eu-nuts-2-codes.csv
- eu-nuts-3-codes.csv
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.
Couleurs
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 par un champ numérique, cliquez sur l'icône plus 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 toute la plage de valeurs. Pour personnaliser les couleurs, le dégradé et les étiquettes, cliquez sur l’échantillon de couleur.
Options de carte ponctuelle
Cette section décrit les options pour les graphiques de carte de points.
Exemple
Dans l’onglet Data tab , cliquez sur + Ajouter un dataset SQL , collez la query suivante, puis exécutez-la :
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 l'icône
plus et sélectionnez
longitude. - Sous Latitude , cliquez sur l’icône Plus
et sélectionnez
latitude.
- Sous Longitude , cliquez sur l'icône
-
Sous Taille , cliquez sur l'icône
plus 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 groupées, vous pouvez cliquer sur l'échantillon de couleur afin de modifier les couleurs de point affichées sur la carte. Pour appliquer une stratégie de regroupement, cliquez sur l’icône plus dans la section Couleur de l’éditeur de visualisation. Vous pouvez ajuster les couleurs attribuées automatiquement en cliquant sur l’échantillon de couleur à côté de chaque libellé de groupe dans l’éditeur.
Taille
Cliquez sur l'icône plus dans la section Taille pour choisir un champ qui reflète la quantité, ce qui 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.
Chaque ligne est dessinée 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 géométrique 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 Taille , sélectionnez une mesure numérique pour faire varier les tailles de points.
Limitations
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 cartographique utilise le WGS84 (
SRID 4326).GEOMETRYcolonnes dans d'autres SRID sont reprojetées automatiquement ;GEOGRAPHYcolonnes doivent 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.