Vous consultez la documentation de Looker 22.16. Pour accéder à la documentation la plus récente, cliquez ici.

calque_carte

Utilisation

Hiérarchie

Fichier de modèle

map_layer

Valeur par défaut

Aucun

Acceptation

Identifiant du calque de carte et sous-paramètres définissant les propriétés du calque de carte.

Définition

Le paramètre map_layer vous permet de définir un calque de carte personnalisé qui peut ensuite être utilisé pour tracer des données régionales, telles que des comtés ou des codes postaux, dans Looker, et créer des graphiques de carte.

Lorsqu'un calque de carte existe, la visualisation de carte interactive est généralement choisie comme visualisation de carte par défaut. La seule exception concerne la carte des États-Unis, où Looker utilise par défaut le graphique des régions statiques de la carte, car il utilise des encarts pour l'Alaska et Hawaï.

Les calques de carte peuvent accepter les fichiers TopoJSON ou GeoJSON. Cependant, les anciens tableaux de bord ne sont pas compatibles avec les cartes qui utilisent des fichiers GeoJSON.

Pour en savoir plus sur la création d'un fichier de calque de carte personnalisé, consultez l'article Créer des régions de carte personnalisées dans le centre d'aide.

Looker vous recommande de limiter la taille des fichiers de calques personnalisés à 5 Mo afin d'éviter de surcharger l'onglet du navigateur de l'utilisateur.

Calques de carte intégrés

Looker inclut plusieurs calques de carte intégrés. Avant de créer vos propres calques, vérifiez si vous pouvez utiliser l'un des calques intégrés:

Les calques de carte intégrés countries et us_states utilisent les majuscules de façon appropriée pour les noms des pays et des États. Les données sont tracées en fonction de la casse dans le calque de la carte. Pour que vous puissiez utiliser ces calques intégrés, vos données doivent donc également utiliser les majuscules de façon appropriée. Par exemple, si votre ensemble de données utilise les minuscules "nouveau delhi", les données ne seront pas correctement tracées sur les calques de carte intégrés, qui utilisent "New Delhi".

countries : accepte les noms de pays complets, les codes de pays à trois lettres ISO 3166-1 alpha-3 ou les codes de pays à deux lettres ISO 3166-1 alpha-2. Notez que vous ne devez utiliser qu'une seule de ces trois options dans votre ensemble de données. Vous ne pouvez pas combiner ces options.

Si vos données utilisent la norme alpha-2 ISO 3166-1, incluez le paramètre map_layer_name dans la définition de la dimension "Pays" pour vous assurer que Looker reconnaît vos données en tant que codes de pays et ne les interprète pas de manière incorrecte comme des codes d'état. Exemple :

  dimension: country {
      type: string
      map_layer_name: countries
      sql: ${TABLE}.country ;;
  }

uk_postcode_areas : accepte les zones postales britanniques (par exemple, L pour Liverpool, RH pour Redhill ou EH pour Édimbourg).
us_states : accepte les noms d'État complets et les abréviations d'États à deux lettres.
us_counties_fips : fonctionne sur les champs de type chaîne qui sont des codes de comté FIPS à cinq caractères pour un comté des États-Unis. Ce calque ne fonctionne que sur la carte interactive.
us_zipcode_tabulation_areas : fonctionne sur les champs de type chaîne qui correspondent à des codes postaux américains à cinq caractères. Les dimensions de type: zipcode utilisent automatiquement le calque us_zipcode_tabulation_areas.

Les régions des codes postaux sont basées sur les zones de tabulation des codes postaux de 2010. Ce calque de carte n'inclut donc pas de nombreux codes postaux, comme ceux affectés aux boîtes postales, qui ne correspondent pas directement à des régions.

Spécifier un calque de carte

L'emplacement de la carte peut être spécifié à l'aide du nom d'un fichier ou d'une URL.

Lorsque vous utilisez un fichier GeoJSON, il vous suffit de référencer le sous-paramètre file. La syntaxe générale pour ajouter un calque de carte GeoJSON est la suivante:

map_layer: identifier {
  file: "/file_path/file_name.geojson"
}

La syntaxe générale pour ajouter un calque de carte TopoJSON est la suivante:

map_layer: identifier {
  extents_json_url: "string"
  feature_key: "string"
  file: "/file_path/file_name.json" # or use the url subparameter
  format: topojson | vector_tile_region
  label: "string"
  max_zoom_level: number
  min_zoom_level: number
  projection: airy  # or one of many other choices
  property_key: "string"
  property_label_key: "string"
  url: "string" # or use the file subparameter
}

Où :

Parameter	Type	Description
`identifier`	String	Nom de la carte tel que vous vous y référerez dans LookML.
`file`	String	Emplacement de la carte, spécifié par le nom d'un fichier JSON de votre projet LookML. Le fichier doit être au format TopoJSON ou GeoJSON et comporter l'extension de fichier `.json`, `.geojson` ou `.topojson`. Vous devez utiliser le chemin d'accès complet du fichier JSON, par exemple `"/maps/countryobjects.json"` pour un fichier situé dans le répertoire `/maps/`. Si le fichier JSON se trouve dans le répertoire racine et non dans un dossier, vous pouvez indiquer le répertoire racine avec une seule barre oblique, comme ceci : `"/countryobjects.json"` Si votre projet n'est pas activé pour les dossiers, Looker affiche les fichiers JSON dans la section Data (Données) de la liste de fichiers de l'IDE LookML. Consultez la section Exemples plus loin sur cette page pour connaître le LookML pour chacun de ces scénarios.
`extents_json_url`	String	URL d'un fichier JSON qui définit les étendues géographiques de chaque région disponible dans le calque de la carte. Ces données permettent de centrer automatiquement la carte sur les données disponibles à des fins de visualisation. Le fichier JSON doit être un objet JSON où les clés correspondent à la valeur de mappage de l'élément géographique (telle que spécifiée par `property_key`), et les valeurs sont des tableaux de quatre nombres représentant la longitude ouest, la latitude sud, la longitude est et la latitude nord de la région. L'objet doit inclure une clé pour chaque valeur possible de `property_key`. Par exemple, `extents_json_url: "https://mycompany.com/mapserver/json-extent.js"`. Si vous utilisez ce paramètre, vous devez spécifier l'emplacement sur la carte à l'aide du paramètre `url`.
`feature_key`	String	Nom de l'objet TopoJSON auquel le calque de carte fait référence. S'il n'est pas spécifié, le premier objet est utilisé.
`format`	Mot clé `topojson` ou `vector_tile_region`	Format de données des informations sur la région. Les utilisateurs utilisent généralement `topojson`.
`label`	String	Affichée dans l'UI de configuration du graphique.
`max_zoom_level`	Number	Niveau de zoom maximal pour le zoom dans le calque de la carte, pour les visualisations compatibles avec le zoom.
`min_zoom_level`	Number	Niveau de zoom minimal pour le zoom dans le calque de la carte, pour les visualisations compatibles avec le zoom.
`projection`	Mot clé	Projection géographique préférée du calque lorsqu'elle est affichée dans une visualisation prenant en charge plusieurs projections géographiques. L'éditeur LookML répertorie les nombreuses projections disponibles lorsque vous ajoutez un paramètre de projection.
`property_key`	String	Propriété des données TopoJSON à comparer. TopoJSON accepte les métadonnées arbitraires pour chaque région. Par défaut, la première propriété correspondante est utilisée. Si vous souhaitez représenter une propriété de métadonnées spécifique, indiquez-la ici.
`property_label_key`	String	Propriété des données TopoJSON à utiliser pour étiqueter la région. Cette fonctionnalité est utile lorsque la valeur de mappage (définie par `property_key`) n'est pas très lisible.
`url`	String	Emplacement de la carte, spécifié par une URL contenant votre fichier de carte.

Examples

Dans la mesure du possible, ajoutez votre fichier de carte à votre projet, puis utilisez le paramètre file pour pointer vers le fichier de carte.

Vous devez utiliser le chemin d'accès complet du fichier JSON. Si votre projet n'est pas activé pour les dossiers, Looker affiche les fichiers JSON dans la section Données de la liste de fichiers de l'IDE LookML.

Par exemple, si votre projet est activé pour les dossiers et que vous disposez d'une carte personnalisée de quartiers appelée my_neighborhoods.json dans un répertoire nommé maps, vous devez utiliser le chemin d'accès complet comme suit:

map_layer: neighborhoods {
  file: "/maps/my_neighborhoods.json"
}

Si votre projet n'utilise pas de dossiers, les fichiers de carte importés s'affichent dans la section Données du projet. Dans ce cas, il vous suffit de fournir le nom du fichier my_neighborhoods.json:

map_layer: neighborhoods {
  file: "my_neighborhoods.json"
}

Vous pouvez également spécifier qu'une carte neighborhoods personnalisée est hébergée ailleurs, par exemple à https://wherever.com/my_neighborhoods.json:

map_layer: neighborhoods {
  url: "https://wherever.com/my_neighborhoods.json"
}

Une fois le calque de carte défini (en spécifiant un fichier ou en utilisant le paramètre url), vous pouvez spécifier que les valeurs d'une dimension doivent être associées à une région géographique sur votre carte personnalisée. Dans la dimension, utilisez le paramètre map_layer_name pour spécifier le nom que vous avez utilisé dans le paramètre map_layer.

dimension: neighborhood {
  type: string
  map_layer_name: neighborhoods    # this is your map layer
  sql: ${TABLE}.neighborhood_code
}

Lorsque vous interrogez cette dimension et ouvrez la section de visualisation, Looker affiche les données sous forme graphique à l'aide du fichier JSON neighborhoods, comme défini dans le paramètre map_layer de votre fichier de modèle.

Bon à savoir

Graphiques de cartes statiques (régions)

Pour définir Carte sur Auto dans les graphiques de cartes statiques (régions), il faut que map_layer soit spécifié dans le modèle LookML spécifiant un calque de carte. Sans cet ensemble de paramètres, les utilisateurs reçoivent un message d'erreur s'ils sélectionnent Auto, mais peuvent tout de même utiliser les cartes intégrées de Looker.

Fichiers GeoJSON

Comme les fichiers TopoJSON, les fichiers GeoJSON peuvent porter l'extension .geojson ou .json, mais doivent contenir des données géographiques au format GeoJSON. Lorsque vous utilisez un fichier GeoJSON, il vous suffit de référencer le sous-paramètre file.

Les anciens tableaux de bord ne sont pas compatibles avec les cartes qui utilisent des fichiers GeoJSON.