حزمة تطوير برامج الأماكن لنماذج التعليمات البرمجية لنظام التشغيل iOS

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

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

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

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

يتوفّر تطبيق Places SDK for iOS النموذجي كـ أرشيف تنزيل من GitHub. اتّبِع الخطوات التالية لتثبيت تطبيق Places SDK for iOS النموذجي وتجربته.

  1. نزِّل أرشيف عيّنة التعليمات البرمجية من GitHub وفكّ ضغط الأرشيف. يمكنك بدلاً من ذلك استنساخ المستودع في دليل محلي: 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. افتح نافذة أوامر طرفية، وانتقِل إلى الدليل الذي فككت فيه ضغط الملفات النموذجية، ثم انتقِل إلى الدليل الخاص بالإصدار الذي تريد استخدامه:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. في مشروع Xcode، انتقِل إلى ملف (File) > إضافة موارد الاعتمادية للحزمة (Add Package Dependencies). أدخِل https://github.com/googlemaps/ios-places-sdk كعنوان URL، واضغط على Enter لجلب الحزمة، ثم انقر على إضافة حزمة.
  4. فعِّل Places SDK for iOS و حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS لمشروعك في وحدة تحكّم Google Cloud.
  5. احصل على مفتاح واجهة برمجة تطبيقات من مشروعك الذي تم فيه تفعيل Places API و/أو Places API (الجديدة).
  6. أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق باستخدام التعليمات المناسبة أدناه.

    SwiftUI

    أنشئ ملف إعدادات محليًا باسم GooglePlacesDemos.xcconfig لمفتاح واجهة برمجة التطبيقات، في الدليل نفسه الذي يوجد فيه ملف Info.plist الخاص بالتطبيق التجريبي (GooglePlacesDemos/GooglePlacesDemos).

    أضِف سطرَين إلى ملف الإعداد لتحديد مفاتيح واجهة برمجة التطبيقات:

    ‫PLACES_API_KEY = YOUR_PLACES_API_KEY، MAPS_API_KEY = YOUR_MAPS_API_KEY

    استبدِل YOUR_PLACES_API_KEY وYOUR_MAPS_API_KEY بمفاتيح واجهة برمجة التطبيقات من الخطوات السابقة.

    للحصول على مساعدة بشأن إنشاء ملف إعداد محلي، يُرجى الاطّلاع على تنسيق ملف إعدادات الإعداد (xcconfig).

    Swift

    عدِّل ملف SDKDemoAPIKey وألصِق مفتاح واجهة برمجة التطبيقات في الثابت المناسب. على سبيل المثال:

    let placesAPIKey = "YOUR_API_KEY"

    إذا كانت متوفرة، أزِل السطر التالي:

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

    إذا طلب منك Xcode فتح ملف SDKDemoAPIKey لتعديله، اختَر فتح.

    Objective-C

    عدِّل ملف SDKDemoAPIKey وألصِق مفتاح واجهة برمجة التطبيقات في الثابت المناسب. على سبيل المثال:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    أزِل السطر التالي إذا كان متوفّرًا

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

    إذا طلب منك Xcode فتح ملف SDKDemoAPIKey لتعديله، اختَر فتح.

  7. إنشاء التطبيق
  8. إذا تعذّر إنشاء التطبيق أو تعطّل مع ظهور خطأ بشأن مفتاح واجهة برمجة التطبيقات عند تشغيله لأول مرة، تأكَّد من أنّك قد قدّمت المفاتيح المطلوبة في التعليمات أعلاه.
  9. إذا شغّلت نموذج التطبيق، ستعرض نافذة محاكي iOS قائمة بعروض Places التوضيحية.
  10. إذا طُلب منك السماح للتطبيق التجريبي بالوصول إلى موقعك الجغرافي، اختَر السماح.
  11. أصبحت العيّنة التي اخترتها جاهزة للتنفيذ.