المرجع السريع لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android

تتيح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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 في الحالات التالية:

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android: الإعداد

حِزم "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google الثلاثية الأبعاد لأجهزة Android" الرسمية:

  • maven: com.google.android.gms:play-services-maps3d

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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 تنفيذها

يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.