إنشاء علامة متقدمة

اختيار النظام الأساسي: 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;

إمكانات "خرائط Google"

تضيف سمة mapCapabilities في GMSMapView عملية فحص programmatic للعناصر المتعلّقة بالخريطة. يكون ذلك مفيدًا عند الرغبة في معرفة ما إذا كانت تتوفّر إمكانات معيّنة للخريطة قبل طلب واجهات برمجة تطبيقات معيّنة. تتم أيضًا استدعاء الدالة 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;
}