نظرة عامة على نماذج الرموز

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

تجربة الإصدارات التجريبية لحزمة تطوير البرامج (SDK) باستخدام CocoaPods

تتوفر حزمة تطوير برامج الأماكن لأجهزة iOS في شكل لوحة CocoaPods المتسلسلة. CocoaPods هي مديرة اعتمادية مفتوحة المصدر لمشروعات Swift وTarget-C Cocoa.

توفّر حزمة تطوير البرامج (SDK) لميزة "الأماكن" لنظام التشغيل iOS مجموعة من التطبيقات التجريبية لحزمة تطوير البرامج (SDK) التي يمكنك تثبيتها وتشغيلها باستخدام الأمر pod try:

• توضّح GooglePlaces الإكمال التلقائي للأماكن وصور الأماكن.

اتبع الخطوات التالية لتثبيت CocoaPods وتجربة حزمة تطوير برامج الأماكن لأجهزة iOS:

1. إذا لم تكن لديك أداة CocoaPods، يُرجى تثبيتها على نظام التشغيل macOS من خلال تنفيذ الأمر التالي من الوحدة الطرفية. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل البدء في CocoaPods.

   sudo gem install cocoapods

2. يمكنك الحصول على نماذج الملفات باستخدام إحدى الطريقتَين التاليتَين:
   

   استخدام الملفات من GitHub

   1. نزِّل أرشيف نموذج الرموز من GitHub وافتَح ملفات الأرشيف.
   2. افتح نافذة طرفية، وانتقِل إلى الدليل الذي وسّعت فيه نماذج الملفات، وتوغّل في دليل GooglePlaces:
      

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces

   3. نفِّذ الأمر التالي:
      

      pod install
      
      open GooglePlacesDemos.xcworkspace

   استخدام الإصدار 1.6.1 من CocoaPods

   1. افتح نافذة طرفية وثبِّت الإصدار 1.6.1:

      sudo gem install cocoapods -v1.6.1

   2. جلب ملفات "أماكن Google" باستخدام Cocoapods:

      pod try GooglePlaces

      تحدّث شركة CocoaPods مستودعات المواصفات، ثم تفتح الإصدارات التجريبية لحِزم تطوير البرامج (SDK) في مشروع Xcode مؤقت، 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 (سجّل لمفتاح واجهة برمجة التطبيقات وأدرجه هنا. ثم احذف هذا السطر)."

   Objective-C

   #error Register your API key and insert here, then delete this line.

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

استخدِم مقتطفات الرمز من دليل مطوِّر البرامج.

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