تراكبات الأرض

اختيار النظام الأساسي: Android iOS JavaScript

العناصر الأرضية المتراكبة هي عناصر على الخريطة مرتبطة بالإحداثيات المتعلّقة بالعرض/الطول، لذا تتحرّك عند سحب الخريطة أو تكبيرها أو تصغيرها.

مقدمة

التراكب الأرضي هو صورة يتم تثبيتها على خريطة. على عكس العلامات، يتم توجيه الصور التي تظهر على سطح الأرض مقارنةً بسطح الأرض بدلاً من الشاشة، لذا سيؤدي تدوير الخريطة أو إمالتها أو تكبيرها أو تصغيرها إلى تغيير اتجاه الصورة.

لإضافة عنصر أرضي، أنشئ عنصرًا GMSGroundOverlay يحدّد رمزًا وحدًا. في حال عدم تحديد أيّ منهما، لن يظهر التراكب الأرضي على الخريطة. يمكنك اختياريًا تحديد إعدادات إضافية ستؤثر في موضع الصورة على الخريطة. بعد تحديد الخيارات اللازمة، اضبط السمة map لهذا الجسم على إضافة التراكب.

إضافة تراكب

1. إنشاء مثيل لعنصر GMSGroundOverlay جديد
2. اضبط سمة icon على مثيل من UIImage.
3. اضبط سمة bounds على مثيل من GMSCoordinateBounds. تمثّل حدود زوايا الجنوب الغربي والشمال الشرقي من الصورة.
4. اضبط السمات الاختيارية، مثل bearing وzoomLevel، على النحو المطلوب.
5. اضبط السمة map، وستظهر الصورة على الخريطة.

يوضّح المثال التالي كيفية إضافة عنصر أرضية إلى عنصر GMSMapView حالي.

Swift

let southWest = CLLocationCoordinate2D(latitude: 40.712216, longitude: -74.22655)
let northEast = CLLocationCoordinate2D(latitude: 40.773941, longitude: -74.12544)
let overlayBounds = GMSCoordinateBounds(coordinate: southWest, coordinate: northEast)

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
let icon = UIImage(named: "newark_nj_1922")

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView
      

Objective-C

CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(40.712216,-74.22655);
CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(40.773941,-74.12544);
GMSCoordinateBounds *overlayBounds = [[GMSCoordinateBounds alloc] initWithCoordinate:southWest
                                                                        coordinate:northEast];

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
UIImage *icon = [UIImage imageNamed:@"newark_nj_1922"];
GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;
      

إزالة تراكب

يمكنك إزالة تراكب أرضي من الخريطة من خلال ضبط سمة map في GMSGroundOverlay على nil. بدلاً من ذلك، يمكنك إزالة كل العناصر التي تظهر على سطح الخريطة (بما في ذلك العناصر التي تظهر على سطح الأرض حاليًا على الخريطة) من خلال استدعاء الأسلوب GMSMapView clear.

Swift

mapView.clear()
      

Objective-C

[mapView clear];
      

إذا أردت إجراء تعديلات على عنصر أرضي متراكب بعد إضافته إلى الخريطة، احرص على الاحتفاظ بالعنصر GMSGroundOverlay. يمكنك تعديل العنصر الأرضي لاحقًا من خلال إجراء تغييرات على هذا العنصر.

Swift

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView

// ...

overlay.isTappable = true
      

Objective-C

GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;

// ...
overlay.tappable = YES;
      

الفعاليات

يمكنك الاستماع إلى الأحداث التي تحدث على الخريطة، مثل عندما ينقر مستخدم على أحد العناصر التي تظهر على سطح الخريطة. للاستماع إلى الأحداث، يجب تنفيذ بروتوكول GMSMapViewDelegate. اطّلِع على دليل الأحداث وقائمة الطرق على GMSMapViewDelegate.