יצירת סמן מתקדם

בחירת פלטפורמה: Android iOS JavaScript

השתמש במחלקה המשנית GMSAdvancedMarker כדי ליצור תכונות סמנים בסיסיות או ספציפיות, כפי שמתואר בהמשך. כתת-מחלקה של GMSMarker, GMSAdvancedMarker מספקת לסמנים יותר ביטוי.

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;

הערה: כדי לבצע בדיקה, אפשר לדלג על שלב היצירה וההגדרה של מזהה המפה באמצעות mapId: DEMO_MAP_ID בקוד האפליקציה. DEMO_MAP_ID מיועד למטרות בדיקה בלבד. אין להשתמש ב-DEMO_MAP_ID בסביבת ייצור.

הסרת סמן מתקדם

בדומה ל-GMSMarker, ניתן לך להסיר סמן מתקדם מהמפה על ידי הגדרת מאפיין המפה של GMSAdvancedMarker ל-nil. לחלופין, ניתן להסיר את כל שכבות-העל (כולל סמנים מתקדמים) במפה על ידי קריאה לשיטה GMSMapView clear.

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];
      

אם אתם רוצים לבצע שינויים בסמן אחרי שהוספתם אותו למפה, הקפידו לשמור את האובייקט GMSAdvancedMarker. ניתן לשנות את הסמן מאוחר יותר על ידי ביצוע שינויים באובייקט הזה.

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;

יכולות במפה

בנכס mapCapabilities ב-GMSMapView נוסף חיפוש פרוגרמטי של תכונות ספציפיות למפה. האפשרות הזו שימושית כשרוצים לדעת אם יכולות מסוימות של מפה זמינות לפני שמפעילים ממשקי API ספציפיים. גם הפונקציה didChangeMapCapabilities של GMSMapViewDelegate מופעלת בהתאם לשינויים ביכולות. השאילתה הזו קובעת אם תצוגת המפה תומכת בסמנים מתקדמים.

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;
}