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

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

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

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

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

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

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

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

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

   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. إذا لم يكن لديك مفتاح واجهة برمجة التطبيقات حتى الآن، اتّبِع instructions لإعداد مشروع على Cloud Console والحصول على مفتاح واجهة برمجة التطبيقات. عند ضبط المفتاح على Cloud Console، يمكنك حصر المفتاح على نموذج معرّف حزمة التطبيق لضمان عدم استخدام المفتاح إلا في تطبيقك. معرِّف الحزمة التلقائي لتطبيق عيّنات حزمة 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 قائمة العروض التوضيحية للأماكن.
11. إذا طُلب منك السماح لـ GooglePlacesDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.
12. النموذج الذي اخترته جاهز الآن للتشغيل.