إضافة علامة إلى خريطة

يعرض هذا المثال خريطة تتضمّن دبابيس للعلامات في سيدني وملبورن، أستراليا.

البدء

قبل أن تتمكّن من تجربة نموذج الرمز، عليك ضبط بيئة التطوير. لمزيد من المعلومات، يُرجى الاطّلاع على عيّنات الرموز البرمجية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS.

عرض الرمز

Swift

import GoogleMaps
import UIKit

// Sample code for adding a marker.
class MarkersViewController: UIViewController {
  private lazy var sydneyMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -33.8683, longitude: 151.2086))

  private lazy var melbourneMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -37.81969, longitude: 144.966085))

  private lazy var mapView: GMSMapView = {
    let camera = GMSCameraPosition(latitude: -37.81969, longitude: 144.966085, zoom: 4)
    return GMSMapView(frame: .zero, camera: camera)
  }()

  override func loadView() {
    view = mapView

    sydneyMarker.title = "Sydney"
    sydneyMarker.snippet = "Population: 4,605,992"
    sydneyMarker.isFlat = false
    sydneyMarker.rotation = 30
    print("sydneyMarker: \(sydneyMarker)")

    let australiaMarker = GMSMarker(
      position: CLLocationCoordinate2D(latitude: -27.994401, longitude: 140.07019))
    australiaMarker.title = "Australia"
    australiaMarker.appearAnimation = .pop
    australiaMarker.isFlat = true
    australiaMarker.isDraggable = true
    australiaMarker.groundAnchor = CGPoint(x: 0.5, y: 0.5)
    australiaMarker.icon = UIImage(named: "australia")
    australiaMarker.map = mapView

    mapView.selectedMarker = sydneyMarker
    navigationItem.rightBarButtonItem = UIBarButtonItem(
      barButtonSystemItem: .add, target: self, action: #selector(tapAdd))
  }

  @objc func tapAdd() {
    if sydneyMarker.map == nil {
      sydneyMarker.map = mapView
    } else {
      sydneyMarker.map = nil
    }
    melbourneMarker.title = "Melbourne"
    melbourneMarker.snippet = "Population: 4,169,103"
    melbourneMarker.map = mapView
  }
}
      

Objective-C

#import "GoogleMapsDemos/Samples/MarkersViewController.h"

#import <GoogleMaps/GoogleMaps.h>

@implementation MarkersViewController {
  GMSMarker *_sydneyMarker;
  GMSMarker *_melbourneMarker;
  GMSMarker *_fadeInMarker;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-37.81969
                                                          longitude:144.966085
                                                               zoom:4];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];

  _sydneyMarker = [[GMSMarker alloc] init];
  _sydneyMarker.title = @"Sydney";
  _sydneyMarker.snippet = @"Population: 4,605,992";
  _sydneyMarker.position = CLLocationCoordinate2DMake(-33.8683, 151.2086);
  _sydneyMarker.flat = NO;
  _sydneyMarker.rotation = 30.0;
  NSLog(@"sydneyMarker: %@", _sydneyMarker);

  GMSMarker *australiaMarker = [[GMSMarker alloc] init];
  australiaMarker.title = @"Australia";
  australiaMarker.position = CLLocationCoordinate2DMake(-27.994401, 140.07019);
  australiaMarker.appearAnimation = kGMSMarkerAnimationPop;
  australiaMarker.flat = YES;
  australiaMarker.draggable = YES;
  australiaMarker.groundAnchor = CGPointMake(0.5, 0.5);
  australiaMarker.icon = [UIImage imageNamed:@"australia"];
  australiaMarker.map = mapView;

  _fadeInMarker = [[GMSMarker alloc] init];
  _fadeInMarker.title = @"Australia";
  _fadeInMarker.position = CLLocationCoordinate2DMake(-29.9959, 145.0719);
  _fadeInMarker.appearAnimation = kGMSMarkerAnimationFadeIn;
  _fadeInMarker.icon = [UIImage imageNamed:@"australia"];

  // Set the marker in Sydney to be selected
  mapView.selectedMarker = _sydneyMarker;

  self.view = mapView;
  self.navigationItem.rightBarButtonItem =
      [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemAdd
                                                    target:self
                                                    action:@selector(didTapAdd)];
}

- (void)didTapAdd {
  if (_sydneyMarker.map == nil) {
    _sydneyMarker.map = (GMSMapView *)self.view;
  } else {
    _sydneyMarker.map = nil;
  }

  _melbourneMarker.map = nil;
  _melbourneMarker = [[GMSMarker alloc] init];
  _melbourneMarker.title = @"Melbourne";
  _melbourneMarker.snippet = @"Population: 4,169,103";
  _melbourneMarker.position = CLLocationCoordinate2DMake(-37.81969, 144.966085);
  _melbourneMarker.map = (GMSMapView *)self.view;

  if (_fadeInMarker.map) {
    _fadeInMarker.map = nil;
  } else {
    _fadeInMarker.map = (GMSMapView *)self.view;
  }
}

@end
      

تشغيل نموذج التطبيق الكامل على الجهاز

يتوفّر تطبيق "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google" لنظام التشغيل iOS كملف أرشيف للتنزيل من GitHub. اتّبِع الخطوات التالية لتثبيت تطبيق "نموذج حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS وتجربته.

  1. شغِّل git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git لنسخ مستودع العيّنات إلى دليل محلي.
  2. افتح نافذة "محطة طرفية"، وانتقِل إلى الدليل الذي نسخت فيه نموذج الملفات، ثم انتقِل إلى دليل GoogleMaps:

    Swift

    cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
    pod install
    open GoogleMapsSwiftDemos.xcworkspace

    Objective-C

    cd maps-sdk-for-ios-samples-main/GoogleMaps
    pod install
    open GoogleMapsDemos.xcworkspace
  3. في Xcode، اضغط على زرّ الترجمة لإنشاء التطبيق باستخدام المخطّط الحالي. يُرسِل عملية الإنشاء خطأً، ويطلب منك إدخال مفتاح واجهة برمجة التطبيقات في ملف SDKConstants.swift لنظام Swift أوSDKDemoAPIKey.h ملف Objective-C.
  4. إذا لم يكن لديك مفتاح واجهة برمجة تطبيقات بعد، اتّبِع التعليمات لإعداد مشروع على Google Cloud Console والحصول على مفتاح واجهة برمجة التطبيقات. عند ضبط مفتاح التشفير في وحدة تحكّم Cloud، يمكنك حصر المفتاح بملف تعريف حِزمة نموذج التطبيق لضمان أنّ تطبيقك فقط هو الذي يمكنه استخدام المفتاح. معرّف الحِزمة التلقائي لتطبيق نماذج حِزم تطوير البرامج (SDK) هو com.example.GoogleMapsDemos.
  5. عدِّل ملف SDKConstants.swift لنظام Swift أو ملفSDKDemoAPIKey.h لنظام Objective-C والصق مفتاح واجهة برمجة التطبيقات في تعريف الثابتين apiKey أو kAPIKey. على سبيل المثال:

    Swift

    static let apiKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. في ملف SDKConstants.swift (Swift) أو ملفSDKDemoAPIKey.h (Objective-C)، أزِل السطر التالي، لأنّه يُستخدَم لتسجيل المشكلة التي يحدّدها المستخدم:

    Swift

    #error (Register for API Key and insert here. Then delete this line.)

    Objective-C

    #error Register for API Key and insert here.
  7. أنشئ المشروع وشغِّله. تظهر نافذة محاكي نظام التشغيل iOS، وتعرض قائمة بالعروض التوضيحية لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google".
  8. اختَر أحد الخيارات المعروضة لتجربة إحدى ميزات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.
  9. إذا طُلب منك السماح لتطبيق GoogleMapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.