Erweiterte Markierungen erstellen

Plattform auswählen: Android iOS JavaScript

Verwenden Sie die abgeleitete GMSAdvancedMarker-Klasse, um einfache oder bestimmte Markierungsmerkmale, wie unten gezeigt. Als Unterklasse von GMSMarker bietet GMSAdvancedMarker Markierungen mehr Ausdruckskraft.

Swift

let camera = GMSCameraPosition( target: coordinate, zoom: 14)
let mapID = GMSMapID(identifier: "YOUR_MAP_ID")
let mapView = GMSMapView(frame: view.bounds, mapID: mapID, camera: camera)

let marker = GMSAdvancedMarker(position: coordinate)
marker.map = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithTarget:kCoordinate zoom:16];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:"YOUR_MAP_ID"];

self.mapView = [GMSMapView mapWithFrame:self.view.bounds mapID:mapID camera:camera];

GMSAdvancedMarker *marker = [GMSAdvancedMarker markerWithPosition:kCoordinate];
Marker.map = self.mapView;

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

Erweiterte Markierungen entfernen

Ähnlich wie bei GMSMarker können Sie eine erweiterte Markierung von der Karte entfernen, indem Sie die Karteneigenschaft von GMSAdvancedMarker auf nil setzen. Sie können auch alle Overlays entfernen (einschließlich der Markierungen) auf der Karte durch Aufrufen der clear-Methode GMSMapView.

Swift

let camera = GMSCameraPosition.camera(
  withLatitude: -33.8683,
  longitude: 151.2086,
  zoom: 6
)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
// ...
mapView.clear()
      

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
// ...
[mapView clear];
      

Wenn Sie eine Markierung ändern möchten, nachdem Sie sie der Karte hinzugefügt haben, muss das Objekt GMSAdvancedMarker beibehalten werden. Sie können die Markierung später mithilfe dieses Objekts ändern.

Swift

let position = CLLocationCoordinate2D(latitude: 10, longitude: 10)
let marker = GMSAdvancedMarker(position: position)
marker.map = mapView
// ...
marker.map = nil

Objective-C

CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10);
GMSAdvancedMarker *marker = [GMSAdvancedMarker markerWithPosition:position];
marker.map = mapView;
// ...
marker.map = nil;

Kartenfunktionen

Mit der Property mapCapabilities für GMSMapView werden programmatische Werbebuchungen die Suche nach kartenspezifischen Funktionen. Dies ist nützlich, wenn Sie wissen möchten, bestimmte Kartenfunktionen vor dem Aufrufen bestimmter APIs verfügbar sind. Die didChangeMapCapabilities-Funktion von GMSMapViewDelegate ist ebenfalls eingerufen, wenn sich die Funktionen ändern. Mit dieser Abfrage wird ermittelt, ob die Kartenansicht erweiterte Markierungen unterstützt.

Swift

// ...

let advancedMarker: GMSAdvancedMarker = {
GMSAdvancedMarker(position: CLLocationCoordinate2D(latitude: 47.6089945, longitude: -122.3410462))
}()

let marker: GMSMarker = {
GMSMarker(position: CLLocationCoordinate2D(latitude: 47.6089945, longitude: -122.3410462))
}()

func addMarker() {
  if mapView.mapCapabilities.contains(.advancedMarkers) {
      advancedMarker.map = mapView
    } else {
      marker.map = mapView
    }
}

extension MapCapabilities: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, didChangeMapCapabilities mapCapabilities: GMSMapCapabilityFlags) {

     let advancedMarkerAvailable = mapCapabilities.contains(.advancedMarkers)

     advancedMarker.map = advancedMarkerAvailable ? mapView : nil
     marker.map = advancedMarkerAvailable ? nil : mapView
  }
}

Objective-C

// ...

_advancedMarker = [GMSAdvancedMarker markerWithPosition:  kSeattleCoordinates];
_fallbackMarker = [GMSMarker markerWithPosition: kSeattleCoordinates];

-   (void)addMarker {

  if (_mapView.mapCapabilities & GMSMapCapabilityFlagsAdvancedMarkers) {
    _advancedMarker.map = _mapView;
    } else {
    _fallbackMarker.map = _mapView;
  }
}

#pragma mark - GMSMapViewDelegate

-   (void)mapView:(GMSMapView *)mapView
    didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities {
  BOOL advancedMarkersAvailable = mapCapabilities & GMSMapCapabilityFlagsAdvancedMarkers;
  _advancedMarker.map = advancedMarkersAvailable ? _mapView : nil;
  _fallbackMarker.map = advancedMarkersAvailable ? nil : _mapView;
}