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

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

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

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

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

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

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

تشغيل نموذج التطبيق الكامل محليًا

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

ملاحظة مهمة: عليك إزالة أيّ تبعيات حالية تمت إضافتها باستخدام CocoaPods أو يدويًا. راجِع الخطوة 2 من مقالة إعداد مشروع Xcode للحصول على التعليمات.

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

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

   Swift

   cd maps-sdk-for-ios-samples/GoogleMaps-Swift
   open GoogleMapsSwiftXCFrameworkDemos.xcodeproj

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   open GoogleMapsDemos.xcodeproj

3. في مشروع Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies). أدخِل https://github.com/googlemaps/ios-maps-sdk كعنوان URL، واضغط على مفتاح الإدخال لجلب الحزمة، ثم انقر على إضافة حزمة (Add Package).
4. في Xcode، اضغط على زر التجميع لـ إنشاء التطبيق باستخدام المخطط الحالي. ينتج عن عملية الإنشاء خطأ يطلب منك إدخال مفتاح واجهة برمجة التطبيقات في الملف SDKConstants.swift للغة Swift أوSDKDemoAPIKey.h الملف للغة Objective-C.
5. احصل على مفتاح واجهة برمجة التطبيقات من مشروعك الذي تم تفعيل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS فيه.
6. عدِّل الملف 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";

7. في ملف 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.

8. أنشئ المشروع وشغِّله. ستظهر نافذة محاكي iOS تعرض قائمة بالعروض التوضيحية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google".
9. اختَر أحد الخيارات المعروضة لتجربة إحدى ميزات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS.
10. إذا طُلب منك السماح لتطبيق GoogleMapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.