تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إضافة خريطة باستخدام محدّد موقع

توضح لك هذه الدورة التعليمية كيفية إضافة خريطة Google إلى تطبيق iOS. وتتضمن الخريطة علامة تُعرف أيضًا باسم دبوس للإشارة إلى موقع معين.

جارٍ الحصول على الرمز

استنسِخ أو نزِّل مستودع نماذج iOS على "خرائط Google" من GitHub.

إعداد مشروع التطوير

اتبع الخطوات التالية لتثبيت SDK للخرائط لنظام التشغيل iOS:

  1. نزّل وثبّت Xcode الإصدار 13.0 أو إصدارًا أحدث.
  2. إذا لم يكن لديك CocoaPods من قبل، يمكنك تثبيته على نظام التشغيل macOS من خلال تشغيل الأمر التالي من الوحدة الطرفية:
    sudo gem install cocoapods
  3. استنسِخ مستودع نماذج "خرائط Google" على نظام التشغيل iOS أو نزِّله.
  4. انتقِل إلى الدليل tutorials/map-with-marker.
  5. شغّل الأمر pod install. سيؤدي هذا إلى تثبيت واجهات برمجة التطبيقات المحدّدة في Podfile، وأي تبعيات قد تتوفر لديهم.
  6. افتح ملف المشروع map-with-marker.xcworkspace (النقر المزدوج) لفتحه في Xcode. يجب استخدام ملف .xcworkspace لفتح المشروع.

الحصول على مفتاح واجهة برمجة التطبيقات وتمكين واجهات برمجة التطبيقات اللازمة

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

البدء

للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على الحصول على مفتاح واجهة برمجة تطبيقات.

إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك

Swift

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift على النحو التالي:

  1. تجدر الإشارة إلى أنه تمت إضافة عبارة الاستيراد التالية إلى الملف:
    import GoogleMaps
  2. عدِّل السطر التالي في طريقة application(_:didFinishLaunchingWithOptions:)، مع استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات:
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.m على النحو التالي:

  1. تجدر الإشارة إلى أنه تمت إضافة عبارة الاستيراد التالية إلى الملف:
    @import GoogleMaps;
  2. عدِّل السطر التالي في طريقة application(_:didFinishLaunchingWithOptions:)، مع استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

إنشاء تطبيقك وتشغيله

  1. يمكنك توصيل جهاز iOS بجهاز الكمبيوتر أو اختيار محاكي من القائمة المنبثقة لنظام Xcode.
  2. إذا كنت تستخدم جهازًا، فتأكد من تمكين خدمات الموقع. إذا كنت تستخدم محاكيًا، اختَر موقعًا جغرافيًا من قائمة الميزات.
  3. في Xcode، انقر على خيار القائمة Product/Run (المنتج/التشغيل) (أو على رمز الزر "تشغيل").

ينشئ Xcode التطبيق، ثم يشغِّل التطبيق على الجهاز أو على المحاكي.

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

تحرّي الخلل وإصلاحه:

  • إذا لم تظهر لك خريطة، تأكّد من أنك حصلت على مفتاح واجهة برمجة تطبيقات وأضفته إلى التطبيق، كما هو موضّح أعلاه. تحقَّق من وحدة تصحيح الأخطاء في Xcode بحثًا عن رسائل الخطأ المتعلقة بمفتاح واجهة برمجة التطبيقات.
  • في حال تقييد مفتاح واجهة برمجة التطبيقات باستخدام معرّف حزمة iOS، يمكنك تعديل المفتاح لإضافة معرّف الحزمة للتطبيق: com.google.examples.map-with-marker.
  • تأكد من أن لديك اتصال جيد عبر WiFi أو GPS.
  • استخدِم أدوات تصحيح الأخطاء في Xcode لعرض السجلّات وتصحيح الأخطاء في التطبيق.

فهم الشفرة

  1. إنشاء خريطة وتعيينها كطريقة العرض في loadView().

    Swift

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
    view = mapView
          

    Objective-C

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                            longitude:151.20
                                                                 zoom:6.0];
    GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
    self.view = mapView;
          
  2. إضافة علامة إلى الخريطة في loadView().

    Swift

    // Creates a marker in the center of the map.
    let marker = GMSMarker()
    marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
    marker.title = "Sydney"
    marker.snippet = "Australia"
    marker.map = mapView
          

    Objective-C

    // Creates a marker in the center of the map.
    GMSMarker *marker = [[GMSMarker alloc] init];
    marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
    marker.title = @"Sydney";
    marker.snippet = @"Australia";
    marker.map = mapView;
          

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

تهانينا! لقد أنشأت تطبيق iOS يعرض خريطة Google باستخدام علامة للإشارة إلى موقع معين. كما تعلمت كيفية استخدام تطبيق SDK للخرائط لنظام التشغيل iOS.

الخطوات التالية

تعرف على المزيد من المعلومات حول كائن الخريطة، وما يمكنك فعله باستخدام العلامات.