توضح حزمة Places SDK لنظام التشغيل iOS التجريبي على GitHub والمزودة بحزمة SDK للأماكن لنظام التشغيل iOS عددًا من الميزات تتضمن الإكمال التلقائي للأماكن وصور الأماكن. بالإضافة إلى ذلك، يمكنك العثور على مقتطفات التعليمات البرمجية في كل صفحة من دليل هذا المطور. عليك استيراد التطبيق وإنشائه وإضافة مفتاح واجهة برمجة التطبيقات وعرض العرض التوضيحي واستخدام رمز النموذج المقدَّم كنقطة انطلاق لتطبيقك.
عند تشغيل نموذج التطبيق، يعرض قائمة بالنماذج المتاحة التي يمكنك تشغيلها على جهازك الخاص. حدِّد أحد الخيارات.
تشغيل نموذج التطبيق الكامل على الجهاز
يتوفر تطبيق الأماكن SDK لنظام التشغيل iOS نموذجي كأرشيف للتنزيل من GitHub. اتبع الخطوات التالية لتثبيت وتجربة تطبيق SDK للأماكن لنظام التشغيل iOS النموذجي.
- يمكنك تنزيل أرشيف نماذج الرموز البرمجية من GitHub وفك ضغط الأرشيف.
افتح نافذة طرفية، وانتقل إلى الدليل الذي وسعت فيه نماذج الملفات، وتوغّل في دليل أماكن 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
- فعِّل حزمة تطوير برامج الأماكن لأجهزة iOS لمشروعك على Google Cloud Console.
- إذا لم يكن لديك مفتاح واجهة برمجة التطبيقات حتى الآن، اتّبِع
instructions لإعداد
مشروع على Cloud Console والحصول على مفتاح واجهة برمجة التطبيقات. عند ضبط
المفتاح على Cloud Console، يمكنك
حصر المفتاح على
نموذج معرّف حزمة التطبيق لضمان عدم استخدام المفتاح إلا في تطبيقك. معرِّف الحزمة التلقائي لتطبيق عيّنات حزمة SDK هو
com.example.GooglePlacesDemos
. - عدِّل ملف
SDKDemoAPIKey
والصِق مفتاح واجهة برمجة التطبيقات في الثابت المناسب. مثلاً:Swift
let placesAPIKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- إذا طلب منك Xcode فتح قفل ملف
SDKDemoAPIKey
لتعديله، اختَر فتح القفل. - إذا توفّرت، أزِل السطر التالي لأنّه يُستخدَم لتسجيل المشكلة:
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.
- أنشئ التطبيق.
- إذا تعذّر إنشاء الإصدار أو تعطّل التطبيق مع ظهور رسالة خطأ حول مفتاح واجهة برمجة التطبيقات
عند تشغيله لأول مرة، تأكَّد من تقديم
المفاتيح المطلوبة في ملف
SDKDemoAPIKey
. - في حال تشغيل نماذج GooglePlaces، ستعرض نافذة محاكي iOS قائمة العروض التوضيحية للأماكن.
- إذا طُلب منك السماح لـ GooglePlacesDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.
- النموذج الذي اخترته جاهز الآن للتشغيل.