إعداد مشروع Xcode

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

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

لإنشاء مشروع باستخدام الخرائط SDK لنظام التشغيل iOS، يجب تنزيل وتثبيت:

  • Xcode الإصدار 13.0 أو إصدار أحدث

  • Cocoapods أو Carthage

الخطوة 2: إنشاء مشروع Xcode وتثبيت "حزمة تطوير البرامج" (SDK) للخرائط على الأجهزة التي تعمل بنظام التشغيل iOS

استخدام CocoaPods

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

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

sudo gem install cocoapods

يمكنك إنشاء Podfile لحزمة تطوير البرامج لخرائط Google لنظام التشغيل iOS واستخدامها لتثبيت واجهة برمجة التطبيقات وتبعياتها:

  1. إذا لم يكن لديك مشروع Xcode حتى الآن، يمكنك إنشاء مشروع الآن وحفظه على جهازك المحلي. إذا كنت مستخدمًا جديدًا في مجال تطوير نظام التشغيل iOS:
    1. أنشئ مشروعًا جديدًا.
    2. حدد النموذج iOS > التطبيق.
    3. في شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجّل قيمة حقل معرّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على Swift أو Goal-C.
  2. أنشئ ملفًا باسم Podfile في دليل مشروعك. يحدّد هذا الملف تبعيات مشروعك.
  3. يمكنك تعديل Podfile وإضافة العناصر التابعة لك إلى جانب إصداراتها. في ما يلي مثال على التبعية التي تحتاجها لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS: 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.4.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 > التطبيق.
    3. في شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجّل قيمة حقل معرّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على Swift أو Goal-C.
  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. لتثبيت حزمة تطوير البرامج (SDK) للأماكن لأجهزة iOS، راجع البدء في استخدام حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل iOS.

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

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

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

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

  1. نزِّل ملفات المصدر لحزمة تطوير البرامج (SDK): GoogleMaps-7.4.0.
  2. فك ضغط ملفات المصدر.
  3. إذا لم يكن لديك مشروع Xcode حتى الآن، يمكنك إنشاء مشروع الآن وحفظه على جهازك المحلي. إذا كنت مستخدمًا جديدًا في مجال تطوير نظام التشغيل iOS:
    1. أنشئ مشروعًا جديدًا.
    2. حدد النموذج iOS > التطبيق.
    3. في شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجّل قيمة حقل معرّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على Swift أو Goal-C.
  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. لتثبيت حزمة تطوير البرامج (SDK) للأماكن لأجهزة iOS، راجع البدء في استخدام حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل iOS.

تثبيت XCFramework

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

قرطاج

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

  1. ثبّت قرطاج. هناك عدة طرق، لذا اطّلِع على ملف قرطاج README لمعرفة الخطوات الدقيقة.
  2. إذا لم يكن لديك مشروع Xcode حتى الآن، يمكنك إنشاء مشروع الآن وحفظه على جهازك المحلي. إذا كنت مستخدمًا جديدًا في مجال تطوير نظام التشغيل iOS:
    1. أنشئ مشروعًا جديدًا.
    2. حدد النموذج iOS > التطبيق.
    3. في شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجّل قيمة حقل معرّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على Swift أو Goal-C.
  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 التالية إلى مشروعك ضمن Frameworks والمكتبات والمحتوى المضمّن. تأكّد من اختيار عدم التضمين لكل 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. افتح علامة التبويب إنشاء مراحل لاستهداف تطبيقك، وضمن ربط برنامج ثنائي مع المكتبات، وأضِف إطارات العمل والمكتبات التالية:
    • 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. لتثبيت الأماكن SDK لنظام التشغيل iOS XCFramework، راجع البدء في استخدام الأماكن SDK لنظام التشغيل iOS.

يدويًا

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

  1. نزِّل ملفات المصدر لحزمة تطوير البرامج (SDK): GoogleMaps-7.4.0.
  2. فك ضغط ملفات المصدر. انتقل إلى مجلد Frameworks للوصول إلى XCFramework.
  3. إذا لم يكن لديك مشروع Xcode حتى الآن، يمكنك إنشاء مشروع الآن وحفظه على جهازك المحلي. إذا كنت مستخدمًا جديدًا في مجال تطوير نظام التشغيل iOS:
    1. أنشئ مشروعًا جديدًا.
    2. حدد النموذج iOS > التطبيق.
    3. في شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجّل قيمة حقل معرّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على Swift أو Goal-C.
  4. اسحب XCFrameworks التالية إلى مشروعك ضمن Frameworks والمكتبات والمحتوى المضمّن. تأكّد من اختيار عدم التضمين لكل 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. افتح علامة التبويب إنشاء مراحل لاستهداف تطبيقك، وضمن ربط برنامج ثنائي مع المكتبات، وأضِف إطارات العمل والمكتبات التالية:
    • 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. لتثبيت الأماكن SDK لنظام التشغيل iOS XCFramework، راجع البدء في استخدام الأماكن SDK لنظام التشغيل 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"];

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

تتيح لك SDK للخرائط في نظام التشغيل 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

    ViewController.m

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

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

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

للإعلان عن مخططات عناوين URL التي تستخدمها حزمة تطوير البرامج (SDK) للخرائط في نظام التشغيل 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 العديد من البرامج التعليمية ونماذج التطبيقات التي يمكن أن تساعدك في البدء. لمزيد من التفاصيل، راجع: