map_layer

Utilisation

map_layer: company_regions {
  feature_key: "ISO_A3"
  file: "/map_folder/regions.json"
  format: topojson
  label: "desired label for chart visualization"
  max_zoom_level: 12
  min_zoom_level: 2
  projection: airy
  property_key: "ISO_A3"
  property_label_key: "NAME"
}

Hiérarchie Fichier de modèle map_layer

Valeur par défaut Aucun Acceptation Identifiant de votre calque de carte, ainsi que des sous-paramètres définissant les propriétés de votre 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 le graphique Carte statique (région) par défaut, car il utilise des encarts pour l'Alaska et Hawaï.

Les calques de carte peuvent accepter les fichiers TopoJSON ou GeoJSON.

Pour en savoir plus sur la création d'un fichier de calque de carte personnalisé, consultez la page Bonnes pratiques pour créer des régions de carte personnalisées.

Looker vous recommande de ne pas dépasser 5 Mo pour les fichiers de calque de carte personnalisés 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 de carte, vérifiez si vous pouvez utiliser l'un des calques de carte intégrés :

Les calques de carte intégrés countries et us_states respectent la casse des noms de pays et d'États. Les données sont tracées sur le calque de carte en respectant la casse. Par conséquent, vos données doivent également respecter la casse pour pouvoir utiliser ces calques de carte intégrés. Par exemple, si votre ensemble de données utilise la casse inférieure pour "new delhi", les données ne seront pas tracées correctement sur les calques de carte intégrés, qui utilisent "New Delhi".

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

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

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

• uk_postcode_areas : accepte les zones de codes postaux au Royaume-Uni (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'État à deux lettres.

• us_counties_fips : fonctionne sur les champs de chaîne qui sont des codes de comté FIPS à cinq caractères pour un comté américain. Ce calque ne fonctionne que sur la carte interactive.

• us_zipcode_tabulation_areas : fonctionne sur les champs de chaîne qui sont des codes postaux américains à cinq caractères. Les dimensions de type: zipcode utilisent automatiquement le calque de carte us_zipcode_tabulation_areas.

  Les régions de codes postaux sont basées sur les zones de tabulation des codes postaux (ZCTA) de 2010. Par conséquent, ce calque de carte n'inclut pas de nombreux codes postaux, tels que ceux attribués aux boîtes postales, qui ne sont pas directement mappés aux 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, vous devez utiliser le sous-paramètre file ou url. Vous pouvez également utiliser property_key et property_label_key de manière facultative. Le sous-paramètre feature_key n'est pas compatible avec les fichiers GeoJSON. La syntaxe générale pour ajouter un calque de carte GeoJSON est la suivante :

map_layer: identifier {
  file: "/file_path/file_name.geojson" # or use the url subparameter
  url: "string" # or use the file subparameter
  property_key: "string"
  property_label_key: "string"
}

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ù :

Paramètre	Type	Description
identifier	Chaîne	Nom de la carte tel que vous y ferez référence dans LookML.
file	Chaîne	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 utiliser l'une des extensions suivantes : .json, .geojson ou .topojson. Vous devez utiliser le chemin d'accès complet au fichier JSON, par exemple "/maps/countryobjects.json" pour un fichier 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 les dossiers ne sont pas activés pour votre projet, Looker affiche les fichiers JSON dans la section Données de la liste de fichiers de l'IDE LookML. Consultez la section Exemples plus loin sur cette page pour obtenir le code LookML de chacun de ces scénarios.
extents_json_url	Chaîne	URL d'un fichier JSON qui définit les étendues géographiques de chaque région disponible dans le calque de carte. Ces données sont utilisées pour centrer automatiquement la carte sur les données disponibles à des fins de visualisation. Le fichier JSON doit être un objet JSON dans lequel les clés sont la valeur de mappage de la fonctionnalité (telle que spécifiée par property_key) et les valeurs sont des tableaux de quatre nombres représentant les étendues de longitude ouest, de latitude sud, de longitude est et de 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 de votre carte à l'aide du paramètre url.
feature_key	Chaîne	Nom de l'objet TopoJSON auquel le calque de carte fait référence. Si aucune valeur n'est spécifiée, le premier objet est utilisé.
format	Mot clé topojson ou vector_tile_region	Format des données des informations sur la région. Les utilisateurs utilisent généralement topojson.
label	Chaîne	Affiché dans l'UI de configuration du graphique.
max_zoom_level	Nombre	Niveau de zoom maximal pour effectuer un zoom avant sur le calque de carte, pour les visualisations compatibles avec le zoom.
min_zoom_level	Nombre	Niveau de zoom minimal pour effectuer un zoom avant sur le calque de carte, pour les visualisations compatibles avec le zoom.
projection	Mot clé	Projection géographique préférée du calque de carte lorsqu'il est affiché dans une visualisation compatible avec plusieurs projections géographiques. L'éditeur LookML répertorie les nombreuses projections disponibles lorsque vous ajoutez un paramètre de projection.
property_key	Chaîne	Propriété des données TopoJSON à tracer. TopoJSON est compatible avec les métadonnées arbitraires pour chaque région. Par défaut, la première propriété correspondante est utilisée. Si vous souhaitez tracer une propriété de métadonnées particulière, spécifiez-la ici.
property_label_key	Chaîne	Propriété des données TopoJSON à utiliser pour libeller la région. Cela est utile lorsque la valeur de mappage (définie par property_key) n'est pas très lisible par l'humain.
url	Chaîne	Emplacement de la carte, spécifié par une URL contenant votre fichier de carte.

Exemples

Si 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 au fichier JSON. Si les dossiers ne sont pas activés pour votre projet, Looker affiche les fichiers JSON dans la section Données de la liste de fichiers de l'IDE LookML.

Par exemple, si les dossiers sont activés pour votre projet et que vous disposez d'une carte personnalisée des quartiers appelée my_neighborhoods.json dans un répertoire appelé 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, vous pouvez simplement 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 à l'adresse 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 map_layer_name paramètre pour spécifier le nom que vous avez utilisé dans le map_layer paramètre.

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 représente les données à l'aide du fichier JSON neighborhoods, tel que défini dans le paramètre map_layer de votre fichier de modèle.

Bon à savoir

Graphiques de carte statique (régions)

La définition de Carte sur Auto dans les graphiques Carte statique (régions) repose sur la spécification de map_layer dans le modèle LookML qui spécifie un calque de carte. Si ce paramètre n'est pas défini, les utilisateurs reçoivent une erreur s'ils sélectionnent Auto, mais ils peuvent toujours utiliser les cartes intégrées de Looker.

Fichiers GeoJSON

Comme les fichiers TopoJSON, les fichiers GeoJSON peuvent utiliser l'extension de nom de fichier .geojson ou .json, mais doivent contenir des données géographiques au format GeoJSON. Lorsque vous utilisez un fichier GeoJSON, vous devez utiliser le sous-paramètre file ou url, et vous pouvez utiliser property_key et property_label_key de manière facultative.

Utiliser map_layer avec des dossiers IDE

Si les dossiers IDE sont activés pour votre projet, vous devez utiliser le chemin d'accès lorsque vous spécifiez un fichier de projet pour map_layer :

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