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

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

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

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

قائمة نماذج "حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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، واضغط على Enter لجلب الحزمة، ثم انقر على إضافة حزمة.
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 بالوصول إلى موقعك الجغرافي، اختَر السماح.