map_layer

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 countries und us_states werden 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_name in 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. L für Liverpool, RH für Redhill oder EH fü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 Typ type: zipcode wird automatisch die Kartenebene us_zipcode_tabulation_areas verwendet.

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