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

تتيح لك حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS إنشاء تجارب خرائط ثلاثية الأبعاد في تطبيقات iOS باستخدام صور Google الثلاثية الأبعاد. وتوفّر واجهات برمجة تطبيقات SwiftUI للعلامات والنوافذ المنبثقة والخطوط المتعدّدة والمضلّعات والنماذج الثلاثية الأبعاد (glTF) والصور المتحركة لمسار الكاميرا وعناصر التحكّم في الكاميرا والتفاعل.

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

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

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

  • تحتاج إلى خريطة تفاعلية ثلاثية الأبعاد وواقعية في تطبيق iOS (SwiftUI) أصلي.
  • تحتاج إلى وضع علامات أو نوافذ منبثقة أو خطوط متعدّدة أو مضلّعات أو نماذج ثلاثية الأبعاد بتنسيق glTF على خريطة ثلاثية الأبعاد في نظام التشغيل iOS.
  • تحتاج إلى صور متحركة للكاميرا من نوع "التحليق إلى" أو "التحليق حول"، أو قيود على الكاميرا، على خريطة ثلاثية الأبعاد في iOS.
  • تريد أن ينقر المستخدمون على نقاط الاهتمام في الخريطة الثلاثية الأبعاد والاطّلاع على تفاصيل الأماكن من خلال تطبيق Places UI Kit المصغّر المضمّن.

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

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

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

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

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

  • المشكلة: في حال عدم ضبط وضع الخريطة عند تحميل الخريطة، يتعذّر تحميل الخريطة. الحلّ: يجب دائمًا تمرير وضع عند إنشاء Map، على سبيل المثال Map(mode: .hybrid). يُرجى الاطّلاع على /maps/documentation/maps-3d/ios-sdk/map-modes.
  • المشكلة: يؤدي ضبط مفتاح واجهة برمجة التطبيقات في كلّ من نقطة دخول التطبيق وطرق عرض الخريطة الفردية إلى حدوث خطأ في وحدة التحكّم. الحلّ: اضبط Map.apiKey في مكان واحد فقط: نقطة دخول التطبيق أو كل عرض خريطة. يُرجى الاطّلاع على /maps/documentation/maps-3d/ios-sdk/setup.
  • المشكلة: يتم تجاهل السمة Camera altitudeMode خارج الصور المتحركة للكاميرا، وتنطبق فقط على flyCameraTo وflyCameraAround. الحلّ: استخدِم flyCameraTo أو flyCameraAround عند الاعتماد على Camera altitudeMode. يُرجى الاطّلاع على /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • المشكلة: في GoogleMaps3DKit، تظهر تلقائيًا أداة واجهة مستخدم Places عندما ينقر المستخدم على مكان يثير الاهتمام. الحلّ: استخدِم placeInformationEnabled(false) أو أرجِع .none من onPlaceTap(_:) لإيقاف التطبيق المصغّر. يُرجى الاطّلاع على /maps/documentation/maps-3d/ios-sdk/points-of-interest.

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

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