Pertanyaan Umum (FAQ)

Fakta Produk

Masalah

Jaringan

Data

Penyesuaian UI

Pemilihan rute

Simulator

Workflows

Fakta Produk

Aplikasi Anda harus menerapkan kotak dialog dengan pemberitahuan Persyaratan Layanan Navigation SDK yang harus disetujui oleh setiap pengemudi. Kotak dialog ini memberikan kesempatan kepada pengemudi untuk menyetujui Persyaratan Layanan. File teks persyaratan disediakan bersama Navigation SDK.
Di Android, gunakan metode NavigationApi.showTermsAndConditionsDialog untuk menampilkan kotak dialog yang berisi istilah tersebut.
Di iOS, panggil GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName.
Bahasa apa pun yang didukung oleh Google Maps Mobile secara otomatis tersedia untuk Navigation SDK. Perangkat memiliki bahasa sistem default dan aplikasi tidak dapat mengubah setelan tersebut; namun, aplikasi memiliki akses ke lebih dari 70 bahasa.

Ya. Di Android, setelah dimulai, LocationListener akan terus berjalan di latar belakang. Aplikasi Anda terus menyesuaikan posisi dan mempertahankan bearing-nya.

Di iOS, untuk terus menerima pembaruan lokasi untuk posisi dan arah di latar belakang, terapkan snap jalan dan tetapkan allowsBackgroundLocationUpdates ke YES.

Ya. Saat rute dibuat atau diubah, RouteChangeListener akan menyediakan polyline.

Tidak, Navigation SDK tidak mengharuskan Google Maps Seluler diinstal di perangkat.
Tidak, Navigation SDK tidak menyediakan fungsi ini untuk saat ini.
Ya. Arah lalu lintas tersedia dan ditampilkan secara default.

Masalah

Di Xcode 12, aplikasi tidak mem-build dengan benar untuk simulator. Bagaimana cara memperbaikinya?

Untuk memperbaiki masalah ini, buka Setelan Build project Xcode Anda, lalu tambahkan arm64 ke Excluded Architectures hanya untuk build "Simulator iOS".

Untuk informasi lebih lanjut, lihat thread StackOverflow berikut.

dSYM tidak dimuat.

Jika GDC tidak dimuat:

  • Pastikan NavSDK diaktifkan di Cloud Console.
  • Jika Nav SDK sudah diinstal, tetapi project Anda tidak menggunakan Nav SDK API, hapus Nav SDK dari biner Anda.

Jaringan

Bagaimana cara Navigation SDK menangani konektivitas yang buruk?
Navigation SDK melakukan pra-cache rute untuk setiap perjalanan. Informasi pra-cache mencakup informasi pemilihan rute selama 15-20 menit, dan alternatif rute jika pengemudi menyimpang dari rute. Navigation SDK memperkirakan posisi menggunakan GPS dan sensor perangkat.
Apakah mode offline tersedia?
Tidak, Navigation SDK tidak menawarkan mode offline saat ini. Namun, SDK menyediakan informasi pra-cache untuk sebuah perjalanan.

Data

Dapatkah saya mengambil semua perhentian/tujuan dalam perjalanan sebelum memulai rute?

Ya. Di Android, untuk mengambil rute untuk sebuah rute, panggil Navigator.getRouteSegments().

Di iOS, panggil GMSNavigator.routeLegs(read).

Apakah panduan rute belokan demi belokan tersedia di awal rute?
Ya. Navigation SDK menyediakan daftar segmen rute. Selain itu, pengemudi dapat menggeser kartu rute di header untuk melihat setiap manuver.
Bagaimana PWT dikomunikasikan kepada pengguna aplikasi?

Di Android, gunakan langkah-langkah berikut untuk memberikan informasi PWT kepada pengguna aplikasi:

  1. Ambil waktu dan jarak untuk semua titik jalan menggunakan Navigator.getTimeAndDistanceList().
  2. Teruskan informasi ini ke aplikasi klien seperti yang saat ini Anda lakukan untuk PWT pengemudi.

Di iOS, gunakan langkah-langkah berikut untuk memberikan informasi PWT kepada pengguna aplikasi:

  1. Ambil segmen dalam perjalanan menggunakan Navigator.getRouteSegments().
  2. Panggil GMSNavigator.timeToNextDestination untuk setiap segmen perjalanan.
  3. Teruskan informasi waktu ke aplikasi klien seperti yang Anda lakukan saat ini untuk PWT pengemudi.
Dapatkah RoadSnappedLocationProvider digunakan untuk mendapatkan lokasi yang di-ikat saat ini oleh pengemudi jika navigasi tidak ada di latar depan?

Ya. Di Android, RoadSnappedLocationProvider berjalan di latar belakang secara default.

Di iOS, agar navigasi tetap berjalan di latar belakang, terapkan pemroses untuk GMSRoadSnappedLocationProviderListener, dan tetapkan properti allowsBackgroundLocationUpdates ke TRUE.

Apakah Navigation SDK mendukung pembatasan wilayah?

Tidak. Dalam konteks navigasi, remainingTimeOrdistanceChangeListener memiliki keunggulan dibandingkan pembatasan wilayah sederhana. Pembatasan wilayah mungkin tidak memperhitungkan geometri jalan, dan mungkin tidak dipusatkan pada titik yang tepat yang dituju oleh pengemudi.

Anda dapat memperkirakan fungsi ini menggunakan remainingTimeOrdistanceChangeListener.

  1. Tetapkan nilai minimum untuk menentukan frekuensi callback.
  2. Periksa jarak yang tersisa ke tujuan.

Misalnya, jika menetapkan nilai minimum ke 100 m, Anda akan menerima callback saat jarak ke tujuan berubah 100 m. Seiring jaraknya berkurang, Anda dapat memperbarui nilai minimum ini ke nilai yang lebih kecil dan menerima callback yang lebih sering. Kemudian, periksa jarak yang tersisa untuk menentukan apakah Anda cukup dekat dengan lokasi penjemputan/penjemputan.

Di iOS, terapkan pemroses GMSNavigatorListener.didUpdateRemainingDistance untuk mengelola jarak antar-notifikasi.

Dapatkah saya menonaktifkan notifikasi saat aplikasi Navigasi berada di latar belakang?

Ya. Di Android, gunakan Navigator.setHeadsUpNotificationEnabled untuk mengontrol notifikasi. Metode ini memiliki argumen boolean. FALSE menonaktifkan notifikasi; TRUE mengaktifkan notifikasi.

Di iOS, nonaktifkan notifikasi latar belakang untuk lokasi yang ditangkap jalan dengan menetapkan GMSRoadSnappedLocationProvider.allowsBackgroundLocationUpdates ke TIDAK.

Untuk menonaktifkan pemrosesan latar belakang bagi notifikasi lokasi lainnya, panggil GMSNavigator.sendsBackgroundNotifications(NO).

Penyesuaian UI

Dapatkah saya memberi kode warna untuk opsi rute terbaik?
Tidak. Coding warna untuk opsi rute tertentu tidak didukung untuk saat ini.
Dapatkah Navigation SDK menampilkan PWT untuk tujuan akhir?

Ya. Di Android, gunakan metode berikut:

  1. Ambil waktu dan jarak untuk semua titik jalan menggunakan Navigator.getTimeAndDistanceList().
  2. Sembunyikan PWT titik jalan saat ini menggunakan NavigationFragment.setEtaCardEnabled(false).
  3. Render PWT tujuan akhir.

Di iOS, gunakan:

  1. Panggil GMSNavigator.routeLegs(read).
  2. Dengan segmen terakhir, panggil GMSNavigator.timeToNextDestination.
  3. Sembunyikan PWT titik jalan saat ini menggunakan MSMapView.settings.navigationFooterEnabled=NO hingga FALSE.
  4. Render PWT tujuan akhir.
Bagaimana cara menyembunyikan pembaruan PWT?

Anda dapat menonaktifkan kartu PWT dengan metode berikut:

  • Di Android, gunakan navigationView.setEtaCardEnabled(false).
  • Di iOS, gunakan GMSMapView.settings.navigationFooterEnabled=NO.
Penyesuaian UI mana yang tersedia untuk kartu header dan footer?

Di Android, Anda menggunakan StylingOptions untuk menetapkan gaya visual latar belakang. Untuk menyembunyikan atau menampilkan header dan footer, gunakan fungsi anggota setHeaderEnabled dan setFooterEnabled dari NavigationFragment.

Di iOS, gunakan GMSMapView.settings.navigationHeaderPrimaryBackgroundColor untuk menetapkan gaya warna latar belakang. Untuk menyembunyikan atau menampilkan header dan footer, gunakan properti navigationFooterEnabled dan navigationHeaderEnabled dari GMSUISettings.

Pemilihan rute

Dapatkah saya memberikan rute tertentu kepada pengemudi atau menghapus rute alternatif?
Tidak. Secara default, beberapa rute disediakan dan rute tercepat memiliki prioritas. Anda dapat memengaruhi rute default dengan menambahkan preferensi, seperti "hindari jalan raya dan jalan tol", ke permintaan Anda. Menambahkan titik jalan juga akan memengaruhi rute.
Dapatkah saya menunjukkan label yang berbeda untuk tujuan selain lokasi tujuan default kepada pengguna aplikasi?

Ya. Di Android, buat Marker dengan judul kustom untuk tujuan dan lintang/bujur. Navigation SDK menampilkan judul kustom dan koordinat di NavigationMap.

Di iOS, Anda dapat membuat dan menampilkan GMSMarker untuk tujuan.

Dapatkah saya menggunakan Navigation SDK untuk melacak penyimpangan dari jalur yang ditentukan?

Ya. Di Android, gunakan Navigator.setRouteChangedListener untuk menerima notifikasi saat ada perubahan rute atau rute baru yang direkomendasikan:

  1. Daftarkan pemroses yang memeriksa posisi perangkat di sepanjang rute menggunakan metode Navigator.setRouteChangedListener.
  2. Tambahkan kode ke pengendali peristiwa callback, onRouteChanged:
    • Kirim pesan berisi informasi jarak dan PWT yang diperbarui kepada pengguna aplikasi.
    • Lacak lokasi perangkat.
    • [opsional] Tambahkan fungsi lain yang diperlukan oleh aplikasi Anda untuk menangani saat pengemudi berada di luar rute yang ditentukan.

Di iOS, gunakan GMSNavigator dan pemrosesnya untuk menerima notifikasi saat rute berubah atau rute baru direkomendasikan:

  1. Pada pengontrol tampilan peta, terapkan protokol GMSNavigatorListener dan protokol GMSRoadSnappedLocationProviderListener.
  2. Implementasikan GMSNavigatorListener.navigatorDidChangeRoute.
  3. Akses rute baru menggunakan properti routeLegs dan currentRouteLeg dari GMSNavigator.
Dapatkah pengemudi keluar dari navigasi tanpa menyelesaikan rute?

Ya. Di Android, panggil metode Navigator.stopGuidance() untuk menghentikan navigasi.

Di iOS, panggil GMSNavigator.clearDestinations.

Simulator

Apakah simulator mendukung perubahan rute?

Ya. Di Android, panggil simulateLocationsAlongNewRoute untuk menyimulasikan perjalanan yang menyertakan perubahan rute. Metode simulateLocationsAlongExistingRoute mengabaikan perubahan pada rute yang ada.

Di iOS, gunakan GMSLocationSimulator.simulateAlongNewRouteToDestinations untuk menyimulasikan perjalanan yang menyertakan perubahan rute. Jika Anda tidak mengantisipasi perubahan rute, Anda dapat menggunakan GMSLocationSimulator.simulateLocationsAlongExistingRoute atau GMSLocationSimulator.simulateAlongNewRouteToDestinations.

Workflows

Bagaimana cara menutup notifikasi setelah menutup aktivitas yang berisi fragmen navigasi?

Notifikasi navigasi tetap terlihat selama navigasi, saat aktivitas ditutup. Saat kendaraan tiba di tujuan, navigasi akan berhenti, dan notifikasi akan menghilang.

Untuk menangani klik pada notifikasi, gunakan Navigator.startGuidance(intent resumeIntent). resume intent diaktifkan saat pengguna aplikasi mengklik notifikasi. Biasanya, Navigator.startguidance(getIntent()) dipanggil dari Aktivitas utama, yang memanggil Aktivitas saat pengguna aplikasi mengklik notifikasi.