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 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. Dengan demikian, Anda akan 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 API REST

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. 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 mengetahui contohnya, lihat:

Mengonversi titik jalan yang dienkode polyline menjadi titik jalan lokasi

Penentuan titik jalan sebagai polyline yang dienkode tersedia di Directions API (Lama) untuk memuat banyak 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. 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 Anda menggunakan salah satu parameter ini.

Konversi parameter permintaan

Parameter Directions atau matriks jarak 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

Diteruskan dalam isi permintaan JSON POST HTTP computeRoutes atau computeRouteMatrix menggunakan nilai RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT, TRUCK, atau BICYCLE untuk computeRoutes), bukan parameter kueri URL GET. Menambahkan dukungan untuk TWO_WHEELER, TRANSIT, dan TRUCK.
region regionCode
traffic_model trafficModel Pelajari lebih lanjut
transit_mode "travelMode": "TRANSIT" Di Directions API (Lama), dalam rute transportasi umum, setiap segmen perjalanan dengan moda transportasi yang sama (misalnya, Jalan Kaki atau Transportasi Umum) dianggap sebagai satu langkah, dan rute individual untuk moda transportasi tersebut berada dalam sublangkah. Sebaliknya, di Routes API, langkah-langkahnya secara konsisten berupa satu petunjuk navigasi di semua jenis perjalanan. Jadi, setiap petunjuk navigasi adalah langkah. Untuk beberapa langkah dalam satu mode transportasi, Routes API menyediakan metadata yang berisi ringkasan langkah-langkah untuk mode transportasi 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 matriks jarak 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. Berisi info respons geocoding hanya untuk titik jalan yang ditentukan sebagai alamat.
bounds viewport
legs.end_address Tidak tersedia.

Gunakan ID tempat, bukan koordinat, untuk pemilihan rute dengan akurasi tinggi. ID Tempat berisi data yang menyesuaikan rute ke titik akses yang benar.

  • Jika Anda memulai dengan alamat: Gunakan Place Autocomplete atau Geocoding API untuk menyelesaikannya menjadi ID tempat.
  • Jika Anda memulai dengan koordinat: Sebaiknya gunakan Telusuri tujuan untuk memberikan lokasi yang lebih bermakna. Mendapatkan alamat dari koordinat saja bisa jadi rumit dan menyebabkan penempatan yang salah. Routes API tidak melakukan geocoding terbalik pada koordinat menjadi alamat.
legs.start_address Tidak tersedia.
overview_polyline polyline
summary description
waypoint_order optimizedIntermediateWaypointIndex