نموذج رمز حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS

اختيار النظام الأساسي: Android iOS JavaScript

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

قائمة نماذج حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS

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

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

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

  1. شغِّل git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git لنسخ مستودع العيّنات إلى دليل محلي.

  2. افتح نافذة "وحدة التحكّم في المحطة الطرفية"، وانتقِل إلى المجلد الذي نسخت فيه نموذج الملفات، ثم انتقِل إلى المجلد GoogleMaps:

    Swift

    cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.xcworkspace

    Objective-C

    cd maps-sdk-for-ios-samples-main/GoogleMaps
pod install
open GoogleMapsDemos.xcworkspace
  3. في Xcode، اضغط على زرّ الترجمة لإنشاء التطبيق باستخدام المخطّط الحالي. يُرسِل عملية الإنشاء خطأً يطلب منك إدخال مفتاح واجهة برمجة التطبيقات في ملف SDKConstants.swift لنظام Swift أوSDKDemoAPIKey.h ملف Objective-C.
  4. إذا لم يكن لديك مفتاح واجهة برمجة تطبيقات بعد، اتّبِع التعليمات لإعداد مشروع على Google Cloud Console والحصول على مفتاح واجهة برمجة التطبيقات. عند ضبط مفتاح التشفير في وحدة تحكّم Cloud، يمكنك حصر المفتاح بملف تعريف حِزمة نموذج التطبيق لضمان أنّ تطبيقك فقط هو الذي يمكنه استخدام المفتاح. معرّف الحِزمة التلقائي لتطبيق نماذج حِزم تطوير البرامج (SDK) هو com.example.GoogleMapsDemos.
  5. عدِّل ملف SDKConstants.swift لنظام Swift أو ملفSDKDemoAPIKey.h لنظام Objective-C والصق مفتاح واجهة برمجة التطبيقات في تعريف الثابتين apiKey أو kAPIKey. على سبيل المثال:

    Swift

    static let apiKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. في ملف SDKConstants.swift (Swift) أو ملفSDKDemoAPIKey.h (Objective-C)، أزِل السطر التالي، لأنّه يُستخدَم لتسجيل المشكلة التي يحدّدها المستخدم:

    Swift

    #error (Register for API Key and insert here. Then delete this line.)

    Objective-C

    #error Register for API Key and insert here.
  7. إنشاء المشروع وتشغيله تظهر نافذة محاكي iOS، وتعرض قائمة بالعروض التوضيحية لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google".
  8. اختَر أحد الخيارات المعروضة لتجربة إحدى ميزات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.
  9. إذا طُلب منك السماح لتطبيق GoogleMapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.