Nutzung
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"
}
|
Hierarchie
map_layer |
Standardwert
Keine
Akzeptiert
Eine Kennung für Ihre Kartenebene sowie Unterparameter, die die Eigenschaften der Kartenebene definieren.
|
Definition
Mit dem Parameter map_layer können Sie eine benutzerdefinierte Kartenebene definieren, die dann verwendet werden kann, um regionale Daten wie Landkreise oder Postleitzahlen in Looker darzustellen und Kartendiagramme zu erstellen.
Wenn eine Kartenebene vorhanden ist, wird in der Regel die interaktive Kartenvisualisierung als Standard-Kartenvisualisierung ausgewählt. Die einzige Ausnahme ist die Karte der US-Bundesstaaten. Hier verwendet Looker standardmäßig das Diagramm „Statische Karte (Regionen)“, da es Insets für Alaska und Hawaii enthält.
Kartenebenen können TopoJSON- oder GeoJSON-Dateien enthalten. Benutzerdefinierte Kartenebenen unterstützen nur Linien- und Polygongeometrien. Punktgeometrien werden nicht unterstützt. Wenn Sie Punktdaten mithilfe von Breiten- und Längengradkoordinaten auf einer Karte darstellen möchten, definieren Sie stattdessen eine Dimension vom Typ type: location.
Weitere Informationen zum Erstellen einer benutzerdefinierten Kartenebenendatei finden Sie auf der Best-Practices-Seite Benutzerdefinierte Kartenregionen erstellen.
Looker empfiehlt, Dateien für benutzerdefinierte Kartenebenen kleiner als 5 MB zu halten, um den Browsertab des Nutzers nicht zu überlasten.
Integrierte Kartenebenen
Looker enthält mehrere integrierte Kartenebenen. Bevor Sie eigene Kartenebenen erstellen, sollten Sie prüfen, ob Sie eine der integrierten Kartenebenen verwenden können:
In den integrierten Kartenebenen
countriesundus_stateswerden die Namen von Ländern und Bundesstaaten korrekt großgeschrieben. Bei der Darstellung von Daten auf der Kartenebene wird die Groß-/Kleinschreibung berücksichtigt. Daher müssen Sie in Ihren Daten die richtige Groß-/Kleinschreibung verwenden, um diese integrierten Kartenebenen nutzen zu können. Wenn in Ihrem Dataset beispielsweise „neu-delhi“ in Kleinbuchstaben verwendet wird, werden die Daten nicht korrekt auf den integrierten Kartenebenen dargestellt, die „Neu-Delhi“ verwenden.
countries: Akzeptiert vollständige Ländernamen, dreistellige Ländercodes gemäß ISO 3166-1 alpha-3 oder zweistellige Ländercodes gemäß ISO 3166-1 alpha-2. Beachten Sie, dass Sie nur eine dieser drei Optionen in Ihrem Dataset verwenden dürfen. Sie können diese Optionen nicht kombinieren.Wenn Ihre Daten ISO 3166-1 alpha-2 verwenden, fügen Sie den Parameter
map_layer_namein die Definition für Ihre Länderdimension ein, damit Looker Ihre Daten als Ländercodes erkennt und nicht fälschlicherweise als Bundesstaatscodes interpretiert. Beispiel:
dimension: country {
type: string
map_layer_name: countries
sql: ${TABLE}.country ;;
}
uk_postcode_areas– Akzeptiert Postleitzahlengebiete im Vereinigten Königreich (z. B.Lfür Liverpool,RHfür Redhill oderEHfür Edinburgh).us_states: Akzeptiert vollständige Namen von Bundesstaaten und Abkürzungen mit zwei Buchstaben.us_counties_fips: Funktioniert mit Stringfeldern, die fünfstellige FIPS-Bezirks-Codes für einen US-Bezirk sind. Diese Ebene funktioniert nur auf der interaktiven Karte.us_zipcode_tabulation_areas: Funktioniert mit Stringfeldern, die fünfstellige US-Postleitzahlen enthalten. Für Dimensionen vom Typtype: zipcodewird automatisch die Kartenebeneus_zipcode_tabulation_areasverwendet.Postleitzahlgebiete basieren auf den Postleitzahl-Tabellierungsgebieten (ZCTAs) von 2010. Daher enthält diese Kartenebene viele Postleitzahlen nicht, z. B. solche, die Postfächern zugewiesen sind und nicht direkt Regionen zugeordnet werden können.
Kartenebene angeben
Der Speicherort der Zuordnung kann entweder über den Namen einer Datei oder über eine URL angegeben werden.
Wenn Sie eine GeoJSON-Datei verwenden, müssen Sie entweder den Unterparameter file oder url verwenden. Optional können Sie auch property_key und property_label_key verwenden. Der Unterparameter feature_key wird für GeoJSON-Dateien nicht unterstützt. Die allgemeine Syntax zum Hinzufügen einer GeoJSON-Kartenebene lautet:
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"
}
Die allgemeine Syntax zum Hinzufügen einer TopoJSON-Kartenebene lautet:
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
}
Wobei:
| Parameter | Typ | Beschreibung |
|---|---|---|
identifier |
String | Name der Karte, der zum Verweisen auf die Karte in LookML verwendet werden soll. |
file |
String | Standort der Karte, angegeben durch den Namen einer JSON-Datei aus Ihrem LookML-Projekt. Die Datei muss im TopoJSON- oder GeoJSON-Format vorliegen und eine der folgenden Erweiterungen haben: .json, .geojson oder .topojson. Sie müssen den vollständigen Pfad für die JSON-Datei verwenden, z. B. "/maps/countryobjects.json" für eine Datei im Verzeichnis /maps/. Wenn sich die JSON-Datei im Stammverzeichnis und nicht in einem Ordner befindet, können Sie das Stammverzeichnis mit einem einzelnen Schrägstrich angeben, z. B. "/countryobjects.json". Wenn Ihr Projekt nicht für Ordner aktiviert ist, zeigt Looker JSON-Dateien im Abschnitt Daten der Dateiliste der LookML-IDE an. Im Abschnitt Beispiele weiter unten auf dieser Seite finden Sie die LookML für jedes dieser Szenarien. |
extents_json_url |
String | Die URL zu einer JSON-Datei, in der die geografischen Ausdehnungen der einzelnen Regionen auf der Kartenebene definiert sind. Diese Daten werden verwendet, um die Karte zu Visualisierungszwecken automatisch auf die verfügbaren Daten zu zentrieren. Die JSON-Datei muss ein JSON-Objekt sein, bei dem die Schlüssel der Zuordnungswert des Features sind (wie durch property_key angegeben) und die Werte Arrays aus vier Zahlen sind, die die westliche Länge, südliche Breite, östliche Länge und nördliche Breite der Region darstellen. Das Objekt muss einen Schlüssel für jeden möglichen Wert von property_key enthalten. Beispiel: extents_json_url: "https://mycompany.com/mapserver/json-extent.js" Wenn Sie diesen Parameter verwenden, müssen Sie den Kartenstandort mit dem Parameter url angeben. |
feature_key |
String | Name des TopoJSON-Objekts, auf das die Kartenebene verweist. Wenn nichts angegeben ist, wird das erste Objekt verwendet. |
format |
Keyword topojson oder vector_tile_region |
Datenformat der Regionsinformationen. In der Regel wird topojson verwendet. |
label |
String | Wird in der Benutzeroberfläche für die Diagrammkonfiguration angezeigt. |
max_zoom_level |
Zahl | Maximale Zoomstufe für das Zoomen in der Kartenebene, für Visualisierungen, die Zoomen unterstützen. |
min_zoom_level |
Zahl | Minimale Zoomstufe für das Zoomen in der Kartenebene, für Visualisierungen, die das Zoomen unterstützen. |
projection |
Keyword | Bevorzugte geografische Projektion der Kartenebene, wenn sie in einer Visualisierung angezeigt wird, die mehrere geografische Projektionen unterstützt. Im LookML-Editor werden die vielen verfügbaren Projektionen aufgeführt, wenn Sie einen Projektionsparameter hinzufügen. |
property_key |
String | Attribut aus den TopoJSON-Daten, das dargestellt werden soll. TopoJSON unterstützt beliebige Metadaten für jede Region. Standardmäßig wird die erste übereinstimmende Property verwendet. Wenn Sie ein bestimmtes Metadatenattribut darstellen möchten, geben Sie es hier an. |
property_label_key |
String | Attribut aus den TopoJSON-Daten, das zum Labeln der Region verwendet werden soll. Das ist nützlich, wenn der Zuordnungswert (definiert durch property_key) nicht sehr menschenlesbar ist. |
url |
String | Speicherort der Karte, angegeben durch eine URL, die Ihre Kartendatei enthält. |
Beispiele
Fügen Sie die Kartendatei nach Möglichkeit Ihrem Projekt hinzu und verweisen Sie dann mit dem Parameter file auf die Kartendatei.
Sie müssen den vollständigen Pfad für die JSON-Datei verwenden. Wenn Ihr Projekt nicht für Ordner aktiviert ist, zeigt Looker JSON-Dateien im Abschnitt Daten der Dateiliste der LookML-IDE an.
Wenn Ihr Projekt beispielsweise für Ordner aktiviert ist und Sie eine benutzerdefinierte Karte mit Stadtteilen namens my_neighborhoods.json in einem Verzeichnis namens maps haben, verwenden Sie den vollständigen Pfad so:
map_layer: neighborhoods {
file: "/maps/my_neighborhoods.json"
}
Wenn in Ihrem Projekt keine Ordner verwendet werden, werden hochgeladene Kartendateien im Abschnitt Daten des Projekts angezeigt. In diesem Fall können Sie einfach den Namen der my_neighborhoods.json-Datei angeben:
map_layer: neighborhoods {
file: "my_neighborhoods.json"
}
Alternativ können Sie angeben, dass eine benutzerdefinierte neighborhoods-Karte an anderer Stelle gehostet wird, z. B. unter https://wherever.com/my_neighborhoods.json:
map_layer: neighborhoods {
url: "https://wherever.com/my_neighborhoods.json"
}
Nachdem die Kartenebene definiert wurde (durch Angabe einer Datei oder Verwendung des Parameters url), können Sie festlegen, dass die Werte einer Dimension einer geografischen Region auf Ihrer benutzerdefinierten Karte zugeordnet werden sollen. Verwenden Sie in der Dimension den Parameter map_layer_name, um den Namen anzugeben, den Sie im Parameter map_layer verwendet haben.
dimension: neighborhood {
type: string
map_layer_name: neighborhoods # this is your map layer
sql: ${TABLE}.neighborhood_code
}
Wenn Sie diese Dimension abfragen und den Visualisierungsbereich öffnen, stellt Looker die Daten mithilfe der JSON-Datei neighborhoods dar, wie im Parameter map_layer in Ihrer Modelldatei definiert.
Wichtige Punkte
Diagramme mit statischen Karten (Regionen)
Wenn Sie Karte in Diagrammen vom Typ „Statische Karte (Regionen)“ auf Automatisch festlegen, muss map_layer im LookML-Modell angegeben sein, das eine Kartenebene angibt. Wenn dieser Parameter nicht festgelegt ist, erhalten Nutzer eine Fehlermeldung, wenn sie Automatisch auswählen. Sie können aber weiterhin die integrierten Karten von Looker verwenden.
GeoJSON-Dateien
Ähnlich wie TopoJSON-Dateien können GeoJSON-Dateien entweder die Dateiendung .geojson oder .json haben, müssen aber geografische Daten im GeoJSON-Format enthalten. Wenn Sie eine GeoJSON-Datei verwenden, müssen Sie entweder den Unterparameter file oder url verwenden. Optional können Sie property_key und property_label_key verwenden.
map_layer mit IDE-Ordnern verwenden
Wenn Sie IDE-Ordner für Ihr Projekt aktiviert haben, müssen Sie den Pfad verwenden, wenn Sie eine Projektdatei für map_layer angeben:
map_layer: neighborhoods {
file: "/maps/my_neighborhoods.json"
}