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

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

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

تتوفر حزمة تطوير البرامج (SDK) للأماكن في نظام التشغيل iOS على شكل لوحة CocoaPods. CocoaPods هو مدير تبعية مفتوحة المصدر لمشاريع Swift وGoal-C Cocoa.

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

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

اتبع الخطوات التالية لتثبيت CocoaPods وجرّب حزمة تطوير البرامج (SDK) للأماكن في iOS:

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

   sudo gem install cocoapods

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

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

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

      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

   استخدام CocoaPods v1.6.1

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

      sudo gem install cocoapods -v1.6.1

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

      pod try GooglePlaces

      تُحدِّث شركة CocoaPods مستودعات المواصفات، ثم تفتح العروض التوضيحية لحزمة تطوير البرامج (SDK) في مشروع Xcode مؤقت، GooglePlacesDemos.xcworkspace.

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

استخدام مقتطفات الشفرة من دليل مطور البرامج

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