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

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

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

تحديد المشاكل وحلّها: إذا تم تشغيل التطبيق النموذجي بنجاح ولكن لم تظهر لك خريطة، تأكَّد من أنّك أضفت مفتاح واجهة برمجة التطبيقات إلى ملف بيان التطبيق، كما هو موضّح في مقالة استخدام مفاتيح واجهة برمجة التطبيقات.

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

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

• عرض خريطة أساسية
• عرض نافذة معلومات لعلامة
• إضافة علامة إلى خريطة
• عكس الترميز الجغرافي لموقع جغرافي
• تفعيل إيماءات الخريطة وإيقافها
• التعامل مع أحداث العلامات
• تفعيل زر "موقعي الجغرافي"
• رسم مضلّعات على خريطة
• رسم خطوط متعددة الأضلاع على خريطة

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

يتوفّر تطبيق Maps SDK for iOS التجريبي كـ أرشيف قابل للتنزيل من GitHub. اتّبِع الخطوات التالية لتثبيت تطبيق Maps SDK for 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" لتطبيقات iOS فيه.
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، وتعرض قائمة عروض توضيحية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google".
8. اختَر أحد الخيارات المعروضة لتجربة إحدى ميزات "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google" لأجهزة iOS.
9. إذا طُلب منك السماح لتطبيق GoogleMapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.