Sie sehen sich die Dokumentation für Looker 22.16 an. Die aktuelle Dokumentation finden Sie hier.

Kartenebene

Nutzung

map_layer: company_regions {
feature_key: "ISO_A3"
Datei: "/map_folder/regions.json"
format: topojson
label: "gewünschtes Label für Diagrammvisualisierung"

Hierarchie

Modelldatei

map_layer

Standardwert

Keine

Akzeptiert

Eine Kennung für die Kartenebene sowie Unterparameter, mit denen die Eigenschaften der Kartenebene definiert werden.

Definition

Mit dem Parameter map_layer können Sie eine benutzerdefinierte Kartenebene definieren, mit der regionale Daten wie Countys oder Postleitzahlen in Looker grafisch dargestellt und Kartendiagramme erstellt werden können.

Wenn eine Kartenebene vorhanden ist, wird in der Regel die interaktive Kartenvisualisierung als Standardkartenvisualisierung ausgewählt. Die einzige Ausnahme stellt die US-Karte dar, auf der Looker standardmäßig das Static Map-Regionsdiagramm verwendet, da für Alaska und Hawaii Overlays verwendet werden.

Kartenebenen können TopoJSON- oder GeoJSON-Dateien akzeptieren. In alten Dashboards werden jedoch keine Karten unterstützt, die GeoJSON-Dateien verwenden.

Weitere Informationen zum Erstellen einer Datei mit benutzerdefinierten Kartenebenen finden Sie im Hilfeartikel Benutzerdefinierte Kartenregionen erstellen.

Looker empfiehlt, benutzerdefinierte Kartenebenendateien unter 5 MB zu speichern, um zu verhindern, dass der Browser-Tab des Nutzers überlastet wird.

Integrierte Kartenebenen

Looker enthält mehrere integrierte Kartenebenen. Bevor Sie Ihre eigenen Kartenebenen erstellen, prüfen Sie, ob Sie eine der integrierten Kartenebenen verwenden können:

In den integrierten Kartenebenen countries und us_states wird die Groß- und Kleinschreibung von Namen für Länder und Bundesstaaten richtig verwendet. Bei den Daten wird auf der Kartenebene zwischen Groß- und Kleinschreibung unterschieden. Daher müssen Ihre Daten auch die richtige Groß- und Kleinschreibung verwenden. Wenn Ihr Dataset beispielsweise den Kleinbuchstaben „new delhi“ verwendet, werden die Daten auf den integrierten Kartenebenen mit „Neu-Delhi“ nicht korrekt dargestellt.

countries — Akzeptiert vollständige Ländernamen, ISO 3166-1 alpha-3dreistellige Ländercodes oder ISO 3166-1 alpha-2 zweistellige Ländercodes. Beachten Sie, dass Sie nur eine dieser drei Optionen in Ihrem Dataset verwenden dürfen. Sie können diese Optionen nicht miteinander kombinieren.

Wenn Sie für 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 Bundesstaatcodes interpretiert. Beispiel:

  dimension: country {
      type: string
      map_layer_name: countries
      sql: ${TABLE}.country ;;
  }

uk_postcode_areas: Akzeptiert Postleitzahlen 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 und Abkürzungen von US-Bundesstaaten
us_counties_fips: Funktioniert für Stringfelder, die aus fünfstelligen FIPS-County-Codes für einen US-County bestehen. Diese Ebene funktioniert nur auf der interaktiven Karte.
us_zipcode_tabulation_areas: Funktioniert für Stringfelder, die aus fünfstelligen US-Postleitzahlen bestehen. Bei Dimensionen von type: zipcode wird automatisch die Kartenebene us_zipcode_tabulation_areas verwendet.

Postleitzahlenbereiche basieren auf den Postleitzahlenbereichen (ZCTAs, Zip Code Tabulation Area) für 2010. Diese Kartenebene enthält daher nicht viele Postleitzahlen, z. B. solche mit Postfachadressen, die nicht direkt Regionen zugeordnet sind.

Kartenebene angeben

Der Speicherort der Karte kann entweder anhand des Namens einer Datei oder einer URL angegeben werden.

Wenn Sie eine GeoJSON-Datei verwenden, müssen Sie nur auf den Unterparameter file verweisen. Die allgemeine Syntax zum Hinzufügen einer GeoJSON-Kartenebene lautet:

map_layer: identifier {
  file: "/file_path/file_name.geojson"
}

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, wie Sie in LookML darauf verweisen.
`file`	String	Speicherort der Karte, angegeben durch den Namen einer JSON-Datei aus Ihrem LookML-Projekt. Die Datei muss im TopoJSON- oder GeoJSON-Format vorliegen und die Dateiendung `.json`, `.geojson` oder `.topojson` haben. Sie müssen den vollständigen Dateipfad 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. Beispiel: `"/countryobjects.json"` Wenn Ihr Projekt nicht für Ordner aktiviert ist, werden in Looker JSON-Dateien im Abschnitt Daten der Dateiliste von LookML IDE angezeigt. 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, die die geografischen Ausdehnungen der einzelnen Regionen auf der Kartenebene definiert. 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, wobei die Schlüssel der Zuordnungswert des Merkmals sind (wie durch `property_key` angegeben) und die Werte Arrays mit vier Zahlen sind, die für die Länge der Region (Westen, Süden, Osten und Norden) stehen. Das Objekt muss für jeden möglichen Wert von `property_key` einen Schlüssel enthalten. Beispiel: `extents_json_url: "https://mycompany.com/mapserver/json-extent.js"` Wenn Sie diesen Parameter verwenden, müssen Sie den Standort auf der Karte mit dem Parameter `url` angeben.
`feature_key`	String	Name des TopoJSON-Objekts, auf das die Kartenebene verweist. Wenn nicht angegeben, wird das erste Objekt verwendet.
`format`	Keyword `topojson` oder `vector_tile_region`	Datenformat der Regionsinformationen. Normalerweise 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 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 aufgelistet, wenn Sie einen Projektionsparameter hinzufügen.
`property_key`	String	Eigenschaft aus den TopoJSON-Daten zur Darstellung. TopoJSON unterstützt für jede Region beliebige Metadaten. Standardmäßig wird die erste übereinstimmende Property verwendet. Wenn Sie eine bestimmte Metadateneigenschaft darstellen möchten, geben Sie sie hier an.
`property_label_key`	String	Property aus den TopoJSON-Daten, mit denen die Region gekennzeichnet werden kann. Dies ist nützlich, wenn der durch `property_key` definierte Zuordnungswert nicht sehr lesbar ist.
`url`	String	Standort der Karte, angegeben durch eine URL, die Ihre Kartendatei enthält.

Beispiele

Fügen Sie die Kartendatei nach Möglichkeit Ihrem Projekt hinzu und verwenden Sie dann den Parameter file, um auf die Kartendatei zu verweisen.

Sie müssen den vollständigen Dateipfad für die JSON-Datei verwenden. Wenn Ihr Projekt nicht für Ordner aktiviert ist, werden in Looker im Bereich Daten der Dateiliste von LookML IDE JSON-Dateien angezeigt.

Wenn Ihr Projekt beispielsweise für Ordner aktiviert ist und Sie eine benutzerdefinierte Karte mit Vierteln namens my_neighborhoods.json in einem Verzeichnis namens maps haben, verwenden Sie den vollständigen Dateipfad 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 Datei my_neighborhoods.json angeben:

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

Alternativ können Sie festlegen, 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 mit dem Parameter url), können Sie auf Ihrer benutzerdefinierten Karte festlegen, dass die Werte einer Dimension mit einer geografischen Region verknüpft 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 Abschnitt „Visualisierung“ öffnen, erstellt Looker ein Diagramm der Daten mithilfe der JSON-Datei neighborhoods, die im Parameter map_layer Ihrer Modelldatei definiert ist.

Wichtige Informationen

Statische Karten (Regionen)

Wenn Sie Karte in Diagrammen zu statischen Karten auf Automatisch setzen, muss map_layer im LookML-Modell eine Kartenebene angeben. Ohne diesen Parameter erhalten Nutzer eine Fehlermeldung, wenn sie Auto auswählen, aber trotzdem die integrierten Looker-Karten verwenden können.

GeoJSON-Dateien

Ähnlich wie TopoJSON-Dateien können auch 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 nur auf den Unterparameter file verweisen.

Legacy-Dashboards unterstützen keine Karten, die GeoJSON-Dateien verwenden.