map_layer

Uso

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"
}
Jerarquía
map_layer
Valor predeterminado
Ninguno

Acepta
Un identificador para la capa del mapa, además de subparámetros que definen las propiedades de la capa del mapa.

Definición

El parámetro map_layer te permite definir una capa de mapa personalizada que, luego, se puede usar para trazar datos regionales, como condados o códigos postales, en Looker y crear gráficos de mapa.

Cuando existe una capa del mapa, por lo general, se elige la visualización de mapa interactivo como la visualización de mapa predeterminada. La única excepción es el mapa de estados de EE.UU., en el que Looker usa el gráfico de región de mapa estático de forma predeterminada porque usa inserciones para Alaska y Hawái.

Las capas de mapa pueden aceptar archivos TopoJSON o GeoJSON. Las capas de mapas personalizados solo admiten geometrías de línea y polígono; no se admiten las geometrías de punto. Para trazar datos de puntos en un mapa con coordenadas de latitud y longitud, define una dimensión de type: location en su lugar.

Para obtener más información sobre cómo crear un archivo de capa de mapa personalizado, consulta la página de prácticas recomendadas para crear regiones de mapas personalizados.

Looker recomienda que los archivos de capa del mapa personalizados no superen los 5 MB para evitar sobrecargar la pestaña del navegador del usuario.

Capas del mapa integradas

Looker incluye varias capas de mapas integradas. Antes de crear tus propias capas de mapa, verifica si puedes usar una de las capas de mapa integradas:

Las capas del mapa integradas countries y us_states usan mayúsculas de forma correcta para los nombres de países y estados. Los datos se trazan en la capa del mapa distinguiendo mayúsculas de minúsculas, por lo que tus datos también deben usar las mayúsculas adecuadas para usar estas capas de mapas integradas. Por ejemplo, si tu conjunto de datos usa "nueva delhi" en minúsculas, los datos no se trazarán correctamente en las capas del mapa integradas, que usan "Nueva Delhi".

  • countries: Acepta nombres de países completos, códigos de país de tres letras ISO 3166-1 alpha-3 o códigos de país de dos letras ISO 3166-1 alpha-2. Ten en cuenta que debes usar solo una de estas tres opciones en tu conjunto de datos; no puedes usar una combinación de estas opciones.

    Si tus datos usan ISO 3166-1 alfa-2, incluye el parámetro map_layer_name en la definición de tu dimensión de país para asegurarte de que Looker reconozca tus datos como códigos de país y no los interprete de forma incorrecta como códigos de estado. Por ejemplo:

  dimension: country {
      type: string
      map_layer_name: countries
      sql: ${TABLE}.country ;;
  }
  • uk_postcode_areas: Acepta áreas de código postal del Reino Unido (por ejemplo, L para Liverpool, RH para Redhill o EH para Edimburgo).

  • us_states: Acepta nombres de estados completos y abreviaturas de estados de dos letras.

  • us_counties_fips: Funciona en campos de cadena que son códigos de condado FIPS de cinco caracteres para un condado de EE.UU. Esta capa solo funciona en el mapa interactivo.

  • us_zipcode_tabulation_areas: Funciona en campos de cadena que son códigos postales de EE.UU. de cinco caracteres. Las dimensiones de type: zipcode usan automáticamente la capa del mapa us_zipcode_tabulation_areas.

    Las regiones de códigos postales se basan en las áreas de tabulación de códigos postales (ZCTA) de 2010, por lo que esta capa del mapa no incluye muchos códigos postales, como los asignados a apartados postales, que no se asignan directamente a regiones.

Especifica una capa del mapa

La ubicación del mapa se puede especificar con el nombre de un archivo o una URL.

Cuando uses un archivo GeoJSON, debes usar el subparámetro file o url. También puedes usar property_key y property_label_key de forma opcional. El subparámetro feature_key no es compatible con los archivos GeoJSON. La sintaxis general para agregar una capa del mapa de GeoJSON es la siguiente:

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 sintaxis general para agregar una capa de mapa de TopoJSON es la siguiente:

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
}

Aquí:

Parámetro Tipo Descripción
identifier String Es el nombre del mapa como se hará referencia a él en LookML.
file String Es la ubicación del mapa, especificada por el nombre de un archivo JSON de tu proyecto de LookML. El archivo debe estar en formato TopoJSON o GeoJSON, y usar una de las siguientes extensiones: .json, .geojson o .topojson.

Debes usar la ruta de acceso completa del archivo JSON, como "/maps/countryobjects.json" para un archivo en el directorio /maps/. Si el archivo JSON está en el directorio raíz y no en una carpeta, puedes indicar el directorio raíz con una sola barra diagonal, de la siguiente manera: "/countryobjects.json"

Si tu proyecto no está habilitado para carpetas, Looker muestra los archivos JSON en la sección Datos de la lista de archivos del IDE de LookML. Consulta la sección Ejemplos más adelante en esta página para ver el LookML de cada una de estas situaciones.
extents_json_url String Es la URL de un archivo JSON que define las extensiones geográficas de cada región disponible en la capa del mapa. Estos datos se usan para centrar automáticamente el mapa en los datos disponibles con fines de visualización. El archivo JSON debe ser un objeto JSON en el que las claves sean el valor de asignación del componente (como lo especifica property_key) y los valores sean arrays de cuatro números que representen las extensiones de longitud oeste, latitud sur, longitud este y latitud norte de la región. El objeto debe incluir una clave para cada valor posible de property_key. Por ejemplo, extents_json_url: "https://mycompany.com/mapserver/json-extent.js". Si usas este parámetro, debes especificar la ubicación del mapa con el parámetro url.
feature_key String Es el nombre del objeto TopoJSON al que hace referencia la capa del mapa. Si no se especifica, se usará el primer objeto.
format Palabra clave

topojson o vector_tile_region
Es el formato de los datos de la información de la región. Por lo general, las personas usan topojson.
label String Se muestra en la IU de configuración del gráfico.
max_zoom_level Número Es el nivel de zoom máximo para acercar la capa del mapa, en el caso de las visualizaciones que admiten el zoom.
min_zoom_level Número Es el nivel de zoom mínimo para acercar la capa del mapa, en el caso de las visualizaciones que admiten el zoom.
projection Palabra clave Es la proyección geográfica preferida de la capa del mapa cuando se muestra en una visualización que admite varias proyecciones geográficas. El editor de LookML enumera las numerosas proyecciones disponibles cuando agregas un parámetro de proyección.
property_key String Es la propiedad de los datos de TopoJSON con la que se realizará el trazado. TopoJSON admite metadatos arbitrarios para cada región. De forma predeterminada, se usa la primera propiedad coincidente. Si hay una propiedad de metadatos en particular con la que deseas realizar un trazado, especifícala aquí.
property_label_key String Es la propiedad de los datos de TopoJSON que se usará para etiquetar la región. Esto es útil cuando el valor de asignación (definido por property_key) no es muy legible por humanos.
url String Es la ubicación del mapa, especificada por una URL que contiene tu archivo de mapa.

Ejemplos

Cuando sea posible, agrega el archivo de mapa a tu proyecto y, luego, usa el parámetro file para apuntar al archivo de mapa.

Debes usar la ruta de acceso completa para el archivo JSON. Si tu proyecto no está habilitado para carpetas, Looker muestra los archivos JSON en la sección Datos de la lista de archivos del IDE de LookML.

Por ejemplo, si tu proyecto está habilitado para carpetas y tienes un mapa personalizado de vecindarios llamado my_neighborhoods.json en un directorio llamado maps, usarías la ruta de acceso completa de la siguiente manera:

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

Si tu proyecto no usa carpetas, los archivos de mapas subidos se muestran en la sección Datos del proyecto. En este caso, solo puedes proporcionar el nombre del archivo my_neighborhoods.json:

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

Como alternativa, puedes especificar que un mapa neighborhoods personalizado se aloje en otro lugar, como https://wherever.com/my_neighborhoods.json:

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

Después de definir la capa del mapa (especificando un archivo o usando el parámetro url), puedes especificar que los valores de una dimensión se deben asociar con una región geográfica en tu mapa personalizado. En la dimensión, usa el parámetro map_layer_name para especificar el nombre que usaste en el parámetro map_layer.

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

Cuando consultas esta dimensión y abres la sección de visualización, Looker traza los datos con el archivo JSON neighborhoods, como se define en el parámetro map_layer de tu archivo de modelo.

Información importante

Gráficos de mapa estático (regiones)

Si configuras Mapa en Automático en los gráficos de mapa estático (regiones), se debe especificar map_layer en el modelo de LookML que especifica una capa del mapa. Sin ese parámetro, los usuarios reciben un error si seleccionan Automático, pero pueden seguir usando los mapas integrados de Looker.

Archivos GeoJSON

Al igual que los archivos TopoJSON, los archivos GeoJSON pueden usar la extensión de nombre de archivo .geojson o .json, pero deben contener datos geográficos en formato GeoJSON. Cuando uses un archivo GeoJSON, debes usar el subparámetro file o url, y, de manera opcional, puedes usar property_key y property_label_key.

Usa map_layer con carpetas de IDE

Si tienes habilitadas las carpetas del IDE para tu proyecto, debes usar la ruta de acceso cuando especifiques un archivo de proyecto para map_layer:

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