تضيف حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android بيانات "خرائط Google" وطرق عرض الخرائط والاستجابات لإيماءات الخرائط إلى تطبيقات Android، بما في ذلك تطبيقات Wear OS. يمكنك إضافة علامات ومضلّعات وتراكبات لعرض معلومات حول المواقع الجغرافية على الخريطة ودعم تفاعل المستخدمين، وذلك باستخدام Kotlin أو Java.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: معلومات أساسية
- المنتج: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
- تُعرف أيضًا باسم: Google Maps Android API
- الفئة: خرائط Google
- النظام الأساسي: Android
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
- نطاق التوفّر الجغرافي: على مستوى العالم يمكنك الاطّلاع على صفحة تغطية "منصة خرائط Google". وتتضمّن صفحة الاستخدام والفوترة روابط لقوائم أسعار منفصلة عالمية وأخرى خاصة بالهند. (تفاصيل التغطية)
حالات استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android في الحالات التالية:
- تحتاج إلى خريطة Google تفاعلية ثنائية الأبعاد في تطبيق Android أو Wear OS أصلي.
- تحتاج إلى إضافة علامات أو نوافذ معلومات أو خطوط متعدّدة أو مضلّعات أو تراكبات أرضية أو تراكبات مربّعات إلى خريطة في تطبيق Android.
- تحتاج إلى صور بانوراما في "التجوّل الافتراضي" أو خرائط في "الوضع المبسّط" (صورة نقطية) أو "تصميم الخرائط باستخدام السحابة الإلكترونية" مع أرقام تعريف الخرائط في تطبيق Android.
- يمكنك إنشاء خريطة Android بلغة Kotlin أو Java، بما في ذلك Jetpack Compose من خلال مكتبة Compose لحزمة تطوير برامج "خرائط Google".
لا تستخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android في الحالات التالية:
- تحتاج إلى اتجاهات مفصّلة في تطبيق الخرائط على Android. استخدِم حزمة تطوير البرامج للتنقّل على أجهزة Android بدلاً من ذلك.
- إذا كنت بحاجة إلى خرائط ثلاثية الأبعاد واقعية أو نماذج ثلاثية الأبعاد أو صور متحركة لمسار الكاميرا في تطبيق Android، استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android بدلاً من ذلك.
- إذا كنت بحاجة إلى خريطة في تطبيق iOS أصلي، استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS بدلاً من ذلك.
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android: الإعداد
- الخدمة المطلوب تفعيلها:
maps-android-backend.googleapis.com - المصادقة: مفتاح واجهة برمجة التطبيقات
- تحديد مصدر الاستخدام: يمكنك استدعاء
MapsApiSettings.addInternalUsageAttributionId(context, id)لإضافة معرّف تحديد مصدر الاستخدام إلى أداة الإعداد (متوافق فقط معMapsInitializer.Renderer.LATEST). لإيقاف هذه الميزة، يمكنك حذف الاستدعاء أو تمرير سلسلة فارغة. - البدء: إعداد حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
- المرجع: مرجع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
- الأسعار: استخدام حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android والفوترة
- السياسات: سياسات حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
حزم حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android الرسمية:
- maven:
com.google.android.gms:play-services-maps
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android: المنتجات ذات الصلة
- تُستخدم غالبًا مع: حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل Android
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: الأخطاء الشائعة
- المشكلة: منذ الإصدار 20.0.0 من حزمة تطوير البرامج (SDK)، لم يعُد بيان الحزمة يتضمّن مكتبة
org.apache.http.legacy. قد تتعطّل التطبيقات التي تحمّل أداة عرض الخرائط القديمة عند استخدامjava.lang.NoClassDefFoundError. الحلّ: أضِفداخل علامةفي ملفAndroidManifest.xmlالخاص بالتطبيق. لا تتأثر الأجهزة التي تعمل بالإصدار 25.50.34 من "خدمات Google Play" أو الإصدارات الأحدث. يُرجى الاطّلاع على /maps/documentation/android-sdk/release-notes. - المشكلة: تحتاج العلامات المتقدّمة إلى أداة عرض الخرائط التي تمت ترقيتها. إذا أضفتها إلى تطبيق حالي بدون إعادة إنشائه، سيظل بإمكان التطبيق استخدام العارض القديم. الحلّ: أعِد إنشاء التطبيق باستخدام حزمة تطوير البرامج (SDK) بالإصدار 18.2.0 أو إصدار أحدث ليكون محرّك العرض الذي تمت ترقيته هو المحرّك التلقائي. يُرجى الاطّلاع على /maps/documentation/android-sdk/advanced-markers/start.
- المشكلة: الأجهزة التي لا تستوفي متطلبات العارض (الإصدار 5.0 من Android أو المستوى 21 من واجهة برمجة التطبيقات أو الإصدارات الأحدث، والإصدار 21.39.14 من "خدمات Google Play" أو الإصدارات الأحدث، وتفعيل "متجر Google Play") تعود إلى العارض القديم، وبالتالي لا تتوفّر عليها الميزات التي تحتاج إلى العارض الجديد، مثل "تصميم الخرائط باستخدام السحابة الإلكترونية". الحلّ: يُرجى استدعاء
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)والتحقّق من قيمةMapsInitializer.Rendererالتي تم تمريرها إلىOnMapsSdkInitializedCallback.onMapsSdkInitialized()، أو التحقّق منGoogleMap.getMapCapabilities(). إذا كان الجهاز يستخدمLEGACY، لا تعتمد على ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" أو "العلامات المتقدّمة". يُرجى الاطّلاع على /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback. - المشكلة: تتطلّب حزمة SDK توفُّر "خدمات Google Play" على الجهاز الذي يعمل عليه التطبيق. الحلّ: يمكنك اختياريًا استدعاء عملية التحقّق من توفّر "خدمات Google Play" من تطبيقك. يُرجى الاطّلاع على /maps/documentation/android-sdk/config.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: الميزات القديمة والمتوقّفة نهائيًا
- أداة عرض الخرائط القديمة: تم إيقافها نهائيًا منذ 4 مارس 2024. البديل: أداة عرض الخرائط التي تمت ترقيتها (أحدث إصدار)، وهي الأداة التلقائية منذ الإصدار 18.2.0 من حزمة تطوير البرامج (SDK). المشكلة: لا تتوفّر ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" والتخصيصات المتقدّمة للخطوط المتعدّدة و"العلامات المتقدّمة" في أداة العرض القديمة. يُرجى الاطّلاع على دليل نقل البيانات.
الإجراءات التي تتيح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android تنفيذها
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: التصميم المستند إلى البيانات للحدود
- تغيير نمط الحدود على الخريطة
- الاستجابة لتفاعلات المستخدمين مع الحدود على الخريطة
- إضافة نمط خريطة توزيعات ذات تظليل مساحي إلى خريطة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: التصميم المستند إلى البيانات لمجموعات البيانات
- إنشاء مجموعة بيانات جغرافية مكانية قابلة لإعادة الاستخدام ومتوافقة مع عدّة منصات
- إضافة مجموعة بيانات جغرافية مكانية مخصّصة إلى خريطة
- تغيير نمط ميزات مجموعة البيانات المخصّصة على خريطة
- الاستجابة لتفاعلات المستخدمين مع ميزات مجموعة البيانات المخصّصة على الخريطة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: مجموعات البيانات
- إضافة طبقة KML إلى خريطة ملاحظة: في Maps JavaScript API، تم إيقاف KmlLayer نهائيًا (آخر إصدار متوافق هو 3.65، وسيتم إيقافه نهائيًا في مايو 2027). يُرجى نقل البيانات إلى ميزة "التصميم المستند إلى البيانات" للحدود أو مجموعات البيانات، أو تحميل GeoJSON على طبقة البيانات. ستبقى طبقات KML متاحة على أجهزة Android وiOS من خلال مكتبات خدمات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google".
- إضافة بيانات GeoJSON إلى خريطة
- إضافة طبقة خريطة التمثيل اللوني إلى خريطة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: الخرائط
- يمكنك إضافة خريطة تفاعلية قابلة للتخصيص إلى صفحة ويب أو تطبيق على الأجهزة الجوّالة. ملاحظة: بالنسبة إلى أجهزة 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). - أنشِئ معرّف خريطة قابلاً لإعادة الاستخدام لتخزين إعدادات الخريطة وإعدادات الأنماط.
- الردّ على تفاعلات المستخدمين والأحداث على الخريطة
- تخصيص عناصر التحكّم التي تظهر على الخريطة
- تخصيص الإيماءات للتحكّم في خريطة
- التحكّم في التكبير/التصغير والعرض الشامل على خريطة (كاميرا)
- تغيير نوع الخريطة
- تغيير الألوان في الخريطة
- إضافة طبقة حركة المرور إلى خريطة
- إضافة خريطة إلى تطبيق Wear OS
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android: التعليقات التوضيحية على الخرائط
- إضافة نافذة معلومات إلى خريطة
- أضِف شكلاً أو خطًا إلى خريطة.
- إضافة صورة مركّبة مستندة إلى سطح الخريطة
- إضافة تراكب مربّعات مخصّص إلى خريطة
- إضافة علامة إلى خريطة ملاحظة: لا تتيح حزمة تطوير البرامج (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 للتطبيقات المتوافقة مع Android: أنماط الخرائط
- أنشئ نمط خريطة قابلاً لإعادة الاستخدام ومتوافقًا مع عدّة منصات.
- تغيير نمط الطرق والخطوط المتعدّدة والمضلّعات على الخريطة
- عرض ميزات الخريطة أو إخفاؤها
- تغيير نمط الرموز والتصنيفات النصية على الخريطة
- تطبيق أنماط خرائط مختلفة على مستويات تكبير مختلفة:
- تغيير كثافة الأماكن على الخريطة تجريبية
- تغيير نمط المباني على الخريطة تجريبية
- تغيير نمط المعالم على الخريطة تجريبية
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android: ميزة "التجوّل الافتراضي"
- يمكنك إضافة ميزة "التجوّل الافتراضي" من Google التفاعلية والقابلة للضبط إلى صفحة ويب أو تطبيق على الأجهزة الجوّالة.
- الاستجابة لتفاعلات المستخدمين والأحداث في التجوّل الافتراضي من Google
- تخصيص الإيماءات المتاحة في ميزة "التجوّل الافتراضي" من Google
- تحريك حركات الكاميرا في "التجوّل الافتراضي من Google"