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

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

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

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

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

1. نزِّل أرشيف نموذج الرمز البرمجي من GitHub وفكّ ضغط الأرشيف. بدلاً من ذلك، استنسِخ المستودع إلى دليل محلي:

   git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git

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

   Swift

   cd maps-sdk-for-ios-samples/GooglePlaces-Swift/
   open GooglePlacesSwiftXCFrameworkDemos.xcodeproj

   Objective-C

   cd maps-sdk-for-ios-samples/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. عدِّل ملف SDKDemoAPIKey وألصِق مفتاح واجهة برمجة التطبيقات في الثابت المناسب. على سبيل المثال:

   Swift

   let placesAPIKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. إذا طلب منك Xcode فتح ملف SDKDemoAPIKey لتعديله، اختَر فتح.
8. إذا كانت هذه السمة متوفّرة، أزِل السطر التالي لأنّه يُستخدم لتسجيل المشكلة:

   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.

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