Los gehts

Plattform auswählen: Android iOS JavaScript

Führen Sie die folgenden Schritte aus, um datengestützte Stile für Grenzen 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 datengestützte Stile für Grenzen 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.

Experimentell :Diese Funktion kann nur für helle Kartenstile festgelegt werden. Wenn Sie einen hellen Kartenstil, für den diese Funktion aktiviert ist, mit einer Karten-ID verknüpfen, sind die aktivierten Ebenen auch für den dunklen Kartenstil verfügbar.

Element-Ebenen im neuen Kartenstil auswählen

In der Google API Console können Sie auswählen, welche Elementebenen für den neuen Kartenstil angezeigt werden sollen. Die Element-Ebene bestimmt, 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.

Auf eine Elementebene einer Karte zugreifen

Sie verwenden ein FeatureLayer-Objekt, um jede Element-Ebene einer Karte darzustellen, z. B. eine Element-Ebene für Postleitzahlen oder Orte. Um Zugriff auf ein Element-Ebenenobjekt zu erhalten, 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 Element-Ebene anzugeben. In diesem Beispiel möchten Sie auf die Ebene POSTAL_CODE zugreifen. Erstellen Sie für jede Ebene, die Sie gestalten möchten, ein anderes FeatureLayer-Objekt.

Sobald Sie das FeatureLayer-Objekt haben, können Sie die Begrenzungspolygone in diesem Element gestalten.

Hinweis :Wenn für die Karte kein FeatureLayer des angegebenen Typs vorhanden ist oder wenn datengestützte Stile für Grenzen nicht aktiviert sind, weil Sie die Karten-ID nicht angegeben haben, wird dieser Aufruf zurückgegeben, aber ein Fehler protokolliert. Mit der Methode FeatureLayer.isAvailable() können Sie feststellen, ob ein FeatureLayer verfügbar ist.

Karten-Capabilities prüfen (erforderlich)

Für datengestützte Stile für Grenzen ist eine Karten-ID erforderlich. Wenn die Karten-ID fehlt oder eine ungültige Karten-ID übergeben wird, können keine datengestützten Stile für Grenzen geladen werden. Zur Fehlerbehebung können Sie 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 Grenzen angezeigt werden. Sie müssen MapCapabilities verwenden, um während der Laufzeit zu prüfen, ob erweiterte Markierungen unterstützt werden. Wenn datengestützte Stile für Grenzen nicht unterstützt werden, 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());