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
map_layer |
Valore predefinito
Nessuno
Accetta
Un identificatore per il livello della mappa, oltre ai parametri secondari 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, ad esempio contee o codici postali, in Looker e creare grafici a 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, per la quale Looker utilizza per impostazione predefinita il grafico Regione mappa statica perché utilizza riquadri per l'Alaska e le Hawaii.
I livelli della mappa possono accettare file TopoJSON o GeoJSON. I livelli della mappa personalizzati supportano solo geometrie di linee e poligoni; le geometrie di punti non sono supportate. Per tracciare i dati dei punti su una mappa utilizzando le coordinate di latitudine e longitudine, definisci invece una dimensione di type: location.
Per saperne di più sulla creazione di un file di livello della mappa personalizzato, consulta la pagina delle best practice per la creazione di regioni della 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
countrieseus_statesutilizzano le lettere maiuscole corrette per i nomi di paesi e stati. I dati vengono tracciati sul livello della mappa in modo sensibile alle maiuscole, quindi i dati devono utilizzare anche le maiuscole corrette per utilizzare questi livelli della mappa integrati. Ad esempio, se il set di dati utilizza "nuova delhi" in minuscolo, i dati non verranno tracciati correttamente sui livelli della mappa integrati, che utilizzano "Nuova Delhi".
countries: accetta i nomi completi dei paesi, 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 solo una di queste tre opzioni nel set di dati; non puoi utilizzare una combinazione di queste opzioni.Se i tuoi dati utilizzano lo standard ISO 3166-1 alpha-2, includi il parametro
map_layer_namenella definizione della dimensione del 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 aree di codici postali del Regno Unito (ad esempio,Lper Liverpool,RHper Redhill oEHper Edimburgo).us_states: accetta i nomi completi degli stati e le abbreviazioni di due lettere.us_counties_fips: funziona su campi di stringhe 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 di stringa che sono codici postali statunitensi di cinque caratteri. Le dimensioni ditype: zipcodeutilizzano automaticamente il livello della mappaus_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, ad esempio quelli assegnati alle caselle postali, che non vengono mappati 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 sottoparametro file o url. Facoltativamente, puoi anche utilizzare property_key e property_label_key. Il sottoparametro feature_key non è supportato per i file GeoJSON. La sintassi generale per l'aggiunta di 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 | Posizione della mappa, specificata dal nome di un file JSON del tuo 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 progetto non è abilitato per le cartelle, Looker visualizza i file JSON nella sezione Data dell'elenco dei file dell'IDE di 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 mappatura della caratteristica (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 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 usano topojson. |
label |
Stringa | Visualizzato nell'interfaccia utente di configurazione del grafico. |
max_zoom_level |
Numero | Livello di zoom massimo per lo zoom nel livello della mappa, per le visualizzazioni che supportano lo zoom. |
min_zoom_level |
Numero | Livello di zoom minimo per lo zoom nel livello della 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 di 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à dei metadati specifica, indicala 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 fare riferimento 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 Data dell'elenco dei file dell'IDE di LookML.
Ad esempio, se il tuo 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 in questo modo:
map_layer: neighborhoods {
file: "/maps/my_neighborhoods.json"
}
Se il progetto non utilizza cartelle, i file di 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 in 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 a mappa statica (regioni)
L'impostazione di Mappa su Auto 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 Auto, 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, 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"
}