Ringkasan Compute Routes
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Developer Wilayah Ekonomi Eropa (EEA)
Pengantar
Compute Routes adalah metode di layanan Routes API yang menerima
permintaan HTTPS dan menampilkan rute ideal antara dua lokasi.
Memberikan rute dengan informasi lalu lintas secara real-time untuk transportasi umum, bersepeda, mengemudi,
kendaraan bermotor roda 2, atau berjalan kaki antara beberapa lokasi.
Perlu Matriks Rute? Jika Anda tertarik dengan matriks rute, lihat
Ringkasan Compute Route Matrix.
Migrasi? Jika Anda bermigrasi dari Distance Matrix API (Lama), lihat petunjuk migrasi yang dimulai dengan Alasan bermigrasi ke Routes API.
Alasan menggunakan Compute Routes
Dengan Compute Routes, dengan berbagai detail rute, Anda dapat merutekan kendaraan atau paket sesuai dengan preferensi Anda sekaligus mengoptimalkan biaya dan kualitas.
Apa yang dapat Anda lakukan dengan Compute Routes?
Dengan metode Compute Routes Routes API, Anda dapat
melakukan hal-hal berikut:
Mendapatkan rute untuk berbagai cara perjalanan, dan untuk satu atau
beberapa tujuan:
Mode transportasi: transportasi umum, mengemudi, kendaraan roda dua,
berjalan kaki, atau bersepeda.
Serangkaian titik jalan yang dapat Anda optimalkan untuk urutan perjalanan yang paling
efisien.
Gunakan 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 kendaraan
Sesuaikan opsi rute berdasarkan kebutuhan dan sasaran Anda:
Pilih rute yang hemat bahan bakar atau energi untuk jenis mesin kendaraan Anda:
Diesel, Listrik, Hibrid, Bensin. Untuk mengetahui informasi selengkapnya, lihat
Mendapatkan rute yang ramah lingkungan.
Tetapkan opsi terperinci untuk penghitungan traffic, sehingga Anda dapat membuat
keputusan kompromi kualitas versus latensi. Untuk mengetahui detailnya, lihat
Menentukan cara dan apakah akan menyertakan data traffic.
Tetapkan arah kendaraan (arah perjalanan) dan informasi sisi jalan
untuk titik jalan guna meningkatkan akurasi PWT. Untuk mengetahui detailnya, lihat
Menentukan arah kendaraan dan sisi jalan.
Tentukan lokasi pass-through versus terminal dan lokasi perhentian sementara
yang aman. Untuk mengetahui detailnya, lihat Menetapkan perhentian di sepanjang rute dan
Menetapkan titik yang akan dilalui rute.
Meminta informasi tarif tol, beserta jarak rute dan PWT. Untuk mengetahui detailnya, lihat Menghitung tarif tol untuk rute.
Kontrol latensi dan kualitas 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.
Cara kerja Compute Routes
Metode ComputeRoutes Routes API menerima permintaan POST HTTP dengan
isi permintaan JSON yang berisi detail permintaan. Anda memerlukan asal,
tujuan, 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 kemudian menghitung rute yang diminta, dan menampilkan kolom yang telah Anda
minta.
Resource
Tabel berikut meringkas resource yang tersedia melalui metode Compute Routes Routes API, beserta data yang ditampilkannya.
| Referensi data |
Data yang ditampilkan |
Format pengembalian |
| ComputeRoutes |
Menampilkan rute, segmen, dan langkah untuk rute, dengan rute alternatif,
jika diminta. |
JSON |
Cara menggunakan Compute Routes
Library klien yang tersedia
Untuk mengetahui daftar library klien yang tersedia untuk Compute Routes, lihat Library klien.
Langkah berikutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-06-20 UTC.
[null,null,["Terakhir diperbarui pada 2025-06-20 UTC."],[],[],null,["# Compute Routes Overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n[](/maps/documentation/routes/demo)\n\nIntroduction\n------------\n\nCompute Routes is a method in the Routes API service that accepts\nan HTTPS request and returns the ideal route between two locations.\nProvide directions with real-time traffic for transit, biking, driving,\n2-wheel motorized vehicles, or walking between multiple locations.\n\n**Need Route Matrixes?** If you are interested in a route matrix, see\n[Compute Route Matrix Overview](/maps/documentation/routes/compute-route-matrix-over).\n\n**Migrating?** If you are migrating from the Distance Matrix API (Legacy),\nsee migration instructions starting with\n[Why migrate to the Routes API](/maps/documentation/routes/migrate-routes-why).\n\nWhy use Compute Routes\n----------------------\n\nWith Compute Routes, with a wide\nrange of route details you can route your vehicles or packages according to\nyour preferences while optimizing for cost and quality.\n\nWhat you can do with Compute Routes?\n------------------------------------\n\nWith the Routes API `Compute Routes` method, you can\ndo the following things:\n\n- **Get directions for different ways to travel**, and for a single or\n multiple destinations:\n\n - Modes of transportation: transit, driving, two-wheel vehicles,\n walking, or bicycling.\n\n - A series of waypoints that you can optimize for the most efficient\n order in which to travel to them.\n\n- **Use multiple ways to specify origins, destinations, and waypoints**:\n\n - Text strings. For example: \"Chicago, IL\", \"Darwin, NT, Australia\", \"1800\n Amphitheatre Parkway, Mountain View, CA 94043\", or \"CWF6+FWX Mountain\n View, California\"\n\n - Place IDs\n\n - Latitude and longitude coordinates, optionally with vehicle heading\n\n- **Fine-tune your route options** based on your needs and goals:\n\n - Select fuel or energy-efficient routes for your vehicle's engine type:\n Diesel, Electric, Hybrid, Gas. For more information, see\n [Get an eco-friendly route](/maps/documentation/routes/eco-routes#request_an_eco-friendly_route).\n\n - Set fine-grained options for traffic calculation, letting you make\n quality versus latency trade off decisions. For details, see\n [Specify how and if to include traffic data](/maps/documentation/routes/config_trade_offs).\n\n - Set vehicle heading (direction of travel) and side-of-road information\n for waypoints to increase ETA accuracy. For details, see\n [Specify vehicle heading and side of road](/maps/documentation/routes/location_modifiers).\n\n - Specify pass-through versus terminal locations and safe stopover\n locations. For details, see [Set a stop along a route](/maps/documentation/routes/stop_over) and\n [Set a point for a route to pass through](/maps/documentation/routes/pass-through).\n\n - Request toll information, along with route distance and ETA. For\n details, see\n [Calculate toll fees for a route](/maps/documentation/routes/calculate_toll_fees).\n\n- **Control your latency and quality** by requesting only the data you need\n using a field mask, which helps you avoid unnecessary processing time and\n higher request billing rates. For details, see\n [Choose what information to return](/maps/documentation/routes/choose_fields).\n\nHow Compute Routes works\n------------------------\n\nThe Routes API `ComputeRoutes` method accepts an HTTP POST request with\na JSON request body that contains the request details. Required are an origin,\ndestination, `travelMode`, and a field mask to specify which fields to return. \n\n#### Example\n\n```json\ncurl -X POST -d '{\n \"origin\": {\n \"address\": \"1800 Amphitheatre Parkway, Mountain View, CA 94043\"\n },\n \"destination\": {\n \"address\": \"Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132\"\n },\n \"travelMode\": \"DRIVE\"\n }' \\\n -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \\\n -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \\\n 'https://routes.googleapis.com/directions/v2:computeRoutes'\n```\n\nThe service then calculates the requested route, and returns the fields you've\nrequested.\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoutes API Compute Routes method,\nalong with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|----------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------|\n| [ComputeRoutes](/maps/documentation/routes/compute_route_directions) | Returns routes, legs, and steps for a route, with alternate routes, if requested. | JSON |\n\n\u003cbr /\u003e\n\n### How to use Compute Routes\n\n|---|---------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/routes/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Understand how the Routes API bills** | For information, see [Usage and billing](/maps/documentation/routes/usage-and-billing). |\n| 3 | **Compute a route and review the response** | For more information, see [Get a route](/maps/documentation/routes/compute_route_directions) and [Review the route responses](/maps/documentation/routes/understand-route-response). |\n\n### Available client libraries\n\nFor a list of the available client libraries for\nCompute Routes, see\n[Client libraries](/maps/documentation/routes/client-libraries).\n\nWhat's next\n-----------\n\n- [Get a route](/maps/documentation/routes/compute_route_directions)\n- [Available route options](/maps/documentation/routes/route-opt)\n- [Choose what information to return](/maps/documentation/routes/choose_fields)\n- [Migrate from Directions API (Legacy)](/maps/documentation/routes/migrate-routes)\n- [Migrate from the Routes API preview to GA](/maps/documentation/routes/migrate-routes-preview)"]]
