camada_do_mapa

Uso

map_layer: company_regions {
feature_key: "ISO_A3"
file: "/map_folder/regions.json"
format: topojson
label
Hierarquia
map_layer
Valor padrão
Nenhuma

Aceita
Um identificador para sua camada do mapa, além de subparâmetros que definem suas propriedades da camada do mapa.

Definição

O parâmetro map_layer permite definir uma camada de mapa personalizada que pode ser usada para plotar dados regionais, como condados ou CEPs, no Looker e criar gráficos de mapa.

Quando há uma camada do mapa, normalmente a visualização interativa é escolhida como a visualização padrão. A única exceção é o mapa dos Estados Unidos, em que o Looker usa o gráfico da região de mapa estático por padrão porque usa encartes do Alasca e do Havaí.

As camadas do mapa podem aceitar arquivos TopoJSON ou GeoJSON. No entanto, os painéis legados não são compatíveis com mapas que usam arquivos GeoJSON.

Para mais informações sobre como criar um arquivo de camada de mapa personalizado, consulte o artigo Como criar regiões de mapa personalizadas na Central de Ajuda.

O Looker recomenda que você mantenha os arquivos da camada de mapa personalizada com menos de 5 MB para evitar sobrecarregar a guia do navegador do usuário.

Camadas de mapa integradas

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

As camadas de mapas integradas countries e us_states usam letras maiúsculas de forma adequada para os nomes dos países e estados. Os dados são representados na camada do mapa de forma diferenciada em maiúsculas. Portanto, eles também devem usar letras maiúsculas de forma adequada para usar essas camadas de mapas integradas. Por exemplo, se o conjunto de dados usa letras minúsculas "nova delhi", os dados não serão representados corretamente nas camadas do mapa integrada, que usam "Nova Délhi".

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

    Caso seus dados usem a ISO 3166-1 alfa-2, inclua o parâmetro map_layer_name na definição da dimensão de país para garantir que o Looker reconheça seus 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 CEPs do Reino Unido (por exemplo, L para Liverpool, RH para Redhill ou EH para Edimburgo).

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

  • us_counties_fips: funciona em campos de string que são códigos do condado de 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 compostos por CEPs de cinco caracteres dos EUA. As dimensões de type: zipcode usam automaticamente a camada de mapa us_zipcode_tabulation_areas.

    As regiões de CEPs são baseadas nas áreas de tabulação de CEP (ZCTAs) de 2010. Portanto, essa camada do mapa não inclui muitos CEPs, como os atribuídos a caixas postais, que não são mapeados diretamente para as 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, você só precisa referenciar o subparâmetro file. A sintaxe geral para adicionar uma camada de mapa GeoJSON é:

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

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 da forma como você vai se referir a ele em LookML.
file String Local do mapa, especificada pelo nome de um arquivo JSON em seu projeto LookML. O arquivo precisa estar no formato TopoJSON ou GeoJSON e ter uma extensão de arquivo .json, .geojson ou .topojson.
É preciso usar o caminho completo do 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, da seguinte forma: "/countryobjects.json"
Se o projeto não estiver ativado para pastas, o Looker exibirá arquivos JSON na seção Dados da lista de arquivos do ambiente de desenvolvimento integrado do LookML. Consulte a seção Exemplos nesta página para 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 do 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". Ao usar esse parâmetro, você precisa especificar o local do mapa usando o parâmetro url.
feature_key String Nome do objeto TopoJSON que a camada do mapa referencia. 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 o topojson.
label String Exibido na IU de configuração do gráfico.
max_zoom_level Número Nível máximo de zoom na camada do mapa, para visualizações compatíveis com zoom.
min_zoom_level Número Nível mínimo de zoom na camada do mapa, para visualizações compatíveis com zoom.
projection Palavra-chave É a projeção geográfica preferida da camada do mapa quando exibida em uma visualização compatível com várias projeções geográficas. O editor LookML lista as várias projeções disponíveis quando você adiciona um parâmetro de projeção.
property_key String Propriedade dos dados de TopoJSON a serem representados. O TopoJSON aceita metadados arbitrários para cada região. Por padrão, a primeira propriedade correspondente é usada. Se você quiser visualizar uma propriedade de metadados específica, especifique-a aqui.
property_label_key String Propriedade dos dados TopoJSON a serem usados para rotular a região. Isso é útil quando o valor do mapeamento (definido por property_key) não é muito legível.
url String Local do mapa, especificado por um URL que contém seu arquivo de mapa.

Examples

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

É necessário usar o caminho completo do arquivo JSON. Se o projeto não estiver ativado para pastas, o Looker exibirá 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 do arquivo desta forma:

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

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

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

Como alternativa, especifique um mapa neighborhoods personalizado que esteja 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 devem ser associados a uma região geográfica em seu 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 de modelo.

Informações úteis

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

A definição de Map como Auto nos gráficos de mapa estático (regiões) depende da especificação de map_layer no modelo LookML, especificando uma camada do mapa. Sem esse parâmetro definido, os usuários recebem um erro se selecionam Automático, mas ainda podem usar os mapas integrados do Looker.

Arquivos GeoJSON

Semelhante aos arquivos TopoJSON, os arquivos GeoJSON podem ter a extensão de arquivo .geojson ou .json, mas precisam conter dados geográficos no formato GeoJSON. Ao usar um arquivo GeoJSON, você só precisa referenciar o subparâmetro file.

Os painéis legados não são compatíveis com mapas que usam arquivos GeoJSON.