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

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

يعرض تطبيق Places SDK for iOS التجريبي على GitHub المزوّد بحزمة Places SDK for 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 Cloud Console.
  5. احصل على مفتاح واجهة برمجة تطبيقات من مشروعك الذي تم فيه تفعيل Places API و/أو Places API (جديدة).
  6. أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق باستخدام التعليمات المناسبة أدناه.

    SwiftUI

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

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

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    استبدِل YOUR_PLACES_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 قائمة بعروض توضيحية حول "أماكن Google".
  10. إذا طُلب منك السماح للتطبيق التجريبي بالوصول إلى موقعك الجغرافي، اختَر السماح.
  11. أصبحت العيّنة التي اخترتها جاهزة للتنفيذ.