نموذج رمز حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS

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

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

قائمة نماذج حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS

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

تشغيل نموذج التطبيق الكامل محليًا

يتوفّر نموذج تطبيق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS على شكل أرشيف قابل للتنزيل من GitHub. اتّبِع الخطوات التالية لتثبيت نموذج تطبيق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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/GoogleMaps-Swift
open GoogleMapsSwiftXCFrameworkDemos.xcodeproj

    Objective-C

    cd maps-sdk-for-ios-samples-main/GoogleMaps
open GoogleMapsDemos.xcodeproj
  3. في مشروع Xcode، انتقِل إلى ملف (File) > إضافة موارد الاعتمادية للحزمة (Add Package Dependencies). أدخِل https://github.com/googlemaps/ios-maps-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على إضافة حزمة (Add Package).
  4. في Xcode، اضغط على زر التجميع من أجل إنشاء التطبيق باستخدام المخطط الحالي. تؤدي عملية الإنشاء إلى ظهور خطأ يطلب منك إدخال مفتاح واجهة برمجة التطبيقات في ملف SDKConstants.swift للغة Swift أو ملفSDKDemoAPIKey.h للغة Objective-C.
  5. احصل على مفتاح واجهة برمجة تطبيقات من مشروعك مع تفعيل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS.
  6. عدِّل ملف 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";
  7. في ملف 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.
  8. أنشئ المشروع وشغِّله. ستظهر نافذة محاكي iOS، وتعرض قائمة بالإصدارات التجريبية من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google".
  9. حدِّد أحد الخيارات المعروضة لتجربة ميزة من ميزات "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع iOS".
  10. إذا طُلب منك السماح لتطبيق GoogleMapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.