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

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

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

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

تشغيل نموذج التطبيق الكامل على الجهاز

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

  1. نزِّل أرشيف نماذج الرموز البرمجية من GitHub وفكِّ ضغط الأرشيف.

  2. افتح نافذة طرفية وانتقِل إلى الدليل الذي وسّعت فيه ملفّات العيّنات، ثم انتقِل إلى الدليل GooglePlaces:

    Swift

    cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
pod install
open GooglePlacesDemos.xcworkspace

    Objective-C

    cd maps-sdk-for-ios-samples-master/GooglePlaces
pod install
open GooglePlacesDemos.xcworkspace
  3. فعِّل حزمة تطوير برامج "الأماكن" لأجهزة iOS لمشروعك على Google Cloud Console.
  4. إذا لم يكن لديك مفتاح واجهة برمجة التطبيقات بعد، اتّبِع التعليمات لإعداد مشروع على وحدة تحكّم Cloud والحصول على مفتاح واجهة برمجة التطبيقات. عند ضبط مفتاح التشفير في وحدة تحكّم Cloud، يمكنك حصر المفتاح بملف تعريف حِزمة نموذج التطبيق لضمان أنّ تطبيقك فقط هو الذي يمكنه استخدام المفتاح. رقم تعريف الحِزمة الافتراضية لتطبيق نماذج حزمة تطوير البرامج (SDK) هو com.example.GooglePlacesDemos.
  5. عدِّل ملف SDKDemoAPIKey والصِق مفتاح واجهة برمجة التطبيقات في الثابت المناسب. على سبيل المثال:

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. إذا طلب منك Xcode فتح قفل ملف SDKDemoAPIKey لتعديله، اختَر فتح القفل.
  7. أزِل السطر التالي، إن توفّر، لأنّه يُستخدَم لتسجيل المشكلة:

    Swift

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

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. أنشئ التطبيق.
  9. إذا تعذّر إنشاء حزمة التطبيق أو تعطّل مع ظهور خطأ بشأن مفتاح واجهة برمجة التطبيقات عند تشغيله لأول مرة، تأكَّد من تقديم مفاتيح المطلوبة في ملف SDKDemoAPIKey.
  10. إذا كنت بصدد تشغيل نماذج GooglePlaces، ستعرض نافذة محاكي iOS قائمة بالعروض التوضيحية لـ Places.
  11. إذا طُلب منك السماح لتطبيق GooglePlacesDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.
  12. أصبح العيّنة التي اخترتها جاهزة للتنفيذ.