Uso
feature_key: "ISO_A3"
file: "/map_folder/regions.json"
format: 'rastreo
Jerarquía
map_layer |
Valor predeterminado
NingunaAcepta
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
yus_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 oEH
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 detype: zipcode
usan automáticamente la capa de mapaus_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.