Panduan ini menjelaskan cara memigrasikan aplikasi yang menggunakan Directions API atau Distance Matrix API ke Routes API. Untuk mengetahui detail tentang Routes API, lihat ringkasan produk.
Mengupdate endpoint REST API
Perbarui kode Anda untuk menggunakan endpoint Routes API baru
Dari Directions API
Directions API | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
Dari Distance Matrix API
Distance Matrix API | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
Routes API | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
Mengonversi parameter URL untuk menggunakan isi permintaan HTTPS
Dengan Directions API dan Distance Matrix API, Anda
meneruskan properti konfigurasi sebagai parameter URL ke permintaan HTTP GET
. Misalnya, untuk Directions API:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Dengan Routes API, Anda meneruskan parameter dalam isi permintaan atau di header
sebagai bagian dari permintaan HTTP POST
. Untuk contoh, lihat:
Mengonversi titik jalan yang dienkode polyline menjadi titik jalan lokasi
Penentuan titik jalan sebagai polyline yang dienkode tersedia di Directions API agar sesuai dengan sejumlah besar titik jalan dalam batas URL, yaitu 16.384 karakter. Fitur ini tidak diperlukan di Routes API karena titik jalan dapat ditransmisikan dalam isi permintaan REST atau gRPC sebagai koordinat lintang/bujur. Misalnya, lihat Contoh HTTP dalam dokumen Menghitung matriks rute, atau Menentukan titik jalan perantara dalam dokumen Menentukan titik jalan perantara.
Mengonversi parameter
Tabel berikut mencantumkan parameter dalam Directions API dan Distance Matrix API yang telah diganti namanya atau diubah, atau parameter yang tidak didukung dalam rilis GA. Update kode jika Anda menggunakan salah satu parameter ini.
Konversi parameter permintaan
Parameter Distance matrix atau Directions | Parameter Routes API | Catatan |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Hanya tersedia dalam mode TRANSIT , dan tidak bersamaan
dengan departureTime . |
avoid |
routeModifiers |
|
departure_time |
departureTime |
Tidak dapat digunakan bersamaan dengan arrivalTime . |
language |
languageCode |
Hanya didukung untuk Compute Routes. |
mode |
travelMode |
Menambahkan dukungan untuk |
region |
regionCode |
|
traffic_model |
trafficModel |
Pelajari lebih lanjut |
transit_mode |
"travelMode": "TRANSIT" |
Di Directions API, pada rute transportasi umum, setiap segmen perjalanan dengan moda perjalanan yang sama (misalnya, Berjalan atau Transportasi Umum) dianggap sebagai satu langkah, dan setiap rute untuk moda perjalanan tersebut ada dalam sub-langkah. Sebaliknya, di Routes API, langkah-langkah secara konsisten merupakan satu petunjuk navigasi di semua jenis perjalanan. Jadi setiap instruksi navigasi merupakan satu langkah. Untuk beberapa langkah dalam satu mode perjalanan, Routes API menyediakan metadata yang berisi ringkasan langkah-langkah untuk mode perjalanan tersebut, di `stepsOverview`. Untuk meminta metadata ini, gunakan mask kolom `routes.legs.stepsOverview`. Pelajari lebih lanjut. |
transit_routing_preference |
transitRoutingPreference |
Pelajari lebih lanjut |
units |
Tidak tersedia untuk matriks rute. | |
waypoints |
intermediates |
Menghapus dukungan untuk polyline yang dienkode. |
optimize=true untuk titik jalan |
"optimizeWaypointOrder": "true" |
Pelajari lebih lanjut |
Konversi parameter respons
Parameter Distance matrix atau Directions | Parameter Routes API | Catatan |
---|---|---|
copyrights |
Tidak disertakan dalam respons. Anda harus menyertakan pernyataan berikut saat menampilkan hasil kepada pengguna:
Contoh:
|
|
distance |
distanceMeters |
Jarak hanya tersedia dalam meter. |
duration_in_traffic |
duration |
Dihapus di Routes API, gunakan duration . |
status |
Tidak tersedia. Gunakan kode respons HTTP untuk error yang dilaporkan oleh API. Lihat Menangani error permintaan untuk mengetahui informasi selengkapnya. | |
geocoded_waypoints |
geocoding_results |
Hanya didukung untuk Compute Routes. Berisi info respons geocoding hanya untuk titik jalan yang ditetapkan sebagai alamat. |
bounds |
viewport |
|
legs.end_address |
Tidak tersedia. | |
legs.start_address |
Tidak tersedia. | |
overview_polyline |
polyline | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |