تتيح لك حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS إضافة خرائط مستندة إلى بيانات "خرائط Google" إلى تطبيقات iOS. تتعامل حزمة SDK مع الوصول إلى خوادم "خرائط Google" وعرض الخريطة والاستجابة للإجراءات التفاعلية من المستخدم، وتتيح لك إضافة علامات وخطوط متعدّدة وأشكال مركّبة على الأرض ونوافذ معلومات إلى الخريطة.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: معلومات أساسية
- المنتج: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- تُعرف أيضًا باسم: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- الفئة: خرائط Google
- النظام الأساسي: iOS
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- نطاق التوفّر الجغرافي: على مستوى العالم يمكنك الاطّلاع على صفحة تغطية "منصة خرائط Google". وتتضمّن صفحة الاستخدام والفوترة روابط لقوائم أسعار منفصلة عالمية وأخرى خاصة بالهند. (تفاصيل التغطية)
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: حالات الاستخدام
استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS في الحالات التالية:
- أنت بحاجة إلى خريطة Google تفاعلية مع معالجة الإيماءات داخل تطبيق iOS أصلي.
- تحتاج إلى إضافة علامات أو خطوط متعدّدة أو تراكبات أرضية أو نوافذ معلومات إلى خريطة في تطبيق iOS.
- تحتاج إلى عرض صور بانوراما في "التجوّل الافتراضي" داخل تطبيق iOS.
- تحتاج إلى عكس الترميز الجغرافي للإحداثيات إلى عناوين من تطبيق iOS يعرض خريطة.
لا تستخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS في الحالات التالية:
- تحتاج إلى خرائط ثلاثية الأبعاد واقعية في تطبيق iOS. استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS بدلاً من ذلك.
- إذا كنت تحتاج فقط إلى فتح موقع جغرافي أو اتجاهات في تطبيق "خرائط Google" بدلاً من عرض خريطة في تطبيقك، استخدِم عناوين URL في "خرائط Google" بدلاً من ذلك.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: الإعداد
- الخدمة المطلوب تفعيلها:
maps-ios-backend.googleapis.com - المصادقة: مفتاح واجهة برمجة التطبيقات
- تحديد مصدر الاستخدام: يمكنك استدعاء طريقة الفئة
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) لإضافة معرّف تحديد مصدر الاستخدام إلى دالة الإعداد. لإيقاف الميزة، احذف الطلب أو أدخِل سلسلة فارغة. - البدء: إعداد حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- المرجع: مرجع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- الأسعار: استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS والفوترة
- السياسات: سياسات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
حِزم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS الرسمية:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: المنتجات ذات الصلة
- تُستخدم غالبًا مع: Geocoding API وPlaces SDK for iOS
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: الأخطاء الشائعة
- المشكلة: لا تتيح حزمة SDK استخدام ميزة "المكتبات القابلة للدمج" (Mergeable Libraries)، ويؤدي تفعيل ميزة "إنشاء مكتبة قابلة للدمج" (Build Mergeable Library) في Xcode إلى حدوث أخطاء في الربط في إصدارات التطبيق النهائية. الحلّ: يجب إبقاء الإعداد "إنشاء مكتبة قابلة للدمج" (Build Mergeable Library) على "لا" (No) (الإعداد التلقائي). يُرجى الاطّلاع على /maps/documentation/ios-sdk/config.
- المشكلة: في حال عدم توفّر إدخالات
LSApplicationQueriesSchemes، يؤدي النقر على شعار Google على الخريطة إلى تسجيل حالات فشل-canOpenURLلكل منcomgooglemaps://وgooglechromes://. الحلّ: أضِفgooglechromesوcomgooglemapsإلىLSApplicationQueriesSchemesفيInfo.plist. يُرجى الاطّلاع على /maps/documentation/ios-sdk/config. - المشكلة: من غير المرجّح أن يعمل استخدام حزمة تطوير البرامج (SDK) داخل إضافات تطبيقات iOS (على سبيل المثال، لوحة مفاتيح مخصّصة) بسبب القيود الصارمة المفروضة على الذاكرة. الحلّ: استخدِم حزمة SDK في التطبيق الرئيسي، وليس في إضافات التطبيق. يُرجى الاطّلاع على /maps/documentation/ios-sdk/overview.
- المشكلة: حزمة SDK غير محسَّنة للنوافذ المتعددة أو النُسخ المتزامنة في iPadOS 13 والإصدارات الأحدث، وقد تُظهر سلوكًا غير محدّد. الحلّ: اختبِر سيناريوهات النوافذ المتعدّدة على أجهزة iPad بعناية أو تجنَّب استخدام مثيلات متعدّدة من الخريطة في الوقت نفسه. يُرجى الاطّلاع على /maps/documentation/ios-sdk/overview.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: الميزات القديمة والمتوقّفة نهائيًا
- أداة عرض OpenGL و
setMetalRendererEnabled: تم إيقافها نهائيًا منذ 19-05-2025. البديل: محرّك العرض Metal (التلقائي منذ الإصدار 8.0.0)، وإزالةsetMetalRendererEnabled. المشكلة: تم إيقاف هذه الميزة نهائيًا في الإصدار 9.0.0 (28 مايو 2024) وتمت إزالتها في الإصدار 10.0.0، ولم يعُدGMSServicesيعرضsetMetalRendererEnabled:. - وحدة
GoogleMapsM4B: تم إيقافها نهائيًا منذ 19-05-2025. البديل: يجب إزالة إطار العمل أو مجموعة الإعداداتGoogleMapsM4Bلأنّها مرتبطة بخطة فوترة قديمة. المشكلة: تم إيقاف هذه الميزة نهائيًا في 20 فبراير 2024، وتمت إزالتها من حزمة Swift في الإصدار 9.0.0 ومن حزمة SDK في الإصدار 10.0.0. - توزيع CocoaPods: تم إيقافه نهائيًا منذ 06/08/2026. البديل: Swift Package Manager. المؤشر: وضع الصيانة منذ 18 أغسطس 2025، وتم إيقافه نهائيًا اعتبارًا من الإصدار 11.0.0. يُرجى الاطّلاع على دليل نقل البيانات.
- تثبيت Carthage: تم إيقافه نهائيًا منذ 27 حزيران (يونيو) 2022. البديل: Swift Package Manager. المشكلة: لا يتوافق Carthage مع المكتبات التي تستهدف الإصدار 13 من iOS والإصدارات الأحدث، وأحدث إصدار متاح من خلال Carthage هو 6.2.1. يُرجى الاطّلاع على دليل نقل البيانات.
الإجراءات التي يمكنك تنفيذها باستخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: تصميم مستند إلى البيانات للحدود
- تغيير نمط الحدود على الخريطة
- الاستجابة لتفاعلات المستخدمين مع الحدود على الخريطة
- إضافة نمط خريطة توزيعات ذات تظليل مساحي إلى خريطة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: التصميم المستند إلى البيانات لمجموعات البيانات
- إنشاء مجموعة بيانات جغرافية مكانية قابلة لإعادة الاستخدام ومتوافقة مع عدّة منصات
- إضافة مجموعة بيانات جغرافية مكانية مخصّصة إلى خريطة
- تغيير نمط ميزات مجموعة البيانات المخصّصة على خريطة
- الاستجابة لتفاعلات المستخدمين مع ميزات مجموعة البيانات المخصّصة على الخريطة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: مجموعات البيانات
- إضافة طبقة KML إلى خريطة ملاحظة: في Maps JavaScript API، تم إيقاف KmlLayer نهائيًا (آخر إصدار متوافق هو 3.65، وسيتم إيقافه نهائيًا في مايو 2027). يُرجى نقل البيانات إلى ميزة "التصميم المستند إلى البيانات" للحدود أو مجموعات البيانات، أو تحميل GeoJSON على طبقة البيانات. ستبقى طبقات KML متاحة على أجهزة Android وiOS من خلال مكتبات خدمات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google".
- إضافة بيانات GeoJSON إلى خريطة
- إضافة طبقة خريطة التمثيل اللوني إلى خريطة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: الترميز الجغرافي
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: الخرائط
- يمكنك إضافة خريطة تفاعلية قابلة للتخصيص إلى صفحة ويب أو تطبيق على الأجهزة الجوّالة. ملاحظة: بالنسبة إلى أجهزة Android: يمكنك ضبط
فيAndroidManifest.xmlباستخدام المكوّن الإضافي Secrets Gradle أوmanifestPlaceholders["MAPS_API_KEY"]فيapp/build.gradle.kts. يجب عدم ترميزYOUR_GOOGLE_MAPS_API_KEYبشكل ثابت فيAndroidManifest.xml، وعدم استبدالGoogleMap(أو maps-composeGoogleMap) بلوحة عرض نموذجية بلا إنترنت أو Leaflet WebView في حال ظهورE/Google Maps Android API: Authorization failure. اطلب من المستخدم تقديمMAPS_API_KEYمن خلال Secrets وتفعيل "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android" (أو حزمة تطوير البرامج للتنقّل عند استخدام NavigationView أو SupportNavigationFragment). - أنشِئ معرّف خريطة قابلاً لإعادة الاستخدام لتخزين إعدادات الخريطة وإعدادات الأنماط.
- الردّ على تفاعلات المستخدمين والأحداث على الخريطة
- تخصيص عناصر التحكّم التي تظهر على الخريطة
- تخصيص الإيماءات للتحكّم في خريطة
- التحكّم في التكبير/التصغير والعرض الشامل على خريطة (كاميرا)
- تغيير نوع الخريطة
- تغيير الألوان في الخريطة
- إضافة طبقة حركة المرور إلى خريطة
- أنشئ شجرة رباعية للبحث عن نقاط ضمن منطقة محدّدة.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: التعليقات التوضيحية على الخرائط
- إضافة نافذة معلومات إلى خريطة
- أضِف شكلاً أو خطًا إلى خريطة.
- إضافة صورة مركّبة مستندة إلى سطح الخريطة
- إضافة تراكب مربّعات مخصّص إلى خريطة
- إضافة علامة إلى خريطة ملاحظة: لا تتيح حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android استخدام AdvancedMarkerOptions. عند استخدام حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android، أضِف علامات باستخدام GoogleMap.addMarker(MarkerOptions).
- تخصيص علامة على خريطة ملاحظة: لا تتيح حزمة تطوير البرامج للتنقّل على أجهزة Android استخدام AdvancedMarkerOptions. عند استخدام حزمة تطوير البرامج للتنقّل على أجهزة Android، يمكنك تخصيص محدّدات المواقع باستخدام MarkerOptions.
- الاستجابة لتفاعلات المستخدمين مع العلامات على الخريطة
- تحديد ما إذا كانت الإحداثيات تقع داخل مضلّع أو منطقة دائرية على الخريطة ملاحظة: على أجهزة Android، استخدِم PolyUtil.containsLocation في مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android للمضلّعات. بالنسبة إلى المناطق الدائرية، تحقَّق مما إذا كانت المسافة الكروية من مركز الدائرة تقع ضمن نصف القطر (على سبيل المثال، computeDistanceBetween في Maps JavaScript API أو SphericalUtil.computeDistanceBetween على Android أو GMSGeometryDistance على iOS).
- احتساب المسافة الكروية أو المساحة أو الاتجاه بين الإحداثيات على الخريطة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: أنماط الخرائط
- أنشئ نمط خريطة قابلاً لإعادة الاستخدام ومتوافقًا مع عدّة منصات.
- تغيير نمط الطرق والخطوط المتعدّدة والمضلّعات على الخريطة
- عرض ميزات الخريطة أو إخفاؤها
- تغيير نمط الرموز والتصنيفات النصية على الخريطة
- تطبيق أنماط خرائط مختلفة على مستويات تكبير مختلفة:
- تغيير كثافة الأماكن على الخريطة تجريبية
- تغيير نمط المباني على الخريطة تجريبية
- تغيير نمط المعالم على الخريطة تجريبية
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS: ميزة "التجوّل الافتراضي"
- يمكنك إضافة ميزة "التجوّل الافتراضي" من Google التفاعلية والقابلة للضبط إلى صفحة ويب أو تطبيق على الأجهزة الجوّالة.
- إضافة محدّد موقع أو تراكب إلى التجوّل الافتراضي من Google.
- الاستجابة لتفاعلات المستخدمين والأحداث في التجوّل الافتراضي من Google
- تخصيص الإيماءات المتاحة في ميزة "التجوّل الافتراضي" من Google
- تحريك حركات الكاميرا في "التجوّل الافتراضي من Google"