Alasan menggunakan Routes API
Dengan Routes API, Anda bisa mendapatkan rute dan informasi perjalanan yang akurat menggunakan detail transportasi, kondisi lalu lintas dan jalan terbaru, serta preferensi rute:
Jenis dan kemampuan berbagai moda transportasi
Ke arah mana kendaraan yang dilintasi
Sisi jalan untuk pengambilan atau pengantaran
Kondisi lalu lintas dan penutupan jalan
Masalah keselamatan seperti menghindari area berbahaya atau menyediakan area pengambilan yang aman
Menyeimbangkan latensi, kualitas, dan biaya untuk seluruh kebutuhan perutean Anda dengan fitur opsional seperti tarif tol dan metadata perjalanan seperti waktu dan jarak, serta efisiensi bahan bakar
Anda juga dapat menentukan rute yang paling efisien untuk penjadwalan pengiriman, seperti:
Cara terbaik untuk menugaskan satu set pekerja guna mengambil serangkaian paket
Menentukan gudang terbaik untuk mengirim paket ke tujuan akhir mereka
Apa yang dapat Anda lakukan dengan Routes API?
Dengan Routes API, Anda bisa mendapatkan dua kategori utama informasi perutean:
Rute dari lokasi ke satu atau beberapa tujuan
Matriks berisi kemungkinan rute antara banyak lokasi awal dan akhir.
Mendapatkan rute untuk satu atau beberapa tujuan
Dengan metode Compute Routes
Routes API,
Anda dapat menghitung antarlokasi:
Mendapatkan rute untuk berbagai cara untuk bepergian, dan untuk satu atau beberapa tujuan:
Mode transportasi, termasuk transportasi umum, mengemudi, kendaraan roda dua, berjalan, atau bersepeda.
Serangkaian titik jalan yang dapat Anda optimalkan agar urutan perjalanannya paling efisien.
Beberapa cara untuk menentukan asal, tujuan, dan titik jalan:
String teks. Misalnya: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043", atau "CWF6+FWX Mountain View, California"
ID Tempat
Koordinat lintang dan bujur, secara opsional dengan arah tujuan kendaraan
Menyesuaikan opsi rute berdasarkan kebutuhan dan sasaran Anda:
Pilih rute yang hemat bahan bakar atau energi untuk jenis mesin kendaraan Anda: Diesel, Listrik, Hybrid, Gas. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan rute ramah lingkungan.
Tetapkan opsi terperinci untuk penghitungan traffic, sehingga Anda dapat mengambil keputusan kompromi kualitas vs latensi. Untuk detailnya, lihat Menentukan bagaimana dan apakah akan menyertakan data traffic.
Tetapkan arah (arah perjalanan) dan informasi sisi jalan kendaraan untuk titik jalan guna meningkatkan akurasi PWT. Untuk mengetahui detailnya, lihat Menentukan arah dan sisi jalan kendaraan.
Tentukan lokasi pass-through vs terminal dan lokasi persinggahan yang aman. Untuk mengetahui detailnya, lihat Menetapkan perhentian di sepanjang rute dan Menetapkan titik untuk dilewati rute.
Minta informasi tol, beserta jarak rute dan PWT. Untuk detailnya, lihat Menghitung biaya tol untuk rute.
Kontrol latensi dan kualitas Anda dengan hanya meminta data yang Anda perlukan menggunakan mask kolom, yang membantu Anda menghindari waktu pemrosesan yang tidak perlu dan tarif penagihan permintaan yang lebih tinggi. Untuk mengetahui detailnya, lihat Memilih informasi yang akan ditampilkan.
Mendapatkan matriks rute yang memungkinkan
Metode Compute Route Matrix
Routes API menyediakan matriks informasi untuk rute yang direkomendasikan antara beberapa titik awal dan akhir, termasuk jarak serta perkiraan waktu kedatangan, untuk membantu Anda memilih tempat asal dan tujuan terbaik berdasarkan kebutuhan bisnis Anda. Anda dapat meminta jenis data jarak ini:
Jarak untuk mode perjalanan yang dipilih
Jarak dalam kilometer atau mil
Perkiraan waktu tempuh dalam lalu lintas
Dengan data jarak, Anda dapat menentukan cara paling efisien untuk merutekan penumpang, pengiriman, atau pekerja antara beberapa kemungkinan tempat asal dan tujuan.
Anda dapat mengalirkan elemen respons sebelum seluruh matriks dihitung, sehingga menurunkan latensi respons.
Anda dapat menentukan beberapa tempat asal dan tujuan per permintaan sisi server dengan jumlah tempat asal dikali jumlah tujuan hingga 625.
Cara kerja Routes API
Routes API memiliki dua metode: ComputeRoutes
dan
ComputeRouteMatrix
.
ComputeRoutes
Metode ComputeRoutes
Routes API menerima permintaan POST HTTP dengan isi permintaan JSON yang berisi detail permintaan. Wajib adalah origin,
destination, travelMode, dan mask kolom untuk menentukan kolom yang akan ditampilkan.
Contoh
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Layanan ini kemudian menghitung rute yang diminta, dan menampilkan kolom yang Anda minta.
ComputeRouteMatrix
ComputeRouteMatrix
Routes API menerima permintaan POST HTTP dengan isi permintaan JSON yang berisi detail permintaan. Diperlukan setidaknya satu asal, dua atau beberapa tujuan, travelMode, dan mask kolom untuk menentukan kolom mana yang akan ditampilkan.
Contoh
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Respons berisi kemungkinan rute untuk kombinasi semua titik jalan asal dan tujuan.
Referensi
Tabel berikut meringkas resource yang tersedia melalui Routes API beserta data yang ditampilkan.
Resource data | Data yang ditampilkan | Format pengembalian |
---|---|---|
ComputeRoutes | Menampilkan rute, segmen, dan langkah untuk sebuah rute, dengan rute alternatif, jika diminta. | JSON |
ComputeRouteMatrix | Menampilkan array rute dari satu titik jalan asal ke satu titik jalan tujuan. |
Cara menggunakan Routes API
1 | Memulai | Mulailah dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikuti. |
2 | Menghitung rute dan meninjau responsnya | Untuk mengetahui informasi selengkapnya, lihat Mendapatkan rute dan Meninjau respons rute. |
3 | Menghitung matriks rute dan meninjau responsnya | Untuk mengetahui informasi selengkapnya, lihat Mendapatkan matriks rute dan Meninjau respons matriks rute. |
Library klien yang tersedia
Untuk daftar library klien yang tersedia untuk Routes API, lihat Library klien.