Pertanyaan Umum (FAQ)

Detail produk

Jaringan dan konektivitas

Data

Penyesuaian UI

Pemilihan rute

Simulator

Workflows

Layanan Mobilitas

Detail produk

Aplikasi Anda harus menerapkan dialog dengan pemberitahuan Persyaratan Layanan Navigation SDK yang harus disetujui oleh setiap pengguna. Dialog ini memberi pengguna kesempatan untuk menyetujui Persyaratan Layanan. File teks persyaratan disediakan bersama Navigation SDK. Gunakan metode NavigationApi.showTermsAndConditionsDialog untuk menampilkan dialog yang berisi persyaratan.
Semua bahasa yang didukung oleh Google Maps Seluler 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. Setelah dimulai, LocationListener akan terus berjalan di latar belakang. Aplikasi Anda akan terus menyesuaikan posisi ke jalan dan mempertahankan arah.

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

Tidak, Navigation SDK tidak mengharuskan Google Maps Seluler diinstal di perangkat.
Tidak, Navigation SDK saat ini tidak menyediakan fitur ini.
Ya. Arah lalu lintas tersedia dan ditampilkan secara default.
Versi JDK mana yang didukung Navigation SDK?
Navigation SDK mendukung versi LTS Java SE yang didukung secara aktif oleh Oracle. Versi ini tercantum sebagai memiliki Dukungan Premier di Roadmap Dukungan Oracle Java SE.

Jaringan dan konektivitas

Bagaimana cara Navigation SDK menangani konektivitas jaringan yang buruk?
Navigation SDK melakukan pra-cache rute untuk setiap perjalanan. Informasi yang di-pra-cache mencakup informasi pemilihan rute selama 15-20 menit, dan alternatif rute jika pengguna menyimpang dari rute. Navigation SDK memperkirakan posisi menggunakan GPS dan sensor perangkat.
Bagaimana cara Navigation SDK menangani sinyal GPS yang buruk atau hilang?

Setelah navigasi dimulai dan Navigation SDK menerima sinyal GPS setidaknya sekali, pesan "Mencari GPS..." akan ditampilkan dalam situasi berikut:

  • Jika lebih dari 10 detik telah berlalu sejak terakhir kali menerima sinyal GPS.
  • Jika posisi pemilihan rute telah berpindah lebih dari 500 m sejak terakhir kali menerima sinyal GPS.

Jika SDK tidak menerima sinyal GPS dalam jangka waktu yang lama, progres di sepanjang rute, yang ditunjukkan di aplikasi oleh posisi tanda panah, dapat melambat hingga berhenti sepenuhnya. Dalam hal ini, tanda panah di peta akan tetap berada di lokasi yang ditunjukkan oleh sinyal GPS terakhir. SDK tidak akan otomatis keluar dari mode navigasi jika tidak menerima sinyal GPS. Namun, perangkat mungkin tidak dapat memberikan panduan hingga menerima sinyal lagi.

Apakah mode offline tersedia?
Tidak, Navigation SDK saat ini tidak menawarkan mode offline; namun, SDK ini menyediakan informasi yang telah di-cache untuk perjalanan.

Data

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

Ya. Untuk mengambil rute, panggil Navigator.getRouteSegments().

Apakah panduan rute belokan demi belokan tersedia di awal rute?
Ya. Navigation SDK menyediakan daftar segmen rute. Selain itu, pengguna dapat menggeser kartu rute di header untuk melihat setiap manuver.
Bagaimana perkiraan waktu kedatangan (ETA) disampaikan kepada pengguna aplikasi?

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 Anda lakukan untuk perkiraan waktu kedatangan pengemudi.
Dapatkah RoadSnappedLocationProvider digunakan untuk mendapatkan lokasi pengguna saat ini yang disesuaikan jika navigasi tidak berada di latar depan?

Ya. RoadSnappedLocationProvider berjalan di latar belakang secara default.

Apakah Navigation SDK mendukung pembatasan wilayah?

Tidak. Dalam konteks navigasi, remainingTimeOrdistanceChangeListener memiliki keunggulan dibandingkan pembatasan wilayah. Pembatasan wilayah mungkin tidak memperhitungkan geometri jalan, dan mungkin tidak berpusat pada titik persis yang dituju pengguna.

Anda dapat memperkirakan fitur ini menggunakan remainingTimeOrdistanceChangeListener.

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

Misalnya, jika Anda menetapkan nilai minimum ke 100 m, Anda akan menerima callback saat jarak ke tujuan berubah sebesar 100 m. Seiring berkurangnya jarak, 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/pengantaran.

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

Ya. Gunakan Navigator.setHeadsUpNotificationEnabled untuk mengontrol notifikasi. Metode ini memiliki argumen boolean. FALSE menonaktifkan notifikasi; TRUE mengaktifkan notifikasi.

Perekam transaksi melacak pengambilan dan pengantaran dengan ID unik, yang dicatat Google untuk tujuan analisis produk. Jika Anda adalah pelanggan Layanan Mobilitas, Google merekomendasikan agar Anda menerapkan NavigationTransactionRecorder untuk mencatat data transaksi Anda.

Penyesuaian UI

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

Ya. Gunakan metode berikut:

  1. Ambil waktu dan jarak untuk semua titik jalan menggunakan Navigator.getTimeAndDistanceList().
  2. Sembunyikan Perkiraan Waktu Kedatangan (ETA) titik jalan saat ini menggunakan NavigationFragment.setEtaCardEnabled(false).
  3. Me-render perkiraan waktu tiba (ETA) tujuan akhir.
Bagaimana cara menyembunyikan info terbaru tentang PWT?

Anda dapat menonaktifkan kartu PWT dengan memanggil navigationView.setEtaCardEnabled(false).

Penyesuaian UI apa yang tersedia untuk kartu header dan footer?

Gunakan StylingOptions untuk menetapkan gaya warna latar belakang. Untuk menyembunyikan atau menampilkan header dan footer, gunakan fungsi anggota setHeaderEnabled dan setFooterEnabled dari NavigationFragment.

Pemilihan rute

Dapatkah saya memberikan rute tertentu kepada pengguna 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 memengaruhi rute.
Dapatkah saya menampilkan label yang berbeda untuk tujuan kepada pengguna aplikasi selain lokasi tujuan default?

Ya. Buat Marker dengan judul kustom untuk tujuan dan lintang/bujur. Navigation SDK menampilkan judul kustom dan koordinat di NavigationMap.

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

Ya. Gunakan Navigator.setRouteChangedListener untuk menerima notifikasi saat rute berubah atau rute baru direkomendasikan:

  1. Daftarkan pemroses yang memeriksa posisi perangkat di sepanjang rute menggunakan metode Navigator.setRouteChangedListener.
  2. Tambahkan kode ke pengendali peristiwa callback, onRouteChanged:
    • Mengirim pesan kepada pengguna aplikasi dengan informasi PWT dan jarak yang diperbarui.
    • Lacak lokasi perangkat.
    • [opsional] Tambahkan fitur lain yang diperlukan oleh aplikasi Anda untuk menangani saat pengguna keluar dari rute yang ditentukan.
Dapatkah pengguna keluar dari navigasi tanpa menyelesaikan rute?

Ya. Panggil metode Navigator.stopGuidance untuk menghentikan navigasi.

Apakah Navigation SDK mendukung pemilihan rute dan navigasi untuk truk dan kendaraan besar?

Ya. Dengan pemilihan rute kendaraan besar (LVR), Anda dapat meneruskan token rute khusus truk yang dihasilkan oleh Routes API atau Route Optimization API ke Navigation SDK. SDK ini menyediakan navigasi belokan demi belokan dengan info rute (pembatasan tinggi, berat, bahan berbahaya, dan truk) serta mempertahankan profil fisik kendaraan selama pengubahan rute dinamis. Untuk mengetahui detailnya, lihat Menavigasi rute kendaraan besar.

Simulator

Apakah simulator mendukung perubahan rute?

Ya. Panggil simulateLocationsAlongNewRoute untuk menyimulasikan perjalanan yang mencakup perubahan rute. Metode simulateLocationsAlongExistingRoute mengabaikan perubahan pada rute yang ada.

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 hilang.

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 kembali Aktivitas saat pengguna aplikasi mengklik notifikasi.

Layanan Mobilitas

Apa perbedaan penggunaan Navigation SDK bagi pelanggan Layanan Mobilitas?

Layanan Mobilitas Google Maps Platform menawarkan kumpulan API dan SDK untuk membantu mendukung kebutuhan perusahaan untuk bisnis transportasi dan logistik. Bagi pelanggan Layanan Mobilitas, Navigation SDK biasanya digunakan bersama dengan layanan terkait untuk pengoptimalan rute, pengiriman, pelacakan tugas, analisis armada, dan lainnya. Navigation SDK juga ditagih secara berbeda untuk pelanggan Layanan Mobilitas. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Layanan Mobilitas.

Produk mobilitas saat ini hanya tersedia untuk pelanggan tertentu. Hubungi sales representative Anda untuk mengetahui informasi selengkapnya.

Bagaimana cara mengetahui apakah saya adalah pelanggan Layanan Mobilitas?
Jika Anda tidak yakin apakah saat ini Anda menerapkan Navigation SDK sebagai pelanggan Layanan Mobilitas, cari panggilan ReportBillableEvent dalam kode Anda. Hanya pelanggan Layanan Mobilitas yang boleh memanggil metode ReportBillableEvent.

Bagaimana penagihan Navigation SDK untuk pelanggan Layanan Mobilitas?
Bagi pelanggan Layanan Mobilitas, penagihan dan harga untuk Navigation SDK bergantung pada perjanjian layanan yang Anda miliki dengan Google Maps Platform. Untuk mengetahui informasi tentang cara memverifikasi bahwa penerapan Layanan Mobilitas Anda ditagih dengan benar, lihat Validasi penagihan. Untuk mengetahui informasi tambahan tentang penagihan Mobility Services, hubungi Sales Rep Anda.

API Navigation SDK mana yang hanya boleh digunakan oleh pelanggan Layanan Mobilitas?

Ada beberapa API di Navigation SDK yang hanya ditujukan untuk digunakan oleh pelanggan Mobility Services, yang ditagih oleh Google per transaksi. Jika Anda bukan pelanggan Layanan Mobilitas, metode berikut tidak akan berfungsi:

Jika saya adalah pelanggan Mobility Services, dapatkah saya juga menggunakan implementasi Navigation SDK non-Mobility Services?

Ya, pelanggan Layanan Mobilitas dapat menggunakan implementasi Navigation SDK untuk Layanan Mobilitas dan non-Layanan Mobilitas. Namun, Anda hanya dapat menggunakan satu jenis penerapan dalam aplikasi pada satu waktu. Anda juga perlu membuat project Google Cloud, akun penagihan, dan kunci API baru, yang terpisah dari yang Anda gunakan dengan implementasi Layanan Mobilitas. Untuk mengetahui informasi selengkapnya, lihat ringkasan penyiapan Navigation SDK.

Untuk mengetahui informasi selengkapnya tentang penggunaan implementasi Navigation SDK non-Layanan Mobilitas, termasuk memigrasikan aplikasi dari satu jenis implementasi ke jenis implementasi lainnya, hubungi perwakilan Akun Google Anda.

Catatan: Jika Anda saat ini bukan pelanggan Layanan Mobilitas dan tertarik untuk mempelajari lebih lanjut koleksi API dan SDK Layanan Mobilitas, hubungi bagian penjualan Google Maps Platform.