Bermigrasi dari Directions API (Lama) atau Distance Matrix API (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Panduan ini menjelaskan cara memigrasikan aplikasi yang menggunakan Directions API atau Distance Matrix API ke penggunaan 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 beralihlah ke API baru dalam produksi sedekat mungkin dengan awal bulan. Hal ini akan memastikan Anda mencapai tingkat harga bulanan yang paling hemat biaya selama bulan migrasi. Untuk mengetahui informasi tentang tingkat harga, lihat halaman harga dan FAQ harga.

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

Menentukan titik jalan sebagai polyline yang dienkode tersedia di Directions API (Legacy) agar sesuai dengan batas URL 16.384 karakter. Fitur ini tidak diperlukan di Routes API karena titik jalan dapat dikirimkan dalam isi permintaan REST atau gRPC sebagai koordinat lintang/bujur. Untuk contoh, 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 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 matriks Jarak atau Rute	Parameter Routes API	Catatan
`alternatives`	`computeAlternativeRoutes`
`arrival_time`	`arrivalTime`	Hanya tersedia dalam mode `TRANSIT` saja, dan tidak pada waktu yang sama dengan `departureTime`.
`avoid`	`routeModifiers`
`departure_time`	`departureTime`	Tidak dapat digunakan pada waktu yang sama dengan `arrivalTime`.
`language`	`languageCode`	Hanya didukung untuk Compute Routes.
`mode`	`travelMode`	Menambahkan dukungan untuk `TWO_WHEELER` dan `TRANSIT`.
`region`	`regionCode`
`traffic_model`	`trafficModel`	Pelajari lebih lanjut
`transit_mode`	`"travelMode": "TRANSIT"`	Di Directions API (Legacy), dalam rute transportasi umum, setiap segmen perjalanan dengan mode perjalanan yang sama (misalnya, Berjalan atau Transportasi Umum) dianggap sebagai satu langkah, dan petunjuk individual untuk mode perjalanan tersebut berada di sublangkah. Sebaliknya, di Routes API, langkah-langkahnya secara konsisten merupakan satu petunjuk navigasi di semua jenis perjalanan. Jadi, setiap petunjuk navigasi adalah sebuah 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 `routes.legs.stepsOverview` mask kolom. Pelajari lebih lanjut.
`transit_routing_preference`	`transitRoutingPreference`	Pelajari lebih lanjut
`units`	`units`	Pelajari lebih lanjut
`waypoints`	`intermediates`	Dukungan untuk polyline yang dienkode dihapus.
`optimize=true` untuk titik jalan	`"optimizeWaypointOrder": "true"`	Pelajari lebih lanjut

Konversi parameter respons

Parameter matriks Jarak atau Rute	Parameter Routes API	Catatan
`copyrights`		Tidak disertakan dalam respons. Anda harus menyertakan pernyataan berikut saat menampilkan hasil kepada pengguna: `Powered by Google, ©YEAR Google` Contoh: `Powered by Google, ©2022 Google`
`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. Hanya berisi info respons geocoding untuk titik jalan yang ditentukan sebagai alamat.
`bounds`	`viewport`
`legs.end_address`	Tidak tersedia.	Gunakan ID tempat bukan koordinat untuk perutean akurasi tinggi. ID tempat berisi data yang mengarahkan rute ke titik akses yang benar. Jika Anda memulai dengan alamat: Gunakan Place Autocomplete atau Geocoding API untuk menyelesaikannya ke ID tempat. Jika Anda memulai dengan koordinat: Pertimbangkan untuk menggunakan Penelusuran tujuan untuk memberikan lokasi yang lebih bermakna. Mendapatkan alamat dari koordinat saja bisa jadi rumit dan menyebabkan pengarahan yang salah. Routes API tidak melakukan geocoding terbalik koordinat menjadi alamat.
`legs.start_address`	Tidak tersedia.
`overview_polyline`	polyline
`summary`	`description`
`waypoint_order`	`optimizedIntermediateWaypointIndex`