Panduan ini menjelaskan cara memigrasikan aplikasi yang menggunakan Directions API atau Distance Matrix API untuk menggunakan 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 berenkode polyline menjadi titik jalan lokasi
Menentukan titik jalan sebagai polyline yang dienkode tersedia di Directions API agar sesuai dengan titik jalan dalam jumlah besar dalam batas URL 16.384 karakter. Fitur ini tidak diperlukan di Routes API karena titik jalan dapat dikirim dalam isi permintaan REST atau gRPC sebagai koordinat lintang/bujur. Misalnya, lihat Contoh HTTP dalam dokumen Menghitung matriks rute, atau Menentukan titik jalan tengah dalam dokumen Menentukan titik jalan tengah.
Mengonversi parameter
Tabel berikut mencantumkan parameter di Directions API dan Distance Matrix API yang telah diganti namanya atau diubah, atau parameter yang tidak didukung dalam rilis GA. Perbarui kode Anda jika Anda menggunakan salah satu parameter ini.
Meminta konversi parameter
Parameter Directions atau Distance matrix | 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 secara 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, dalam rute transportasi umum, setiap segmen perjalanan dengan mode perjalanan yang sama (misalnya, Berjalan Kaki atau Transportasi Umum) dianggap sebagai satu langkah, dan setiap rute untuk mode perjalanan tersebut berada dalam sublangkah. Sebaliknya, di Routes API, langkah-langkah secara konsisten merupakan satu petunjuk navigasi di semua jenis perjalanan. Jadi setiap petunjuk navigasi adalah 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 |
units |
Pelajari lebih lanjut |
waypoints |
intermediates |
Menghapus dukungan untuk polyline yang dienkode. |
optimize=true untuk titik jalan |
"optimizeWaypointOrder": "true" |
Pelajari lebih lanjut |
Konversi parameter respons
Parameter Directions atau Distance matrix | 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. Baca bagian 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 ditentukan sebagai alamat. |
bounds |
viewport |
|
legs.end_address |
Tidak tersedia. | |
legs.start_address |
Tidak tersedia. | |
overview_polyline |
polyline | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |