livello_mappa

Utilizzo

Gerarchia
map_layer
Valore predefinito
Nessuna

Accetta
Un identificatore del livello della mappa, più i sottoparametri che definiscono le proprietà del livello.

Definizione

Il parametro map_layer consente di definire un livello di mappa personalizzato che può essere utilizzato per tracciare dati regionali, come contee o codici postali, in Looker e creare grafici di mappe.

Quando esiste un livello mappa, in genere la visualizzazione mappa interattiva viene scelta come predefinita. L'unica eccezione è la mappa degli Stati Uniti, in cui Looker utilizza per impostazione predefinita il grafico dell'area geografica di Static Maps, perché utilizza gli insiemi di dati per l'Alaska e le Hawaii.

I livelli della mappa possono accettare file TopoJSON o GeoJSON. Tuttavia, le dashboard legacy non supportano le mappe che utilizzano i file GeoJSON.

Per ulteriori informazioni sulla creazione di un file del livello di una mappa personalizzata, consulta l'articolo del Centro assistenza Creare regioni di mappa personalizzate.

Looker consiglia di mantenere i file dei livelli delle mappe personalizzati di dimensioni inferiori a 5 MB per evitare di sovraccaricare la scheda del browser dell'utente.

Livelli delle mappe integrati

Looker include diversi livelli di mappe integrati. Prima di creare i tuoi livelli di mappa, verifica se puoi utilizzare uno dei livelli integrati nella mappa:

I livelli delle mappe integrati countries e us_states utilizzano le lettere maiuscole corrette per i nomi dei paesi e degli stati. I dati vengono tracciati a livello della mappa in modo che sia sensibile alle maiuscole, pertanto i tuoi dati devono anche fare un uso corretto delle lettere maiuscole per poter utilizzare questi livelli di mappe integrati. Ad esempio, se il set di dati utilizza "nuova deli" in minuscolo, i dati non verranno tracciati correttamente sui livelli della mappa integrati che utilizzano "Nuova Delhi".

  • countries: accetta i nomi dei paesi completi, i codici paese di tre lettere ISO 3166-1 alpha-3 o i codici paese di due lettere ISO 3166-1 alpha-2. Tieni presente che devi utilizzare una sola di queste tre opzioni nel set di dati; non puoi utilizzare una combinazione di queste opzioni.

    Se i tuoi dati utilizzano ISO 3166-1 alpha-2, includi il parametro map_layer_name nella definizione della dimensione paese per assicurarti che Looker riconosca i dati come codici paese e non li interpreti in modo errato come codici di stato. Ad esempio:

  dimension: country {
      type: string
      map_layer_name: countries
      sql: ${TABLE}.country ;;
  }

  • uk_postcode_areas: accetta le aree dei codici postali del Regno Unito (ad es. L per Liverpool, RH per Redhill o EH per Edimburgo).

  • us_states: accetta i nomi completi degli stati e le abbreviazioni di due lettere dello stato.

  • us_counties_fips: funziona su campi stringa che sono codici di contea FIPS di cinque caratteri per una contea degli Stati Uniti. Questo livello funziona solo sulla mappa interattiva.

  • us_zipcode_tabulation_areas: funziona su campi stringa composti da codici postali degli Stati Uniti di cinque caratteri. Le dimensioni di type: zipcode utilizzano automaticamente il livello mappa us_zipcode_tabulation_areas.

    Le regioni con codice postale si basano sulle aree di tabulazione (ZCTA) del 2010, pertanto questo livello non include molti codici postali, come quelli assegnati a caselle postali, che non vengono mappati direttamente alle regioni.

Specificare un livello di mappa

La posizione della mappa può essere specificata utilizzando il nome di un file o un URL.

Quando utilizzi un file GeoJSON, devi solo fare riferimento al sottoparametro file. La sintassi generale per l'aggiunta di un livello mappa GeoJSON è la seguente:

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

La sintassi generale per l'aggiunta di un livello mappa TopoJSON è la seguente:

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
}

Dove:

Parametro Tipo Descrizione
identifier Stringa Nome della mappa così come vi riferirai in LookML.
file Stringa Posizione della mappa, specificata dal nome di un file JSON dal progetto LookML. Il file deve essere in formato TopoJSON o GeoJSON e avere un'estensione del file .json, .geojson o .topojson.
Devi utilizzare il percorso completo del file JSON, ad esempio "/maps/countryobjects.json" per un file della directory /maps/. Se il file JSON si trova nella directory principale e non in una cartella, puoi indicare la directory principale con un'unica barra, come in questo caso: "/countryobjects.json"
Se il tuo progetto non è abilitato per le cartelle, Looker visualizza i file JSON nella sezione Data (Dati) dell'elenco dei file dell'IDE LookML. Vedi la sezione Esempi più avanti in questa pagina per il codice LookML per ciascuno di questi scenari.
extents_json_url Stringa L'URL di un file JSON che definisce le estensioni geografiche di ogni regione disponibili nel livello mappa. Questi dati vengono utilizzati per centrare automaticamente la mappa sui dati disponibili per la visualizzazione. Il file JSON deve essere un oggetto JSON in cui le chiavi rappresentano il valore di mappatura della funzionalità (come specificato da property_key) e i valori sono array di quattro numeri che rappresentano le estensioni di longitudine ovest, latitudine sud, longitudine est e latitudine nord della regione. L'oggetto deve includere una chiave per ogni possibile valore di property_key. Ad esempio: extents_json_url: "https://mycompany.com/mapserver/json-extent.js". Se utilizzi questo parametro, devi specificare la tua posizione sulla mappa utilizzando il parametro url.
feature_key Stringa Nome dell'oggetto TopoJSON a cui fa riferimento il livello mappa. Se non specificato, verrà utilizzato il primo oggetto.
format Parola chiave
topojson o vector_tile_region		 Formato dei dati relativi alle informazioni sulla regione. In genere le persone usano topojson.
label Stringa Visualizzato nell'interfaccia utente di configurazione del grafico.
max_zoom_level Numero Livello massimo di zoom per lo zoom nel livello mappa, per le visualizzazioni che supportano lo zoom.
min_zoom_level Numero Livello minimo di zoom per il livello mappa, per le visualizzazioni che supportano lo zoom.
projection Parola chiave Proiezione geografica preferita del livello della mappa quando viene visualizzata in una visualizzazione che supporta più proiezioni geografiche. L'editor LookML elenca le tante proiezioni disponibili quando aggiungi un parametro di proiezione.
property_key Stringa Proprietà dai dati TopoJSON in base a cui tracciare. TopoJSON supporta metadati arbitrari per ogni area geografica. Per impostazione predefinita, viene utilizzata la prima proprietà corrispondente. Se vuoi tracciare una determinata proprietà di metadati, specificala qui.
property_label_key Stringa Proprietà dei dati TopoJSON da utilizzare per etichettare la regione. Ciò è utile quando il valore di mappatura (definito da property_key) non è molto leggibile.
url Stringa Posizione della mappa, specificata da un URL che contiene il file della mappa.

Esempi

Se possibile, aggiungi il file della mappa al progetto e utilizza il parametro file per indirizzarlo al file della mappa.

Devi utilizzare il percorso completo del file JSON. Se il tuo progetto non è abilitato per le cartelle, Looker visualizza i file JSON nella sezione Data dell'elenco dei file dell'IDE LookML.

Ad esempio, se il progetto è abilitato per le cartelle e hai una mappa personalizzata dei quartieri chiamata my_neighborhoods.json in una directory denominata maps, devi utilizzare il percorso file completo come descritto di seguito:

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

Se il progetto non utilizza cartelle, i file di mappe caricati vengono visualizzati nella sezione Dati del progetto. In questo caso, puoi semplicemente fornire il nome del file my_neighborhoods.json:

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

In alternativa, puoi specificare che una mappa neighborhoods personalizzata sia ospitata altrove, ad esempio su https://wherever.com/my_neighborhoods.json:

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

Dopo aver definito il livello mappa (specificando un file o utilizzando il parametro url), puoi specificare che i valori di una dimensione devono essere associati a una regione geografica sulla mappa personalizzata. Nella dimensione, utilizza il parametro map_layer_name per specificare il nome utilizzato nel parametro map_layer.

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

Quando esegui una query su questa dimensione e apri la sezione di visualizzazione, Looker traccia i dati utilizzando il file JSON neighborhoods, come definito nel parametro map_layer del file del modello.

Aspetti da tenere presenti

Grafici con mappe statiche (regioni)

L'impostazione di Mappa su Automatica nei grafici di Mappa statica (aree geografiche) richiede che map_layer sia specificato nel modello LookML per specificare un livello di mappa. Senza questo set di parametri, gli utenti ricevono un errore se selezionano Auto, ma possono comunque utilizzare le mappe integrate di Looker.

File GeoJSON

Analogamente ai file TopoJSON, i file GeoJSON possono avere l'estensione del file .geojson o .json, ma devono contenere dati geografici in formato GeoJSON. Quando utilizzi un file GeoJSON, devi solo fare riferimento al sottoparametro file.

Le dashboard legacy non supportano le mappe che utilizzano i file GeoJSON.