Erste Schritte

Plattform auswählen: iOS JavaScript

Wenn Sie datengestützte Stile für Grenzen verwenden möchten, müssen Sie eine Karten-ID erstellen. Als Nächstes müssen Sie einen neuen Kartenstil erstellen, die erforderlichen Elementebenen für Begrenzungen auswählen und den Stil mit Ihrer Karten-ID verknüpfen.

Karten-ID erstellen

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

Neuen Kartenstil erstellen

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

Elementebenen auswählen

In der Google Cloud Console können Sie auswählen, welche Featureebenen angezeigt werden sollen. Damit wird festgelegt, welche Arten von Grenzen auf der Karte angezeigt werden (z. B. Orte, Bundesländer usw.).

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 einem Stil mit einer oder mehreren aktivierten Elementebenen zugeordnet sein. Wenn Sie prüfen möchten, ob die Karten-ID in der Cloud Console korrekt eingerichtet ist, sehen Sie sich unter Kartenverwaltung die entsprechende Konfiguration an.

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 :Für Testzwecke können Sie den Schritt zum Erstellen und Konfigurieren einer Karten-ID überspringen, indem Sie „mapId:“ DEMO_MAP_ID in Ihrem App-Code verwenden. DEMO_MAP_ID ist nur für Testzwecke vorgesehen. Verwenden Sie DEMO_MAP_ID nicht in einer Produktionsumgebung.

Einer Karte Elementebenen 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. Da sich Karten-IDs ändern, können Sie mapView.mapCapabilities für eine GMSMapView aufrufen, um vor dem Aufruf zu prüfen, ob eine bestimmte Funktion (z. B. datengestützte Stile) verfügbar ist.

Sie können auch Änderungen an Kartenfunktionen erkennen, indem Sie GMSViewDelegate abonnieren. In diesem Beispiel wird gezeigt, wie Sie das Protokoll verwenden, um zu prüfen, ob Anforderungen an datengestützte Stile vorliegen.

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