Erste Schritte

Plattform auswählen: Android iOS JavaScript

Wenn Sie datengestützte Stile für Grenzen nutzen möchten, müssen Sie eine Karten-ID erstellen. Danach erstellen Sie einen neuen Kartenstil, wählen die erforderlichen Ebenen für die Grenzen aus und verknüpfen den Stil mit Ihrer Karten-ID.

Karten-ID erstellen

Eine mapID ist eine eindeutige Kennung, die eine einzelne Instanz einer Google-Karte darstellt. In der Google Cloud Console können Sie jederzeit Karten-IDs erstellen und einen mit einer Karten-ID verknüpften Stil ändern.

Neuen Kartenstil erstellen

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

Featureebenen auswählen

In der Google Cloud Console können Sie auswählen, welche Elementebenen angezeigt werden sollen. So wird definiert, 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.

Elementebenen verwalten

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

Für diesen Schritt muss eine Karten-ID mit einem Stil verknüpft sein, für den mindestens eine Elementebene aktiviert ist. Prüfen Sie unter Kartenverwaltung, ob die Karten-ID in der Cloud Console richtig eingerichtet ist.

Swift

// A map ID using a style with one or more feature layers enabled

let mapID = GMSMapID(identifier: "YOUR_MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

Objective-C

// A map ID using a style with one or more feature layers enabled

GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];

Wichtig :Zum Testen können Sie den Schritt zum Erstellen und Konfigurieren einer Karten-ID überspringen und einfach „mapId: DEMO_MAP_ID“ in Ihrem App-Code verwenden. DEMO_MAP_ID ist nur für Testzwecke vorgesehen. DEMO_MAP_ID darf nicht in einer Produktionsumgebung verwendet werden.

Einer Karte Featureebenen hinzufügen

Um einen Verweis auf eine Elementebene auf Ihrer Karte zu erhalten, rufen Sie beim Initialisieren der Karte mapView.featureLayer(of:) auf:

Swift

let layer = mapView.featureLayer(of: .locality)

Objective-C

GMSFeatureLayer *layer = [mapView featureLayerOfFeatureType:GMSFeatureTypeLocality];

Kartenfunktionen prüfen

Für datengestützte Stile für Grenzen sind Funktionen erforderlich, die in der Google Cloud Console aktiviert und einer Karten-ID zugeordnet werden. Karten-IDs können sich ändern. Daher können Sie mapView.mapCapabilities auf einer GMSMapView aufrufen, um zu prüfen, ob eine bestimmte Funktion (z. B. datengestützte Stile) verfügbar ist, bevor Sie sie aufrufen.

Sie können auch Änderungen an Kartenfunktionen erkennen, indem Sie GMSViewDelegate abonnieren. In diesem Beispiel wird gezeigt, wie Sie mit dem Protokoll nach anforderungen für das datengestützte Styling suchen.

Swift

class SampleViewController: UIViewController {

  private lazy var mapView: GMSMapView = GMSMapView(frame: .zero, mapID: GMSMapID(identifier: "YOUR_MAP_ID"), camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

  override func loadView() {
    self.view = mapView
    mapView.delegate = self
  }
}

extension SampleViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, didChange mapCapabilities: GMSMapCapabilityFlags) {
    if (!mapCapabilities.contains(.dataDrivenStyling)) {
      // Data-driven styling is *not* available, add a fallback.
      // Existing feature layers are also unavailable.
    }
  }
}

Objective-C

@interface SampleViewController: UIViewController <GMSMapViewDelegate>
@end

@implementation SampleViewController
- (void)loadView {
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:[GMSMapID mapIDWithIdentifier:@"MAP_ID"] camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];
  mapView.delegete = self;
  self.view = mapView;
}

- (void)mapView:(GMSMapView *)mapView didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities {
  if (!(mapCapabilities & GMSMapCapabilityFlagsDataDrivenStyling)) {
    // Data-driven styling is *not* available, add a fallback.
    // Existing feature layers are also unavailable.
  }
}
@end