map_layer

Utilizzo

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

Gerarchia File modello map_layer

Valore predefinito Nessuno Accetta Un identificatore per il livello della mappa, oltre a sottoparametri che definiscono le proprietà del livello della mappa.

Definizione

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

Quando esiste un livello della mappa, in genere la visualizzazione mappa interattiva viene scelta come visualizzazione mappa predefinita. L'unica eccezione è la mappa degli stati degli Stati Uniti, in cui Looker utilizza il grafico Regione mappa statica per impostazione predefinita perché utilizza gli inserti per Alaska e Hawaii.

I livelli della mappa possono accettare file TopoJSON o GeoJSON.

Per ulteriori informazioni sulla creazione di un file di livello della mappa personalizzato, consulta la pagina Best practice per la creazione di regioni mappa personalizzate .

Looker consiglia di mantenere i file di livello della mappa personalizzati di dimensioni inferiori a 5 MB per evitare di sovraccaricare la scheda del browser dell'utente.

Livelli della mappa integrati

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

I livelli della mappa integrati countries e us_states utilizzano le lettere maiuscole corrette per i nomi di paesi e stati. I dati vengono tracciati sul livello della mappa in modo sensibile alle maiuscole/minuscole, pertanto anche i dati devono utilizzare le lettere maiuscole corrette per poter utilizzare questi livelli della mappa integrati. Ad esempio, se il set di dati utilizza "new delhi" in minuscolo, i dati non verranno tracciati correttamente sui livelli della mappa integrati, che utilizzano "New Delhi".

• countries — accetta nomi completi di paesi, ISO 3166-1 alpha-3 codici paese a tre lettere o ISO 3166-1 alpha-2 codici paese a due lettere. Tieni presente che devi utilizzare solo una 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 map_layer_name parametro nella definizione della dimensione del paese per assicurarti che Looker riconosca i dati come codici paese e non li interpreti erroneamente come codici 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 degli stati a due lettere.

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

• us_zipcode_tabulation_areas: funziona sui campi stringa che sono codici postali statunitensi a cinque caratteri. Le dimensioni di type: zipcode utilizzano automaticamente il livello della mappa us_zipcode_tabulation_areas.

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

Specificare un livello della mappa

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

Quando utilizzi un file GeoJSON, devi utilizzare il sottoparametro file o url. Puoi anche utilizzare facoltativamente property_key e property_label_key. Il sottoparametro feature_key non è supportato per i file GeoJSON. La sintassi generale per aggiungere un livello della mappa GeoJSON è la seguente:

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

La sintassi generale per aggiungere un livello della 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 a cui farai riferimento in LookML.
file	Stringa	Posizione della mappa, specificata dal nome di un file JSON del progetto LookML. Il file deve essere in formato TopoJSON o GeoJSON e utilizzare una delle seguenti estensioni: .json, .geojson o .topojson. Devi utilizzare il percorso completo del file JSON, ad esempio "/maps/countryobjects.json" per un file nella directory /maps/. Se il file JSON si trova nella directory principale e non in una cartella, puoi indicare la directory principale con una singola barra, ad esempio: "/countryobjects.json" Se il progetto non è abilitato per le cartelle, Looker visualizza i file JSON nella sezione Dati dell'elenco dei file dell'IDE di LookML. Per il codice LookML di ognuno di questi scenari, consulta la sezione Esempi più avanti in questa pagina.
extents_json_url	Stringa	L'URL di un file JSON che definisce le estensioni geografiche di ogni regione disponibile nel livello della mappa. Questi dati vengono utilizzati per centrare automaticamente la mappa sui dati disponibili a scopo di visualizzazione. Il file JSON deve essere un oggetto JSON in cui le chiavi sono 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 valore possibile di property_key. Ad esempio, extents_json_url: "https://mycompany.com/mapserver/json-extent.js". Se utilizzi questo parametro, devi specificare la posizione della mappa utilizzando il parametro url.
feature_key	Stringa	Nome dell'oggetto TopoJSON a cui fa riferimento il livello della mappa. Se non viene specificato, verrà utilizzato il primo oggetto.
format	Parola chiave topojson o vector_tile_region	Formato dei dati delle informazioni sulla regione. In genere le persone utilizzano topojson.
label	Stringa	Visualizzato nell'interfaccia utente di configurazione del grafico.
max_zoom_level	Numero	Livello di zoom massimo per lo zoom in del livello della mappa, per le visualizzazioni che supportano lo zoom.
min_zoom_level	Numero	Livello di zoom minimo per lo zoom in del livello della mappa, per le visualizzazioni che supportano lo zoom.
projection	Parola chiave	Proiezione geografica preferita del livello della mappa quando viene visualizzato in una visualizzazione che supporta più proiezioni geografiche. L'editor LookML elenca le numerose proiezioni disponibili quando aggiungi un parametro di proiezione.
property_key	Stringa	Proprietà dei dati TopoJSON da tracciare. TopoJSON supporta metadati arbitrari per ogni regione. Per impostazione predefinita, viene utilizzata la prima proprietà corrispondente. Se vuoi tracciare una proprietà di metadati specifica, specificala qui.
property_label_key	Stringa	Proprietà dei dati TopoJSON da utilizzare per etichettare la regione. Questa opzione è 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 poi utilizza il parametro file per puntare al file della mappa.

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

Ad esempio, se il progetto è abilitato per le cartelle e hai una mappa personalizzata dei quartieri denominata my_neighborhoods.json in una directory denominata maps, utilizzerai il percorso completo come segue:

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

Se il progetto non utilizza le cartelle, i file della mappa 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 è ospitata altrove, ad esempio all'indirizzo https://wherever.com/my_neighborhoods.json:

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

Dopo aver definito il livello della 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 nel file del modello.

Cose da sapere

Grafici mappa statica (regioni)

L'impostazione di Mappa su Automatica nei grafici Mappa statica (regioni) si basa sulla specifica di map_layer nel modello LookML che specifica un livello della mappa. Se questo parametro non è impostato, gli utenti ricevono un errore se selezionano Automatica, ma possono comunque utilizzare le mappe integrate di Looker.

File GeoJSON

Analogamente ai file TopoJSON, i file GeoJSON possono utilizzare l'estensione del nome file .geojson o .json, ma devono contenere dati geografici in formato GeoJSON. Quando utilizzi un file GeoJSON, devi utilizzare il sottoparametro file o url e puoi utilizzare facoltativamente property_key e property_label_key.

Utilizzo di map_layer con le cartelle IDE

Se hai abilitato le cartelle IDE per il tuo progetto, devi utilizzare il percorso quando specifichi un file di progetto per map_layer:

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