Menghitung rute

Alat compute_routes menampilkan rute antara tempat asal dan tujuan untuk mode perjalanan tertentu. Responsnya mencakup jarak dan durasi rute. Secara default, rute dihitung tanpa lalu lintas live. Pro menambahkan pemilihan rute yang memperhitungkan lalu lintas live dan rute dengan lebih banyak perhentian sementara.

Anda dapat memanggil compute_routes melalui server MCP atau sebagai metode REST computeRoutes. Halaman ini menjelaskan opsi permintaan, termasuk opsi Pro; isi respons; dan cara permintaan ditagih. Untuk skema lengkap, lihat referensi MCP compute_routes dan referensi REST computeRoutes.

Opsi permintaan

Tabel berikut menjelaskan opsi permintaan untuk compute_routes:

Opsi Pro

Dua opsi memilih SKU Maps Grounding Pro. Permintaan yang menggunakan salah satu atau keduanya akan ditagih berdasarkan SKU Pro:

Semua opsi lainnya ditagih berdasarkan SKU Essentials, termasuk mode perjalanan, pengaturan waktu, rute alternatif, polyline, dan bias lokasi.

Pemilihan rute berbasis lalu lintas

Secara default, rute dihitung tanpa kondisi lalu lintas real-time (ROUTING_PREFERENCE_TRAFFIC_UNAWARE). Setelan ini memiliki latensi terendah. Mode ini sesuai untuk permintaan yang tidak terpengaruh atau tidak menerapkan traffic, seperti rute jalan kaki atau perencanaan kasar.

Tetapkan routing_preference ke ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL untuk menghitung rute dan durasinya dengan kondisi lalu lintas saat ini, jika data lalu lintas tersedia. Gunakan alat ini saat pengguna menanyakan durasi perjalanan saat ini. Untuk rute TRANSIT, setelan ini menggunakan data transportasi umum real-time, seperti penundaan dan pembatalan, jika tersedia. Fitur ini tidak didukung untuk rute WALK atau BICYCLE; permintaan tersebut akan menampilkan error INVALID_ARGUMENT. Ini adalah opsi Pro, sehingga permintaan ditagih berdasarkan SKU Pro. Opsi ini juga menambahkan latensi.

Contoh

Permintaan MCP berikut meminta rute mengemudi yang memperhitungkan lalu lintas dengan satu pemberhentian sementara dan polyline yang dienkode. SKU ini ditagih dalam SKU Pro:

{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      "origin": {"address": "Ferry Building, San Francisco, CA"},
      "destination": {"address": "Golden Gate Park, San Francisco, CA"},
      "intermediate_waypoints": [
        {"address": "Palace of Fine Arts, San Francisco, CA"}
      ],
      "travel_mode": "DRIVE",
      "routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
      "include_polyline": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

Contoh berikut mengirimkan permintaan yang sama ke metode REST computeRoutes:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "origin": {"address": "Ferry Building, San Francisco, CA"},
  "destination": {"address": "Golden Gate Park, San Francisco, CA"},
  "intermediateWaypoints": [
    {"address": "Palace of Fine Arts, San Francisco, CA"}
  ],
  "travelMode": "DRIVE",
  "routingPreference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
  "includePolyline": true
}' \
"https://mapstools.googleapis.com/v1:computeRoutes"

Ganti API_KEY dengan kunci API Anda.

Respons

Respons berisi routes[], yang diurutkan dari yang paling direkomendasikan hingga yang paling tidak direkomendasikan. Hanya satu rute yang ditampilkan kecuali jika compute_alternative_routes adalah true. Setiap rute mencakup:

• distanceMeters: Jarak perjalanan rute, dalam meter.
• duration: Waktu yang diperlukan untuk menempuh rute. Dengan ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, durasi memperhitungkan kondisi lalu lintas.
• encodedPolyline: Jalur rute sebagai polyline yang dienkode, jika include_polyline adalah true. Anda dapat menggunakannya untuk menggambar rute di peta dengan Google Maps Platform API lainnya.
• retrievalToken: Token buram yang ditampilkan untuk rute DRIVE (berlaku selama 10 menit) yang dapat Anda teruskan ke search_along_route untuk menemukan tempat di sepanjang rute tersebut tanpa mengirim ulang titik jalan.
• attribution: Atribusi yang harus Anda tampilkan dengan rute. Lihat Persyaratan atribusi.

Penagihan dan kuota

Setiap permintaan compute_routes adalah satu peristiwa yang dapat ditagih:

• Permintaan yang tidak menggunakan opsi Pro akan ditagih berdasarkan SKU Maps Grounding Essentials.
• Permintaan yang menggunakan opsi Pro akan ditagih berdasarkan SKU Maps Grounding Pro. Menggunakan kedua opsi Pro dalam satu permintaan tidak akan mengubah biaya. Untuk mengetahui harga Pro, lihat Membandingkan Essentials, Pro, dan Grounding with Google Maps.

Meminta rute alternatif, polyline, waktu keberangkatan atau kedatangan, atau mode perjalanan yang berbeda tidak akan mengubah SKU.

Kuota compute_routes adalah 300 kueri per menit untuk setiap project, yang digunakan bersama oleh kedua SKU. Untuk mengetahui harga, lihat Tabel harga utama dan Tabel harga India.

Batas

• Permintaan dapat menyertakan maksimal 25 titik jalan perantara; 11 hingga 25 adalah opsi Pro. Permintaan dengan jumlah lebih banyak akan menampilkan error INVALID_ARGUMENT.
• Rute transportasi umum tidak mendukung titik jalan perantara. Permintaan transportasi umum dengan titik jalan perantara akan menampilkan error INVALID_ARGUMENT.
• ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL tidak didukung untuk rute jalan kaki atau bersepeda.
• Untuk rute transportasi umum, waktu keberangkatan dan kedatangan dapat ditetapkan hingga 7 hari ke belakang atau 100 hari ke depan. Untuk mode perjalanan lainnya, waktu tidak boleh di masa lalu dan dapat ditetapkan hingga 365 hari ke depan.
• Koordinat titik jalan harus berada dalam batas geografis yang valid (lintang dari -90 hingga 90, bujur dari -180 hingga 180).
• Alat ini tidak menampilkan langkah belokan demi belokan, segmen, atau detail jalur transportasi umum.