إعداد مشروع Xcode

بعد تفعيل الفوترة وإنشاء مفتاح واجهة برمجة التطبيقات، تكون جاهزًا لإعداد مشروع Xcode الذي تستخدمه لتطوير تطبيقك.

الخطوة 1: تثبيت البرنامج المطلوب

لإنشاء مشروع باستخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS، عليك تنزيل وتثبيت:

  • Xcode الإصدار 14.0 أو إصدار أحدث
  • Cocoapods أو قرطاج

الخطوة 2: إنشاء مشروع Xcode وتثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS

استخدام CocoaPods

تتوفّر حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS على شكل مجموعة CocoaPods. CocoaPods هو مدير اعتمادية مفتوحة المصدر لمشاريع Swift وGOAL-C Cocoa.

إذا لم تكن لديك أداة CocoaPods، يمكنك تثبيتها على نظام التشغيل macOS من خلال تنفيذ الأمر التالي من الوحدة الطرفية. وللتعرّف على التفاصيل، يُرجى الاطّلاع على دليل البدء في استخدام CocoaPods.

sudo gem install cocoapods

أنشئ Podfile لحزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS واستخدِمها لتثبيت واجهة برمجة التطبيقات وتبعياتها:

  1. إذا لم يكن لديك مشروع Xcode بعد، يمكنك إنشاؤه الآن وحفظه في جهازك المحلي. إذا كنت مستخدمًا جديدًا لتطوير نظام التشغيل iOS:
    1. أنشِئ مشروعًا جديدًا.
    2. اختَر نموذج iOS > App.
    3. على شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجِّل قيمة حقل معرِّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على سويف أو الهدف ج.
  2. أنشِئ ملفًا باسم Podfile في دليل مشروعك. يحدِّد هذا الملف اعتماديات مشروعك.
  3. يمكنك تعديل Podfile وإضافة المهام التابعة لك إلى جانب إصداراتها. إليك مثال يتضمن الاعتمادية التي تحتاجها لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على أجهزة iOS:
    source 'https://github.com/CocoaPods/Specs.git'
    
    platform :ios, '14.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleMaps', '8.0.0'
    end
    
    احرص على تشغيل pod outdated بانتظام لمعرفة متى يتوفّر إصدار أحدث. يمكنك الترقية إلى أحدث إصدار إذا لزم الأمر.
  4. احفظ Podfile.
  5. افتح نافذة طرفية وانتقِل إلى الدليل الذي يحتوي على Podfile:

    cd <path-to-project>
  6. شغِّل الأمر pod install. سيؤدي ذلك إلى تثبيت واجهات برمجة التطبيقات المحدّدة في Podfile، إلى جانب أي تبعيات قد تكون لديه.

    pod install
  7. أغلِق Xcode، ثم افتح (انقر مرتين) ملف مشروعك .xcworkspace لتشغيل Xcode. واعتبارًا من تلك اللحظة، عليك استخدام ملف .xcworkspace لفتح المشروع.

لتعديل واجهة برمجة تطبيقات لمشروع حالي، يمكنك اتّباع الخطوات التالية:

  1. افتَح محطة دفع وانتقِل إلى دليل المشروع الذي يحتوي على Podfile.
  2. شغِّل الأمر pod update. سيؤدي هذا الإجراء إلى تعديل جميع واجهات برمجة التطبيقات المحدّدة في Podfile إلى أحدث إصدار.

استخدام قرطاج

إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS متاحة للاستخدام مع Carthage، وهو مدير اعتمادية لامركزي بسيط لمشاريع Swift وGOAL-C Cocoa.

  1. تثبيت قرطاج تتوفر عدة طرق، ولذلك يمكنك الاطّلاع على ملف readME بقرطاج لمعرفة الخطوات الدقيقة.
  2. إذا لم يكن لديك مشروع Xcode بعد، يمكنك إنشاؤه الآن وحفظه في جهازك المحلي. إذا كنت مستخدمًا جديدًا لتطوير نظام التشغيل iOS:
    1. أنشِئ مشروعًا جديدًا.
    2. اختَر نموذج iOS > App.
    3. على شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجِّل قيمة حقل معرِّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على سويف أو الهدف ج.
  3. أنشِئ ملفًا باسم Cartfile في دليل مشروعك. يحدد هذا الملف العناصر التابعة لمشروعك.
  4. يمكنك تعديل Cartfile وإضافة الاعتماديات إلى جانب الإصدارات الخاصة بها:
    binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1
    يجب الحرص على تشغيل carthage outdated بانتظام لمعرفة متى يتوفّر إصدار أحدث لضمان استخدامك أحدث إصدار دائمًا. يمكنك الترقية إلى أحدث إصدار إذا لزم الأمر.
  5. احفظ Cartfile.
  6. في نافذة طرفية، انتقِل إلى الدليل الذي يحتوي على Cartfile:
    cd <path-to-project>
  7. شغِّل الأمر carthage update. سيؤدي ذلك إلى تثبيت واجهات برمجة التطبيقات المحدّدة في Cartfile، إلى جانب أي تبعيات قد تكون لديه.
  8. في الباحث، في دليل المشروع، انتقِل إلى ملفات إطار العمل التي تم تنزيلها ضمن Carthage/Build/iOS.
  9. اسحب الحِزم التالية إلى مشروعك: (عندما يُطلب منك، اختَر نسخ العناصر إذا لزم الأمر، يُرجى استخدام النسخة نفسها كما هو موضّح أعلاه.)
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
    • (للعملاء في خطة Premium فقط) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
  10. انقر بزر الماوس الأيمن على GoogleMaps.xcframework في مشروعك، واختَر إظهار في الباحث.
  11. اسحب GoogleMaps.bundle من المجلد Resources إلى دليل المستوى الأعلى لمشروع Xcode. تأكّد من عدم اختيار نسخ العناصر إلى مجلد المجموعة الوجهة عندما يُطلب منك ذلك.
  12. اختَر مشروعك من خلال Project Navigator، ثم اختَر هدف التطبيق.
  13. افتح علامة التبويب إصدارات المراحل لاستهداف تطبيقك، وضمن ربط برنامج ثنائي بالمكتبات، أضِف أُطر العمل والمكتبات التالية:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  14. اختَر مشروعك بدلاً من هدف محدَّد وافتح علامة تبويب إعدادات الإصدار. في قسم علامات الرابط الأخرى، أضِف -ObjC. إذا لم تكن هذه الإعدادات مرئية، يمكنك تغيير الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

  15. لتثبيت حزمة تطوير برامج الأماكن لأجهزة iOS، يُرجى الاطّلاع على البدء باستخدام حزمة تطوير برامج الأماكن لأجهزة iOS.

لتعديل واجهة برمجة تطبيقات لمشروع حالي، يمكنك اتّباع الخطوات التالية:

  1. افتَح محطة دفع وانتقِل إلى دليل المشروع الذي يحتوي على Cartfile.
  2. شغِّل الأمر carthage update. سيؤدي هذا الإجراء إلى تعديل جميع واجهات برمجة التطبيقات المحدّدة في Cartfile إلى أحدث إصدار.

التثبيت يدويًا

يوضح هذا الدليل كيفية إضافة حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS إلى مشروعك وضبط إعدادات الإصدار في Xcode يدويًا.

  1. نزِّل ملفات المصدر من حزمة تطوير البرامج (SDK): GoogleMaps-8.0.0.
  2. فُكَّ حزمة ملفات المصدر.
  3. إذا لم يكن لديك مشروع Xcode بعد، يمكنك إنشاؤه الآن وحفظه في جهازك المحلي. إذا كنت مستخدمًا جديدًا لتطوير نظام التشغيل iOS:
    1. أنشِئ مشروعًا جديدًا.
    2. اختَر نموذج iOS > App.
    3. على شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجِّل قيمة حقل معرِّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على سويف أو الهدف ج.
  4. اسحب الحِزم التالية إلى مشروعك: (عندما يُطلب منك، اختَر نسخ العناصر إذا لزم الأمر، يُرجى استخدام النسخة نفسها كما هو موضّح أعلاه.)
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
    • (للعملاء في خطة Premium فقط) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
  5. انقر بزر الماوس الأيمن على GoogleMaps.xcframework في مشروعك، واختَر إظهار في الباحث.
  6. اسحب GoogleMaps.bundle من المجلد Resources إلى دليل المستوى الأعلى لمشروع Xcode. تأكّد من عدم اختيار نسخ العناصر إلى مجلد المجموعة الوجهة عندما يُطلب منك ذلك.
  7. اختَر مشروعك من خلال Project Navigator، ثم اختَر هدف التطبيق.
  8. افتح علامة التبويب إصدارات المراحل لاستهداف تطبيقك، وضمن ربط برنامج ثنائي بالمكتبات، أضِف أُطر العمل والمكتبات التالية:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  9. اختَر مشروعك بدلاً من هدف محدَّد وافتح علامة تبويب إعدادات الإصدار. في قسم علامات الرابط الأخرى، أضِف -ObjC. إذا لم تكن هذه الإعدادات مرئية، يمكنك تغيير الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

  10. لتثبيت حزمة تطوير برامج الأماكن لأجهزة iOS، يُرجى الاطّلاع على البدء باستخدام حزمة تطوير برامج الأماكن لأجهزة iOS.

تثبيت إطار عمل CCframework

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

مع قرطاج

إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS متاحة للاستخدام مع Carthage، وهو مدير اعتمادية لامركزي بسيط لمشاريع Swift وGOAL-C Cocoa.

  1. تثبيت قرطاج تتوفر عدة طرق، ولذلك يمكنك الاطّلاع على ملف readME بقرطاج لمعرفة الخطوات الدقيقة.
  2. إذا لم يكن لديك مشروع Xcode بعد، يمكنك إنشاؤه الآن وحفظه في جهازك المحلي. إذا كنت مستخدمًا جديدًا لتطوير نظام التشغيل iOS:
    1. أنشِئ مشروعًا جديدًا.
    2. اختَر نموذج iOS > App.
    3. على شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجِّل قيمة حقل معرِّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على سويف أو الهدف ج.
  3. أنشِئ ملفًا باسم Cartfile في دليل مشروعك. يحدد هذا الملف العناصر التابعة لمشروعك.
  4. يمكنك تعديل Cartfile وإضافة الاعتماديات إلى جانب إصداراتها:

    binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1-beta
  5. احفظ Cartfile.
  6. في نافذة طرفية، انتقِل إلى الدليل الذي يحتوي على Cartfile:
    cd <path-to-project>
  7. شغِّل الأمر carthage update. سيؤدي ذلك إلى تثبيت واجهات برمجة التطبيقات المحدّدة في Cartfile، إلى جانب أي تبعيات قد تكون لديه.
  8. في الباحث، في دليل المشروع، انتقِل إلى ملفات إطار العمل التي تم تنزيلها ضمن Carthage/Build.
  9. اسحب XCframeworks إلى مشروعك ضمن الإطارات والمكتبات والمحتوى المضمَّن. تأكّد من اختيار عدم التضمين لكل XCframework:
    • GoogleMaps-x.x.x/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/GoogleMapsCore.xcframework
    • (للعملاء في خطة Premium فقط) GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
  10. انقر بزر الماوس الأيمن على GoogleMaps.xcframework في مشروعك، واختَر إظهار في الباحث.
  11. اسحب السمة GoogleMaps.bundle من المجلد ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources إلى دليل المستوى الأعلى في مشروع Xcode. تأكّد من عدم اختيار نسخ العناصر إذا لزم الأمر عندما يُطلب منك ذلك.
  12. اختَر مشروعك من خلال Project Navigator، ثم اختَر هدف التطبيق.
  13. افتح علامة التبويب Build Stages (مراحل الإنشاء) لاستهداف تطبيقك، وضمن ربط برنامج ثنائي بالمكتبات، وأضِف أُطر العمل والمكتبات التالية:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  14. اختَر مشروعك بدلاً من هدف محدَّد وافتح علامة تبويب إعدادات الإصدار. في قسم علامات الرابط الأخرى، أضِف -ObjC. إذا لم تكن هذه الإعدادات مرئية، يمكنك تغيير الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

  15. لتثبيت حزمة تطوير برامج الأماكن لأجهزة iOS XCframework، يُرجى الاطّلاع على البدء في استخدام حزمة تطوير برامج الأماكن لنظام التشغيل iOS.

يدويًا

يوضح هذا الدليل كيفية إضافة حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS إلى مشروعك وضبط إعدادات الإصدار في Xcode.

  1. نزِّل ملفات المصدر من حزمة تطوير البرامج (SDK): GoogleMaps-8.0.0.
  2. فُكَّ حزمة ملفات المصدر. انتقِل إلى المجلد frameworks للوصول إلى XCframework.
  3. إذا لم يكن لديك مشروع Xcode بعد، يمكنك إنشاؤه الآن وحفظه في جهازك المحلي. إذا كنت مستخدمًا جديدًا لتطوير نظام التشغيل iOS:
    1. أنشِئ مشروعًا جديدًا.
    2. اختَر نموذج iOS > App.
    3. على شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجِّل قيمة حقل معرِّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على سويف أو الهدف ج.
  4. اسحب XCframeworks إلى مشروعك ضمن الإطارات والمكتبات والمحتوى المضمَّن. تأكّد من اختيار عدم التضمين لكل XCframework:
    • GoogleMaps-x.x.x/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/GoogleMapsCore.xcframework
    • (للعملاء في خطة Premium فقط) GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
  5. انقر بزر الماوس الأيمن على GoogleMaps.xcframework في مشروعك، واختَر إظهار في الباحث.
  6. اسحب السمة GoogleMaps.bundle من المجلد ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources إلى دليل المستوى الأعلى في مشروع Xcode. تأكّد من عدم اختيار نسخ العناصر إذا لزم الأمر عندما يُطلب منك ذلك.
  7. اختَر مشروعك من خلال Project Navigator، ثم اختَر هدف التطبيق.
  8. افتح علامة التبويب Build Stages (مراحل الإنشاء) لاستهداف تطبيقك، وضمن ربط برنامج ثنائي بالمكتبات، وأضِف أُطر العمل والمكتبات التالية:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  9. اختَر مشروعك بدلاً من هدف محدَّد وافتح علامة تبويب إعدادات الإصدار. في قسم علامات الرابط الأخرى، أضِف -ObjC. إذا لم تكن هذه الإعدادات مرئية، يمكنك تغيير الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

  10. لتثبيت حزمة تطوير برامج الأماكن لأجهزة iOS XCframework، يُرجى الاطّلاع على البدء في استخدام حزمة تطوير برامج الأماكن لنظام التشغيل iOS.

الخطوة 3: إضافة مفتاح واجهة برمجة التطبيقات إلى المشروع

في الحصول على مفتاح واجهة برمجة تطبيقات، أنشأت مفتاحًا لواجهة برمجة التطبيقات لتطبيقك. أضِف الآن هذا المفتاح إلى مشروع Xcode الخاص بك.

في الأمثلة التالية، استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات.

Swift

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

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

Objective-C

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

  1. أضِف عبارة الاستيراد التالية:
    @import GoogleMaps;
  2. أضِف ما يلي إلى طريقة application:didFinishLaunchingWithOptions: باستخدام مفتاح واجهة برمجة التطبيقات:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. إذا كنت تستخدم أيضًا واجهة برمجة تطبيقات الأماكن، أضف مفتاحك مرة أخرى كما هو موضَّح هنا:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

الخطوة الرابعة (اختيارية): الموافقة على استخدام إطار عمل العرض بالمعدن

تتيح لك حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS إمكانية الموافقة على استخدام إطار عمل العرض المعدني من Apple. لتجربة عارض المعادن في تطبيقك، اتصل بـ [GMSServices setMetalRendererEnabled:YES] في الهدف ج أو GMSServices.setMetalRendererEnabled(true)في Swift قبل إنشاء أي طرق عرض للخريطة.

في حال تثبيت حزمة تطوير البرامج (SDK) يدويًا، عليك أيضًا التأكد من إضافة Metal.framework في Xcode.

الخطوة 5: إضافة خريطة

يوضح الرمز أدناه كيفية إضافة خريطة بسيطة إلى ViewController حالية:

  1. إضافة طرق أو تعديلها في ViewController التلقائي لتطبيقك لإنشاء مثيل GMSMapView وإعداده

    Swift

    /*
     * Copyright 2020 Google Inc. All rights reserved.
     *
     *
     * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
     * file except in compliance with the License. You may obtain a copy of the License at
     *
     *     http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software distributed under
     * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
     * ANY KIND, either express or implied. See the License for the specific language governing
     * permissions and limitations under the License.
     */
    
    import UIKit
    import GoogleMaps
    
    class ViewController: UIViewController {
    
        override func viewDidLoad() {
            super.viewDidLoad()
            // Do any additional setup after loading the view.
            // 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: self.view.frame, camera: camera)
            self.view.addSubview(mapView)
    
            // 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

    /*
    * Copyright 2020 Google Inc. All rights reserved.
    *
    *
    * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
    * file except in compliance with the License. You may obtain a copy of the License at
    *
    *     http://www.apache.org/licenses/LICENSE-2.0
    *
    * Unless required by applicable law or agreed to in writing, software distributed under
    * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
    * ANY KIND, either express or implied. See the License for the specific language governing
    * permissions and limitations under the License.
    */
    
    #import "ViewController.h"
    #import <GoogleMaps/GoogleMaps.h>
    
    @interface ViewController ()
    
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
      // Do any additional setup after loading the view.
      // 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];
      GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
      mapView.myLocationEnabled = YES;
      [self.view addSubview:mapView];
    
      // 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;
    }
    
    @end
    
          
  2. شغِّل تطبيقك. من المفترض أن ترى خريطة تتضمّن علامة واحدة تتمركز حول سيدني وأستراليا. إذا رأيت محدّد الموقع، ولكن الخريطة غير مرئية، تأكّد من أنك قدّمت مفتاح واجهة برمجة التطبيقات.

الخطوة 6 (اختيارية): الإعلان عن مخططات عناوين URL التي تستخدمها واجهة برمجة التطبيقات

بدءًا من نظامَي التشغيل iOS 9 وXcode 7، يمكن للتطبيقات الإعلان عن مخططات عناوين URL التي تنوي فتحها لفتحها، وذلك من خلال تحديد المخططات في ملف Info.plist للتطبيق. وتفتح حزمة تطوير البرامج (SDK) في "خرائط Google" لأجهزة iOS تطبيق "خرائط Google" المتوافق مع الأجهزة الجوّالة عندما ينقر المستخدم على شعار Google على الخريطة، وبالتالي يمكن لتطبيقك الإعلان عن مخططات عناوين URL ذات الصلة.

للإعلان عن مخططات عناوين URL التي تستخدمها حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على جهاز iOS، أضِف الأسطر التالية إلى Info.plist:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>googlechromes</string>
    <string>comgooglemaps</string>
</array>

تعرض لقطة الشاشة التالية الإعدادات في واجهة مستخدم Xcode:

إعدادات LSApplicationQueriesSchemes في Xcode

بدون البيان أعلاه، يمكن أن تحدث الأخطاء التالية عندما ينقر المستخدم على شعار Google على الخريطة:

-canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
-canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

لتجنّب هذه الأخطاء، يُرجى إضافة البيان إلى Info.plist كما هو موضّح أعلاه.

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

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