capa_mapa

Uso

map_layer: company_regions {
feature_key: "ISO_A3"
file: "/map_folder/regions.json"
format: 'rastreo
Jerarquía
map_layer
Valor predeterminado
Ninguna

Acepta
Es un identificador para su capa de mapa, además de subparámetros que definen sus propiedades de capas de mapas.

Definición

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

Cuando existe una capa de mapa, se suele elegir la visualización de mapa interactiva como visualización predeterminada. La única excepción es el mapa de Estados Unidos, donde Looker usa el gráfico de regiones de mapas estáticos de forma predeterminada porque usa las inserciones para Alaska y Hawái.

Las capas de mapas pueden aceptar archivos TopoJSON o GeoJSON. Sin embargo, los paneles heredados no son compatibles con los mapas que usan archivos GeoJSON.

Para obtener más información acerca de cómo crear un archivo de capa de mapa personalizado, consulta el artículo Cómo crear regiones de mapas personalizadas del Centro de ayuda.

Looker recomienda que los archivos de capas de mapas personalizados tengan un tamaño inferior a 5 MB para evitar sobrecargar la pestaña del navegador del usuario.

Capas de mapas integradas

Looker incluye varias capas de mapas integradas. Antes de crear sus propias capas de mapas, compruebe si puede usar una de las capas integradas del mapa:

Las capas de mapas integradas countries y us_states usan las mayúsculas correctas para los nombres de los países y los estados. Los datos se representan en la capa del mapa con distinción entre mayúsculas y minúsculas, por lo que también se deben usar las mayúsculas correctas para usar estas capas de mapas integradas. Por ejemplo, si tu conjunto de datos usa "delhi nuevo" en minúsculas, los datos no se representarán correctamente en las capas de mapas integradas, que utilizan "Nueva Delhi".

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

    Si sus datos usan la norma ISO 3166-1 alfa-2, incluya el parámetro map_layer_name en la definición de la dimensión de su país para asegurarse de que Looker los reconozca como códigos de país y que no los interprete incorrectamente 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.

  • us_counties_fips: Funciona en campos de string que son códigos de condado de 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 string que son códigos postales de EE.UU. de cinco caracteres. Las dimensiones de type: zipcode usan automáticamente la capa de mapa us_zipcode_tabulation_areas.

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

Cómo especificar una capa de mapa

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

Cuando usas un archivo GeoJSON, solo debes hacer referencia al subparámetro file. La sintaxis general para agregar una capa de mapa de GeoJSON es la siguiente:

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

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 Nombre del mapa como le referirás en LookML.
file String 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 tener una extensión de archivo .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 las carpetas, Looker muestra archivos JSON en la sección Datos de la lista de archivos del IDE de LookML. Para obtener información sobre cada una de estas situaciones, consulta la sección Ejemplos más adelante en esta página.
extents_json_url String La URL a 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 el mapa automáticamente 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 mapeo del elemento (como lo especifica property_key) y los valores son arreglos de cuatro números que representan la longitud de oeste, la latitud sur, la longitud este y la extensión de 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 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		 Formato de 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 Nivel de zoom máximo para acercar en la capa del mapa, para visualizaciones que admiten zoom.
min_zoom_level Número Nivel de zoom mínimo para acercar en la capa del mapa, para visualizaciones que admiten 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 proyecciones disponibles cuando agregas un parámetro de proyección.
property_key String Propiedad de los datos de TopoJSON para representar. TopoJSON admite metadatos arbitrarios para cada región. De forma predeterminada, se usa la primera propiedad coincidente. Si quieres trazar una propiedad de metadatos específica, especifícala aquí.
property_label_key String 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.
url String 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 señalarlo.

Debes usar la ruta de acceso completa del archivo JSON. Si tu proyecto no está habilitado para las carpetas, Looker muestra 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 los barrios llamados my_neighborhoods.json en un directorio llamado maps, deberías usar la ruta de acceso completa del archivo de la siguiente manera:

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

Si tu proyecto no usa carpetas, los archivos de mapa subidos se mostrarán en la sección Datos del proyecto. En este caso, 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 esté alojado en otro lugar, como en 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 utilizando el parámetro url), puedes especificar que los valores de una dimensión deben estar asociados 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 consultes esta dimensión y abras la sección de visualización, Looker representará los datos con el archivo JSON neighborhoods, como se define en el parámetro map_layer en tu archivo de modelo.

Qué debes saber

Gráficos de mapas estáticos (regiones)

Para configurar Mapa como Automático en los gráficos de mapas estáticos (regiones), se debe especificar map_layer en el modelo de LookML que especifica una capa de mapas. Si no se establece ese parámetro, los usuarios recibirán un error si seleccionan Automática, pero aún pueden usar los mapas integrados de Looker.

Archivos GeoJSON

Al igual que los archivos TopoJSON, los archivos GeoJSON pueden tener la extensión de archivo .geojson o .json, pero deben contener datos geográficos en formato GeoJSON. Cuando usas un archivo GeoJSON, solo debes hacer referencia al subparámetro file.

Los paneles heredados no son compatibles con los mapas que usan archivos GeoJSON.