يتضمّن مستودع حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS على GitHub عيّنات توضّح استخدام حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS في تطبيقك المتوافق مع نظام التشغيل iOS. يحتوي نموذج التطبيق على رمز لعرض أهم ميزات حزمة SDK، ويمكن استخدامه كنقطة بداية لتطبيقك.
قائمة نماذج حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
في ما يلي نماذج الأنشطة الرئيسية من التطبيق التجريبي، كما يمكنك الاطّلاع عليها مجددًا في الصفحات المرتبطة للرجوع إليها سريعًا. اطّلِع على مجلد نماذج GitHub للحصول على القائمة الكاملة للنماذج المتاحة.
- عرض خريطة أساسية
- عرض نافذة معلومات لعلامة
- إضافة علامة إلى خريطة
- عكس الترميز الجغرافي لموقع جغرافي
- تفعيل إيماءات الخريطة وإيقافها
- معالجة أحداث العلامات
- تفعيل زر "موقعي"
- رسم مضلّعات على خريطة
- رسم خطوط متعددة على خريطة
تشغيل نموذج التطبيق الكامل على الجهاز
يتوفّر تطبيق "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google" لنظام التشغيل iOS كملف أرشيف للتنزيل من GitHub. اتّبِع الخطوات التالية لتثبيت تطبيق "نموذج حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS وتجربته.
- شغِّل
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git
لنسخ مستودع العيّنات إلى دليل محلي. افتح نافذة "محطة طرفية"، وانتقِل إلى الدليل الذي نسخت فيه نموذج الملفات، ثم انتقِل إلى دليل 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
- في Xcode، اضغط على زرّ الترجمة لإنشاء التطبيق باستخدام المخطّط الحالي. يُرسِل عملية الإنشاء خطأً، ويطلب منك إدخال مفتاح واجهة برمجة التطبيقات
في ملف
SDKConstants.swift
لنظام Swift أوSDKDemoAPIKey.h
ملف Objective-C. - إذا لم يكن لديك مفتاح واجهة برمجة تطبيقات بعد، اتّبِع التعليمات لإعداد مشروع على Google Cloud Console والحصول على مفتاح واجهة برمجة تطبيقات. عند ضبط
مفتاح التشفير في Cloud Console، يمكنك
حصر المفتاح بملف تعريف حِزمة
نموذج التطبيق لضمان عدم استخدام المفتاح إلا من خلال تطبيقك. معرّف الحِزمة التلقائي لتطبيق نماذج حِزم تطوير البرامج (SDK) هو
com.example.GoogleMapsDemos
. - عدِّل ملف
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";
- في ملف
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.
- أنشئ المشروع وشغِّله. تظهر نافذة محاكي iOS، وتعرض قائمة بالعروض التوضيحية لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google".
- اختَر أحد الخيارات المعروضة لتجربة إحدى ميزات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.
- إذا طُلب منك السماح لتطبيق GoogleMapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.