تتيح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android لتطبيقات Android عرض خرائط تفاعلية ثلاثية الأبعاد تم إنشاؤها من صور Google الثلاثية الأبعاد. وتوفّر علامات، ونوافذ منبثقة، وخطوطًا متعدّدة، ومضلّعات، ونماذج ثلاثية الأبعاد بتنسيق glTF، وصورًا متحركة لمسار الكاميرا، وعناصر تحكّم لتفاعل المستخدم وحركة الكاميرا.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android: معلومات أساسية
- المنتج: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android
- تُعرف أيضًا باسم: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android
- الفئة: خرائط Google
- النظام الأساسي: Android
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android
- نطاق التوفّر الجغرافي: محدود يختلف مدى التوفّر حسب البلد والمنطقة. يمكنك الاطّلاع على عمود "خرائط Google الثلاثية الأبعاد" (JavaScript وAndroid وiOS) في صفحة تغطية "منصة خرائط Google". (تفاصيل التغطية)
حالات استخدام "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google الثلاثية الأبعاد لأجهزة Android"
استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android في الحالات التالية:
- تحتاج إلى عرض خريطة تفاعلية ثلاثية الأبعاد وواقعية لمواقع جغرافية في العالم الحقيقي في تطبيق Android.
- تحتاج إلى علامات أو نوافذ منبثقة أو خطوط متعدّدة أو مضلّعات أو نماذج glTF ثلاثية الأبعاد موضوعة على خريطة ثلاثية الأبعاد في تطبيق Android.
- تحتاج إلى صور متحركة محدّدة مسبقًا للكاميرا (الانتقال إلى، والتحليق حول) توجّه المستخدمين بين النقاط على خريطة ثلاثية الأبعاد.
- عليك التحكّم في حركات الكاميرا وعناصر التحكّم في واجهة المستخدم التي يمكن للمستخدمين استخدامها على خريطة ثلاثية الأبعاد في تطبيق Android.
لا تستخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android في الحالات التالية:
- أنت بصدد إنشاء تطبيق ويب يحتاج إلى خرائط ثلاثية الأبعاد. استخدِم Maps JavaScript API بدلاً من ذلك.
- أنت بصدد إنشاء تطبيق iOS يحتاج إلى خرائط ثلاثية الأبعاد. يمكنك استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS بدلاً من ذلك.
- تحتاج إلى خريطة شوارع ثنائية الأبعاد عادية جاهزة للإنتاج في تطبيق Android (وضع
ROADMAPفي حزمة تطوير البرامج هذه تجريبي). يمكنك بدلاً من ذلك استخدام حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android: الإعداد
- الخدمة المطلوب تفعيلها:
mapsandroid.googleapis.com - المصادقة: مفتاح واجهة برمجة التطبيقات
- البدء: إعداد حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android
- المرجع: مرجع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android
- الأسعار: استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android والفوترة
- السياسات: سياسات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android
حِزم "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google الثلاثية الأبعاد لأجهزة Android" الرسمية:
- maven:
com.google.android.gms:play-services-maps3d
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android: المنتجات ذات الصلة
- تُستخدم غالبًا مع: حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل Android
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android: الأخطاء الشائعة
- المشكلة: إذا لم يتم تحديد وضع الخريطة عند تحميل الخريطة، يتعذّر تحميل الخريطة. الحلّ: يجب دائمًا ضبط
Map3DMode(SATELLITEأوHYBRIDأوROADMAP) في ملف XML للتنسيق (map3d:mapMode) أو باستخدامsetMapMode/Map3DInitConfig. يُرجى الاطّلاع على /maps/documentation/maps-3d/android-sdk/map-modes. - المشكلة: لا يتم تشغيل متتبِّعات النقرات (النقرات على الخريطة والعلامات) في سلسلة واجهة المستخدم الرئيسية، لذا يتعذّر إجراء تعديلات مباشرة على واجهة المستخدم من المعالج. الحلّ: يمكنك التبديل إلى سلسلة واجهة المستخدم الرئيسية قبل تحديث واجهة المستخدم، على سبيل المثال باستخدام
lifecycleScope.launch(Dispatchers.Main). يُرجى الاطّلاع على /maps/documentation/maps-3d/android-sdk/add-a-marker. - المشكلة: تتم مشاركة حالة الخريطة على مستوى مثيلات
Map3DView، لذا يتم نقل العلامات والعناصر المركّبة وموضع الكاميرا من عرض قديم إلى عرض جديد. الحلّ: يجب إبقاء مثيل واحد نشط منMap3DView، واستدعاءonDestroy()في المثيل القديم ومحو العلامات والعناصر المركّبة يدويًا وإعادة ضبط الكاميرا من خلالGoogleMap3D. يُرجى الاطّلاع على /maps/documentation/maps-3d/android-sdk/add-a-3d-map. - المشكلة: يؤدي النقر على نقطة اهتمام في الخريطة الأساسية تلقائيًا إلى عرض تطبيق واجهة المستخدم المصغّر في "الأماكن"، والذي يتطلّب أيضًا تبعية حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن". الحلّ: أضِف تبعية حزمة تطوير البرامج (SDK) للأماكن على Android، وأرجِع
trueمنonMap3DClickفيOnMap3DClickListenerلإيقاف التطبيق المصغّر التلقائي إذا لم تكن تريده. يُرجى الاطّلاع على /maps/documentation/maps-3d/android-sdk/points-of-interest.
الإجراءات التي تتيح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android تنفيذها
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
- إضافة خريطة تفاعلية ثلاثية الأبعاد وواقعية إلى صفحة ويب
- إضافة علامة إلى خريطة ثلاثية الأبعاد واقعية
- تخصيص علامة على خريطة ثلاثية الأبعاد واقعية
- إضافة تصميم ثلاثي الأبعاد إلى خريطة واقعية ثلاثية الأبعاد
- إضافة خط متعدّد ثلاثي الأبعاد إلى خريطة واقعية ثلاثية الأبعاد
- إضافة مضلّع ثلاثي الأبعاد إلى خريطة ثلاثية الأبعاد واقعية
- الاستجابة لتفاعلات المستخدمين والأحداث على خريطة ثلاثية الأبعاد واقعية
- تخصيص عناصر التحكّم التي تظهر على خريطة ثلاثية الأبعاد واقعية
- التحكّم في مسار الكاميرا والصور المتحركة على خريطة ثلاثية الأبعاد واقعية
- التحكّم في قيود الكاميرا على خريطة ثلاثية الأبعاد واقعية