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"
}
Hierarquia
map_layer
Valor padrão
Nenhum

Aceita
Um identificador para a camada do mapa, além de subparâmetros que definem as propriedades dela.

Definição

O parâmetro map_layer permite definir uma camada do mapa personalizada que pode ser usada para traçar dados regionais, como condados ou códigos postais, no Looker e criar gráficos de mapa.

Quando há uma camada do mapa, normalmente a visualização de mapa interativo é escolhida como padrão. A única exceção é o mapa dos estados dos EUA, em que o Looker usa o gráfico de região do mapa estático por padrão porque ele usa inserções para o Alasca e o Havaí.

As camadas do mapa aceitam arquivos TopoJSON ou GeoJSON. As camadas do mapa personalizadas são compatíveis apenas com geometrias de linha e polígono. Não há suporte para geometrias de ponto. Para traçar dados de pontos em um mapa usando coordenadas de latitude e longitude, defina uma dimensão de type: location.

Para mais informações sobre como criar um arquivo de camada do mapa personalizado, consulte a página de práticas recomendadas Como criar regiões de mapa personalizadas.

O Looker recomenda que os arquivos de camada do mapa personalizada sejam menores que 5 MB para evitar sobrecarregar a guia do navegador do usuário.

Camadas do mapa integradas

O Looker inclui várias camadas do mapa integradas. Antes de criar suas próprias camadas do mapa, verifique se é possível usar uma das camadas integradas:

As camadas do mapa integradas countries e us_states usam letras maiúsculas e minúsculas corretamente para os nomes de países e estados. Os dados são inseridos na camada do mapa de forma que diferencia maiúsculas de minúsculas. Portanto, seus dados também precisam usar as letras maiúsculas e minúsculas corretamente para usar essas camadas de mapa integradas. Por exemplo, se o conjunto de dados usar "nova delhi" em letras minúsculas, os dados não serão plotados corretamente nas camadas do mapa integradas, que usam "Nova Delhi".

  • countries: aceita nomes de países completos, códigos de país de três letras ISO 3166-1 alfa-3 ou códigos de país de duas letras ISO 3166-1 alfa-2. É preciso usar apenas uma dessas três opções no conjunto de dados. Não é possível usar uma combinação delas.

    Se os dados usarem o ISO 3166-1 alfa-2, inclua o parâmetro map_layer_name na definição da dimensão do país para garantir que o Looker reconheça os dados como códigos de país e não os interprete incorretamente como códigos de estado. Exemplo:

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

  • us_states: aceita nomes de estados completos e abreviações de duas letras.

  • us_counties_fips: funciona em campos de string que são códigos de condado FIPS de cinco caracteres para um condado dos EUA. Essa camada só funciona no mapa interativo.

  • us_zipcode_tabulation_areas: funciona em campos de string que são CEPs dos EUA com cinco caracteres. As dimensões de type: zipcode usam automaticamente a camada do mapa us_zipcode_tabulation_areas.

    As regiões de CEP são baseadas nas áreas de tabulação de CEP (ZCTAs, na sigla em inglês) de 2010. Por isso, essa camada do mapa não inclui muitos CEPs, como os atribuídos a caixas postais, que não são mapeados diretamente para regiões.

Como especificar uma camada do mapa

O local do mapa pode ser especificado usando o nome de um arquivo ou um URL.

Ao usar um arquivo GeoJSON, é necessário usar o subparâmetro file ou url. Também é possível usar property_key e property_label_key. O subparâmetro feature_key não é compatível com arquivos GeoJSON. A sintaxe geral para adicionar uma camada do mapa GeoJSON é:

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"
}

A sintaxe geral para adicionar uma camada do mapa TopoJSON é:

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
}

Em que:

Parâmetro Tipo Descrição
identifier String Nome do mapa que você vai usar no LookML.
file String Local do mapa, especificado pelo nome de um arquivo JSON do seu projeto do LookML. O arquivo precisa estar no formato TopoJSON ou GeoJSON e usar uma das seguintes extensões: .json, .geojson ou .topojson.

Use o caminho completo para o arquivo JSON, como "/maps/countryobjects.json" para um arquivo no diretório /maps/. Se o arquivo JSON estiver no diretório raiz e não em uma pasta, indique o diretório raiz com uma única barra, assim: "/countryobjects.json"

Se o projeto não estiver ativado para pastas, o Looker vai mostrar os arquivos JSON na seção Dados da lista de arquivos do ambiente de desenvolvimento integrado do LookML. Consulte a seção Exemplos mais adiante nesta página para ver o LookML de cada um desses cenários.
extents_json_url String O URL de um arquivo JSON que define as extensões geográficas de cada região disponível na camada do mapa. Esses dados são usados para centralizar automaticamente o mapa nos dados disponíveis para fins de visualização. O arquivo JSON precisa ser um objeto JSON em que as chaves são o valor de mapeamento do recurso (conforme especificado por property_key) e os valores são matrizes de quatro números que representam as extensões de longitude oeste, latitude sul, longitude leste e latitude norte da região. O objeto precisa incluir uma chave para cada valor possível de property_key. Por exemplo, extents_json_url: "https://mycompany.com/mapserver/json-extent.js". Se você usar esse parâmetro, especifique o local do mapa usando o parâmetro url.
feature_key String Nome do objeto TopoJSON referenciado pela camada do mapa. Se não for especificado, o primeiro objeto será usado.
format Palavra-chave

topojson ou vector_tile_region
Formato de dados das informações da região. Normalmente, as pessoas usam topojson.
label String Mostrado na UI de configuração do gráfico.
max_zoom_level Número Nível máximo de zoom na camada do mapa, para visualizações que aceitam zoom.
min_zoom_level Número Nível mínimo de zoom na camada do mapa, para visualizações que aceitam zoom.
projection Palavra-chave Projeção geográfica preferencial da camada do mapa quando exibida em uma visualização que aceita várias projeções geográficas. O editor do LookML lista as várias projeções disponíveis quando você adiciona um parâmetro de projeção.
property_key String Propriedade dos dados do TopoJSON para plotagem. O TopoJSON é compatível com metadados arbitrários para cada região. Por padrão, a primeira propriedade correspondente é usada. Se houver uma propriedade de metadados específica que você queira usar para o gráfico, especifique-a aqui.
property_label_key String Propriedade dos dados do TopoJSON que será usada para rotular a região. Isso é útil quando o valor de mapeamento (definido por property_key) não é muito legível por humanos.
url String Local do mapa, especificado por um URL que contém o arquivo do mapa.

Exemplos

Quando possível, adicione o arquivo de mapa ao projeto e use o parâmetro file para apontar para ele.

Use o caminho completo para o arquivo JSON. Se o projeto não estiver ativado para pastas, o Looker vai mostrar os arquivos JSON na seção Dados da lista de arquivos do ambiente de desenvolvimento integrado do LookML.

Por exemplo, se o projeto estiver ativado para pastas e você tiver um mapa personalizado de bairros chamado my_neighborhoods.json em um diretório chamado maps, use o caminho completo desta forma:

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

Se o projeto não usar pastas, os arquivos de mapa enviados vão aparecer na seção Dados do projeto. Nesse caso, basta informar o nome do arquivo my_neighborhoods.json:

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

Como alternativa, é possível especificar que um mapa neighborhoods personalizado está hospedado em outro lugar, como em https://wherever.com/my_neighborhoods.json:

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

Depois que a camada do mapa for definida (especificando um arquivo ou usando o parâmetro url), você poderá especificar que os valores de uma dimensão sejam associados a uma região geográfica no mapa personalizado. Na dimensão, use o parâmetro map_layer_name para especificar o nome usado no parâmetro map_layer.

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

Quando você consulta essa dimensão e abre a seção de visualização, o Looker cria um gráfico dos dados usando o arquivo JSON neighborhoods, conforme definido no parâmetro map_layer no arquivo do modelo.

Informações importantes

Gráficos de mapa estático (regiões)

Definir Mapa como Automático em gráficos de mapa estático (regiões) depende de ter map_layer especificado no modelo do LookML que especifica uma camada do mapa. Sem esse parâmetro definido, os usuários vão receber um erro se selecionarem Automático, mas ainda poderão usar os mapas integrados do Looker.

Arquivos GeoJSON

Assim como os arquivos TopoJSON, os arquivos GeoJSON podem usar a extensão de nome de arquivo .geojson ou .json, mas precisam conter dados geográficos no formato GeoJSON. Ao usar um arquivo GeoJSON, é necessário usar o subparâmetro file ou url, e você pode usar property_key e property_label_key.

Como usar map_layer com pastas do ambiente de desenvolvimento integrado

Se as pastas do ambiente de desenvolvimento integrado estiverem ativadas para seu projeto, use o caminho ao especificar um arquivo de projeto para map_layer:

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