Jetzt starten

Plattform auswählen: Android iOS JavaScript

Führen Sie die folgenden Schritte aus, um datengestützte Stile für Begrenzungen einzurichten.

Neuen Karten-Renderer aktivieren

Ab Version 18.0.0 des Maps SDK for Android ist ein aktualisierter Karten-Renderer verfügbar. Er umfasst viele Verbesserungen, darunter Unterstützung für das cloudbasierte Gestalten von Karteninhalten.

Im Rahmen der Veröffentlichung von Version 18.2.0 des Maps SDK for Android wurde der Standard-Renderer vom alten zum aktualisierten Karten-Renderer geändert. Daher wird beim Erstellen neuer Apps oder Überarbeiten bestehender Apps nun standardmäßig der aktualisierte Karten-Renderer verwendet.

Achtung :Wenn Sie datengetriebenes Styling für Begrenzungen in Ihrer App verwenden möchten, muss sie mit dem aktualisierten Karten-Renderer erstellt werden. Wenn Sie einer bestehenden App datengestützte Stile für Grenzen hinzufügen, müssen Sie die App so überarbeiten, dass der aktualisierte Karten-Renderer verwendet wird. Weitere Informationen finden Sie unter Neuer Karten-Renderer.

Karten-ID erstellen

Eine entsprechende Anleitung finden Sie unter Karten-ID erstellen. Sie müssen als Kartentyp Android festlegen.

Neuen Kartenstil erstellen

Folgen Sie der Anleitung unter Kartenstile verwalten, um einen neuen Kartenstil zu erstellen. Verknüpfen Sie den Stil dann mit der Karten-ID, die Sie soeben erstellt haben.

Elementebenen im neuen Kartenstil auswählen

In der Google API Console können Sie auswählen, welche Elementebenen für Ihren neuen Kartenstil angezeigt werden sollen. Die Elementebenen bestimmen, welche Arten von Grenzen auf der Karte zu sehen sind (z. B. für Orte oder Bundesländer).

Wichtig: Wählen Sie nur die erforderlichen Ebenen aus, damit ihre Karte schneller geladen werden kann.

1. Rufen Sie in der Google Cloud Console die Seite Kartenstile auf.
2. Wählen Sie ein Projekt aus, wenn Sie dazu aufgefordert werden.
3. Wählen Sie einen Kartenstil aus.
4. Klicken Sie auf das Drop-down-Menü Elementebenen, um Ebenen hinzuzufügen oder zu entfernen.
5. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern und für Ihre Karten verfügbar zu machen.

Initialisierungscode der Karte aktualisieren

Dazu ist die soeben erstellte Karten-ID erforderlich. Sie finden sie auf der Seite Kartenverwaltung.

Wie Sie die Karten-ID in den Initialisierungscode einfügen, können Sie unter Karten-ID zur App hinzufügen nachlesen.

Zugriff auf eine Elementebene einer Karte erhalten

Mit einem FeatureLayer-Objekt können Sie jede Elementebene einer Karte darstellen, z. B. eine Postleitzahl- oder Ortsebene. Wenn Sie auf ein Elementebenenobjekt zugreifen möchten, rufen Sie beim Initialisieren der Karte GoogleMap.getFeatureLayer() auf:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Übergeben Sie ein FeatureLayerOptions-Objekt an getFeatureLayer(), um den Typ der Featureebene anzugeben. In diesem Beispiel möchten Sie auf die Ebene POSTAL_CODE zugreifen. Erstellen Sie für jede Ebene, die Sie stylen möchten, ein anderes FeatureLayer-Objekt.

Sobald Sie das FeatureLayer-Objekt haben, können Sie den Begrenzungspolygonen in diesem Element ein Design zuweisen.

Hinweis :Wenn für die Karte kein FeatureLayer vom angegebenen Typ vorhanden ist oder das datengestützte Styling für Begrenzungen nicht aktiviert ist, weil Sie die Karten-ID nicht angegeben haben, wird bei diesem Aufruf ein Fehler protokolliert. Mit der Methode FeatureLayer.isAvailable() können Sie prüfen, ob ein FeatureLayer verfügbar ist.

Karten-Capabilities prüfen (erforderlich)

Für datengestützte Stile für Begrenzungen ist eine Karten-ID erforderlich. Wenn die Karten-ID fehlt oder eine ungültige Karten-ID übergeben wird, kann der datengestützte Stil für Begrenzungen nicht geladen werden. Sie können mit MapCapabilities prüfen, ob datengestützte Stile für Grenzen unterstützt werden.

Achtung :Auf einigen Geräten wird der neue Karten-Renderer eventuell nicht unterstützt. Daher können auf ihnen keine datengestützten Stile für Begrenzungen angezeigt werden. Sie müssen MapCapabilities verwenden, um während der Laufzeit zu prüfen, ob erweiterte Markierungen unterstützt werden. Wenn die Option „Datengestützte Stile für Grenzen“ nicht unterstützt wird, definieren Sie eine Fallback-Option. Geräteanforderungen für den neuen Karten-Renderer finden Sie unter Unterstützte Geräte.

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());