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.
Praktik terbaik penagihan untuk migrasi
Panduan ini berlaku jika penggunaan API Anda cukup tinggi untuk beralih ke harga tingkat kedua. Saat bermigrasi ke versi API yang lebih baru, Anda juga akan ditagih untuk SKU yang berbeda. Untuk menghindari peningkatan biaya selama bulan transisi, sebaiknya beralih ke API baru dalam produksi sedekat mungkin dengan awal bulan. Hal ini akan memastikan bahwa Anda mencapai tingkat harga bulanan yang paling hemat biaya selama bulan migrasi. Untuk informasi tentang tingkat harga, lihat halaman harga dan FAQ harga.
Memperbarui 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 dalam header sebagai bagian dari permintaan HTTP POST. Untuk contoh, lihat:
Mengonversi titik jalan yang dienkode polyline menjadi titik jalan lokasi
Menentukan titik jalan sebagai polyline yang dienkode tersedia di Directions API agar sesuai dengan sejumlah besar titik jalan 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 menggunakan salah satu parameter ini.
Konversi parameter permintaan
| Parameter Rute atau Matriks jarak | Parameter Routes API | Catatan |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Hanya tersedia dalam mode TRANSIT, dan tidak pada waktu
yang sama 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 poligon yang dienkode. |
optimize=true untuk titik jalan |
"optimizeWaypointOrder": "true" |
Pelajari lebih lanjut |
Konversi parameter respons
| Parameter Rute atau Matriks jarak | 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 ditentukan sebagai alamat. |
bounds |
viewport |
|
legs.end_address |
Tidak tersedia. | |
legs.start_address |
Tidak tersedia. | |
overview_polyline |
polyline | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |