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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختَر النظام الأساسي: Android iOS JavaScript

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

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

تتوفّر حزمة تطوير البرامج (SDK) الخاصة بخدمة Places لـ iOS على شكل لوحة CocoaPods. CocoaPods هي مدير للاعتمادية المفتوحة المصدر لمشاريع Swift وPurpose-C Cocoa.

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

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

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

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

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

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

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

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