Routes API adalah layanan web dengan dua metode: Compute Routes menampilkan rute antara dua lokasi dengan titik jalan perantara opsional, dan Compute Route Matrix menampilkan jarak dan waktu perjalanan untuk kombinasi asal dan tujuan (hingga 625 elemen rute).
Routes API: fakta penting
- Produk: Routes API
- Juga dikenal sebagai: Routes API v2, Compute Routes, Compute Matriks Rute
- Kategori: Rute
- Platform: Layanan web (REST)
- Berjalan di: Server (kode backend)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Routes API
- Ketersediaan regional: Global. Pemilihan rute kendaraan roda dua, rute ramah lingkungan, dan penghitungan tarif tol hanya tersedia di negara dan kota yang didukung, dan wilayah dependensi dengan kode CLDR-nya sendiri tidak didukung kecuali jika tercantum. Untuk alamat penagihan Wilayah Ekonomi Eropa (EEA), persyaratan EEA di https://developers.google.com/maps/comms/eea/routes melarang penggunaan deskripsi atau langkah rute dengan peta apa pun. (detail cakupan)
Routes API: kapan harus menggunakannya
Gunakan Routes API jika:
- Anda memerlukan rute antara tempat asal dan tujuan, dengan titik jalan perantara opsional, untuk mengemudi, berjalan kaki, bersepeda, kendaraan roda dua, atau transportasi umum.
- Anda memerlukan jarak dan waktu perjalanan untuk banyak pasangan asal-tujuan dalam satu permintaan (hingga 625 elemen).
- Anda memerlukan estimasi tarif tol (kota tertentu), rute ramah lingkungan (wilayah tertentu), polyline yang memperhitungkan lalu lintas, atau pemilihan rute kendaraan besar (ketersediaan terbatas).
- Anda memigrasikan aplikasi server dari Directions API atau Distance Matrix API lama.
Jangan gunakan Routes API jika:
- Anda perlu mengoptimalkan penetapan muatan dan urutan perhentian untuk seluruh armada kendaraan. Gunakan Route Optimization API.
- Anda memerlukan navigasi belokan demi belokan dalam aplikasi di Android yang mengikuti rute yang dihitung. Gunakan Navigation SDK for Android.
- Anda memerlukan navigasi belokan demi belokan dalam aplikasi di iOS yang mengikuti rute yang dihitung. Gunakan Navigation SDK for iOS.
Routes API: penyiapan
- Layanan yang akan diaktifkan:
routes.googleapis.com - Autentikasi: Kunci API, OAuth 2.0, Akun layanan
- Memulai: Menyiapkan Routes API
- Referensi: Referensi Routes API
- Harga: Penggunaan dan penagihan Routes API
- Kebijakan: Kebijakan Routes API
- Catatan rilis: Catatan rilis Routes API
Paket Routes API resmi:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
Routes API: produk terkait
- Menggantikan: Directions API, Distance Matrix API
- Sering digunakan dengan: Navigation SDK for Android, Navigation SDK for iOS, Route Optimization API, Geocoding API, Places API (New)
Routes API: kesalahan umum
- Masalah: Tidak ada daftar default kolom yang ditampilkan; permintaan tanpa mask kolom (header
X-Goog-FieldMaskatau parameter$fields) akan menampilkan error. Perbaikan: Selalu kirim mask kolom yang mencantumkan kolom respons yang Anda perlukan. Lihat /maps/documentation/routes/choose_fields. - Masalah: Menggunakan karakter pengganti mask kolom (
*) dalam produksi akan meningkatkan biaya dan latensi, dan biaya dapat meningkat secara tidak terduga karena fitur lanjutan baru ditambahkan ke respons. Perbaikan: Gunakan*hanya selama pengembangan; dalam produksi, minta hanya kolom yang Anda perlukan. Lihat /maps/documentation/routes/choose_fields. - Masalah: Info tarif tol dan konsumsi bahan bakar tidak ditampilkan hanya dengan menambahkannya ke mask kolom; sejak GA, info tersebut harus diaktifkan secara eksplisit. Perbaikan: Tambahkan array
extraComputations(misalnyaTOLLS,FUEL_CONSUMPTION) ke permintaan selain mask kolom. Lihat /maps/documentation/routes/migrate-routes-preview. - Masalah: Matriks Rute Komputasi mengizinkan 625 elemen, tetapi hanya 100 elemen jika
routingPreferenceadalahTRAFFIC_AWARE_OPTIMAL. Perbaikan: Pertahankan jumlah asal x tujuan pada atau di bawah 100 saat menggunakanTRAFFIC_AWARE_OPTIMAL, atau bagi permintaan. Lihat /maps/documentation/routes/compute_route_matrix.
Yang dapat Anda lakukan dengan Routes API
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
- Menampilkan rute antara dua atau beberapa koordinat lintang/bujur sebagai serangkaian koordinat untuk setiap langkah di sepanjang rute.
- Menampilkan rute antara dua atau beberapa set koordinat lintang/bujur sebagai serangkaian deskripsi manuver untuk langkah-langkah di sepanjang rute.
- Menampilkan jarak antara setiap langkah di sepanjang rute antara dua atau beberapa set koordinat lintang/bujur.
- Menampilkan waktu perjalanan antara setiap langkah di sepanjang rute antara dua atau beberapa set koordinat lintang/bujur.
- Menampilkan polyline yang dienkode di antara setiap langkah di sepanjang rute antara dua atau beberapa set koordinat lintang/bujur.
- Menampilkan jarak untuk rute antara dua atau beberapa set koordinat lintang/bujur.
- Menampilkan waktu perjalanan untuk rute antara dua atau beberapa set koordinat lintang/bujur.
- Menampilkan polyline yang dienkode untuk rute antara dua atau beberapa set koordinat lintang/bujur.
- Menampilkan informasi tarif tol untuk rute antara dua atau beberapa set koordinat lintang/bujur.
- Menentukan mode perjalanan (mengemudi, transportasi umum, berjalan kaki, kendaraan roda dua) untuk permintaan rute. Catatan: Di layanan web Routes API (computeRoutes), teruskan travelMode dalam isi JSON POST HTTP menggunakan RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT, atau TRUCK dengan routeModifiers.vehicleInfo) dan sertakan header X-Goog-FieldMask yang diperlukan, bukan parameter kueri mode GET lama. Di library Routes Maps JavaScript API, teruskan travelMode dan kolom di ComputeRoutesRequest.
- Menentukan perhentian atau titik transit untuk permintaan rute.
- Menentukan cara data lalu lintas digunakan dalam permintaan rute.
- Tentukan fitur yang harus dihindari, seperti jalan raya atau jalan tol, untuk permintaan rute.
- Menetapkan titik jalan di sepanjang rute.
- Menetapkan titik jalan perantara di sepanjang rute.
- Tetapkan titik yang akan dilewati rute.
- Tentukan arah kendaraan dan sisi jalan untuk rute.
- Optimalkan urutan perhentian di rute Anda.
- Menentukan pemilihan rute ramah lingkungan untuk permintaan rute. Pratinjau
- Menentukan jarak yang lebih pendek atau pemilihan rute alternatif untuk permintaan rute. Catatan: Di Routes API, meminta rute referensi jarak yang lebih pendek (SHORTER_DISTANCE) bersifat Eksperimental, sedangkan meminta rute alternatif (computeAlternativeRoutes) bersifat GA.
- Menampilkan jarak untuk matriks rute antara beberapa tempat asal dan tujuan.
- Menampilkan waktu perjalanan untuk matriks rute antara beberapa tempat asal dan tujuan.
- Menampilkan informasi tarif tol untuk matriks rute antara beberapa tempat asal dan tujuan.
- Tentukan mode perjalanan (mengemudi, transportasi umum, jalan kaki, kendaraan roda dua) untuk permintaan matriks rute. Catatan: Di layanan web Routes API (computeRouteMatrix), teruskan travelMode dalam isi JSON POST HTTP menggunakan RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT, atau TRUCK dengan origins[].routeModifiers.vehicleInfo; BICYCLE tidak didukung untuk matriks rute) dan sertakan header X-Goog-FieldMask yang diperlukan. Di library Routes Maps JavaScript API, teruskan travelMode dan kolom di ComputeRouteMatrixRequest.