Bermigrasi dari Directions API atau Distance Matrix API

Panduan ini menjelaskan cara memigrasikan aplikasi yang menggunakan Directions API atau Distance Matrix API untuk menggunakan Routes API. Untuk detail tentang Routes API, lihat produk ringkasan.

Mengupdate endpoint REST API

Perbarui kode Anda untuk menggunakan endpoint Routes API yang 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. Sebagai 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 untuk ukuran jumlah titik jalan dalam batas URL 16384 karakter. Fitur ini tidak dalam Routes API karena titik jalan dapat dikirimkan 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.

Konversi parameter permintaan

Parameter Directions atau Distance matrix Parameter Routes API Catatan
alternatives computeAlternativeRoutes
arrival_time arrivalTime Hanya tersedia dalam mode TRANSIT, dan tidak sama pada waktu 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 TWO_WHEELER dan TRANSIT.

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 kolom Routes API, langkah-langkahnya 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 {i>metadata<i} yang berisi ringkasan langkah-langkah untuk moda perjalanan tersebut, dalam `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 Directions atau Distance matrix Parameter Routes API Catatan
copyrights

Tidak disertakan dalam respons. Anda harus menyertakan hal berikut ketika menampilkan hasilnya 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 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