Stai visualizzando la documentazione di Looker 26.0. Fai clic su questo link per visualizzare la documentazione più recente.

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 del modello

map_layer

Valore predefinito

Nessuno

Accetta

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

Definizione

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

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

I livelli della mappa possono accettare file TopoJSON o GeoJSON.

Per saperne di più sulla creazione di un file di livello mappa personalizzato, consulta la pagina delle best practice Creazione di regioni mappa personalizzate.

Looker consiglia di mantenere i file dei livelli 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, controlla 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 e minuscole, quindi anche i tuoi dati devono utilizzare le maiuscole in modo corretto per poter utilizzare questi livelli della mappa integrati. Ad esempio, se il tuo 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 dei paesi, codici paese di tre lettere ISO 3166-1 alpha-3 o codici paese di due lettere ISO 3166-1 alpha-2. Tieni presente che devi utilizzare solo una di queste tre opzioni nel tuo set di dati; non puoi utilizzare un mix 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 tuoi 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 di codici postali del Regno Unito (ad esempio, L per Liverpool, RH per Redhill o EH per Edimburgo).
us_states: accetta i nomi completi degli stati e le abbreviazioni di due lettere.
us_counties_fips: funziona su campi stringa che sono codici 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 che sono codici postali statunitensi di cinque caratteri. Le dimensioni di type: zipcode utilizzano automaticamente il livello della mappa us_zipcode_tabulation_areas.

Le regioni identificate tramite codice postale si basano sulle aree di tabulazione dei codici postali (ZCTA) del 2010, pertanto questo livello della mappa non include molti codici postali, ad esempio quelli assegnati alle caselle postali, che non corrispondono direttamente alle regioni.

Specifica di 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 parametro secondario file o url. Puoi anche utilizzare facoltativamente property_key e property_label_key. Il parametro secondario feature_key non è supportato per i file GeoJSON. La sintassi generale per aggiungere un livello della mappa 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"
}

La sintassi generale per aggiungere un livello della mappa 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
}

Dove:

Parametro	Tipo	Descrizione
`identifier`	Stringa	Il nome della mappa a cui farai riferimento in LookML.
`file`	Stringa	La 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, in questo modo: `"/countryobjects.json"` Se il tuo progetto non è abilitato per le cartelle, Looker mostra i file JSON nella sezione Dati dell'elenco dei file dell'IDE LookML. Per il codice LookML di ciascuno 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 mapping della funzionalità (come specificato da `property_key`) e i valori sono array di quattro numeri che rappresentano l'estensione della regione in termini di longitudine ovest, latitudine sud, longitudine est e latitudine nord. 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 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	Il livello di zoom massimo per lo zoom avanti nel livello della mappa, per le visualizzazioni che supportano lo zoom.
`min_zoom_level`	Numero	Il livello di zoom minimo per lo zoom avanti nel 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 indicare il file della mappa.

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

Ad esempio, se il tuo progetto è abilitato per le cartelle e hai una mappa personalizzata dei quartieri chiamata my_neighborhoods.json in una directory chiamata maps, utilizzeresti il percorso completo nel seguente modo:

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

Se il progetto non utilizza 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 su 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 che hai 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 della mappa statica (regioni)

L'impostazione di Mappa su Automatico nei grafici Mappa statica (regioni) si basa sulla presenza di map_layer specificato nel modello LookML che specifica un livello della mappa. Se questo parametro non è impostato, gli utenti ricevono un errore se selezionano Automatico, 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 parametro secondario file o url e, facoltativamente, puoi utilizzare 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"
}

map_layer Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.