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 représenter des données régionales, telles que des comtés ou des codes postaux, dans Looker et créer des graphiques cartographiques.

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 est la carte des États américains, où Looker utilise le graphique "Région de la carte statique" 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 des bonnes pratiques Créer des régions de carte personnalisées.

Looker recommande de ne pas dépasser une taille de fichier de 5 Mo pour les calques 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 utilisent la bonne casse pour les noms de pays et d'États. Les données sont représentées sur le calque de carte en respectant la casse. Par conséquent, vos données doivent également utiliser la casse appropriée pour que vous puissiez utiliser ces calques de carte intégrés. Par exemple, si votre ensemble de données utilise la minuscule "new delhi", les données ne seront pas correctement représentées sur les calques de carte intégrés, qui utilisent "New Delhi".

• countries : accepte les noms de pays complets, les codes pays à trois lettres ISO 3166-1 alpha-3 ou les codes 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 les combiner.

  Si vos données utilisent la norme ISO 3166-1 alpha-2, incluez le paramètre map_layer_name dans la définition de votre dimension "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 régionaux. Exemple :

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

• uk_postcode_areas : accepte les zones de code postal 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 codes à deux lettres des États.

• us_counties_fips : fonctionne sur les champs de chaîne qui sont des codes FIPS de cinq caractères pour un comté américain. Cette couche 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, cette couche de carte n'inclut pas de nombreux codes postaux, tels que ceux attribués aux boîtes postales, qui ne correspondent pas directement 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. Le sous-paramètre feature_key n'est pas accepté pour 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, tel que "/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 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. 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 dont 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 limites ouest, sud, est et 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 sera utilisé.
format	Mot clé topojson ou vector_tile_region	Format des données des informations régionales. Les utilisateurs choisissent généralement topojson.
label	Chaîne	Affiché dans l'interface utilisateur 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 liste les nombreuses projections disponibles lorsque vous ajoutez un paramètre de projection.
property_key	Chaîne	Propriété des données TopoJSON à représenter. 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 graphiquement une propriété de métadonnées spécifique, indiquez-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.
url	Chaîne	Emplacement de la carte, spécifié par une URL contenant votre fichier de carte.

Exemples

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 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, 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 à l'adresse https://wherever.com/my_neighborhoods.json :

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

Une fois la couche de carte définie (en spécifiant un fichier ou en utilisant le paramètre url), vous pouvez indiquer 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 représente les données sous forme de graphique à 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 cartes statiques (régions)

Si vous définissez Carte sur Automatique dans les graphiques de carte statique (régions), vous devez avoir spécifié map_layer dans le modèle LookML qui spécifie une couche de carte. Si ce paramètre n'est pas défini, les utilisateurs reçoivent un message d'erreur s'ils sélectionnent Automatique, 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. Vous pouvez également utiliser property_key et property_label_key.

Utiliser map_layer avec les dossiers de l'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"
}