Referensi cepat Maps 3D SDK for iOS

Maps 3D SDK for iOS memungkinkan Anda membangun pengalaman peta 3D di aplikasi iOS menggunakan gambar 3D Google. Library ini menyediakan API SwiftUI untuk penanda, popover, polyline, poligon, model 3D (glTF), animasi jalur kamera, serta kontrol kamera dan interaksi.

Maps 3D SDK untuk iOS: fakta penting

  • Produk: Maps 3D SDK for iOS
  • Kategori: Maps
  • Platform: iOS
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Maps 3D SDK for iOS

Maps 3D SDK for iOS: kapan harus menggunakannya

Gunakan Maps 3D SDK for iOS jika:

  • Anda memerlukan peta 3D fotorealistik yang interaktif di aplikasi iOS native (SwiftUI).
  • Anda perlu menempatkan penanda, popover, polyline, poligon, atau model 3D glTF di peta 3D di iOS.
  • Anda memerlukan animasi kamera terbang ke atau terbang di sekitar, atau pembatasan kamera, pada peta 3D di iOS.
  • Anda ingin pengguna mengetuk lokasi menarik di peta 3D dan melihat detail tempat melalui widget Places UI Kit bawaan.

Jangan gunakan Maps 3D SDK for iOS jika:

Maps 3D SDK untuk iOS: penyiapan

Paket Maps 3D SDK for iOS resmi:

  • 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)

Maps 3D SDK untuk iOS: kesalahan umum

  • Masalah: Jika tidak ada mode peta yang ditetapkan saat peta dimuat, peta akan gagal dimuat. Perbaikan: Selalu teruskan mode saat membuat Map, misalnya Map(mode: .hybrid). Lihat /maps/documentation/maps-3d/ios-sdk/map-modes.
  • Masalah: Menetapkan kunci API di titik entri aplikasi dan di tampilan peta individual akan menghasilkan error konsol. Perbaikan: Tetapkan Map.apiKey hanya di satu tempat: titik entri aplikasi atau setiap tampilan peta. Lihat /maps/documentation/maps-3d/ios-sdk/setup.
  • Masalah: Camera altitudeMode diabaikan di luar animasi kamera; hanya berlaku untuk flyCameraTo dan flyCameraAround. Perbaikan: Gunakan flyCameraTo atau flyCameraAround saat Anda bergantung pada Camera altitudeMode. Lihat /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • Masalah: Di GoogleMaps3DKit, widget UI Places ditampilkan secara default saat pengguna mengetuk lokasi menarik. Perbaikan: Gunakan placeInformationEnabled(false) atau tampilkan .none dari onPlaceTap(_:) untuk menyembunyikan widget. Lihat /maps/documentation/maps-3d/ios-sdk/points-of-interest.

Yang dapat Anda lakukan dengan Maps 3D SDK for iOS

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.