MCP Tools Reference: mapstools.googleapis.com

Alat: compute_routes

Menghitung rute perjalanan antara tempat asal dan tujuan, secara opsional melalui perhentian di antaranya. Menampilkan jarak dan durasi untuk setiap rute.

Persyaratan Input (PENTING):

1. origin dan destination (objek - WAJIB): Masing-masing harus disediakan menggunakan salah satu dari:

   • address (string, misalnya, 'Eiffel Tower, Paris'). Tempat, tempat terkenal, dan bisnis yang diberi nama akan di-resolve secara langsung, jadi JANGAN panggil search_places terlebih dahulu hanya untuk melakukan geocoding pada titik jalan. Sertakan kota, wilayah, atau negara yang disebutkan pengguna.
   • lat_lng (objek, {"latitude": number, "longitude": number}).
   • place_id (string, misalnya, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), misalnya dari search_places.

2. intermediate_waypoints (array objek - OPSIONAL): Maksimal 10 perhentian yang harus dilewati, secara berurutan, antara tempat asal dan tujuan. Format sama seperti origin. Tidak didukung dengan TRANSIT. Hanya sertakan perhentian yang diminta pengguna.

3. travel_mode (enum - OPSIONAL): DRIVE (default), WALK, BICYCLE, atau TRANSIT.

4. Timing (OPSIONAL - tetapkan maksimal SATU): Stempel waktu RFC 3339 dengan offset UTC, misalnya, '2026-09-19T08:00:00-07:00'. Defaultnya adalah berangkat sekarang. Untuk TRANSIT, waktunya dapat ditetapkan hingga 7 hari yang lalu atau hingga 100 hari ke depan. Untuk mode lainnya, waktu dapat ditetapkan hingga 365 hari ke depan dan tidak boleh di masa lalu.

   • departure_time: Gunakan saat pengguna menyebutkan waktu keberangkatan (misalnya, "besok pukul 08.00").
   • arrival_time: Gunakan saat pengguna menyebutkan waktu kedatangan yang diinginkan (misalnya, "tiba di sana pukul 09.00").

5. routing_preference (enum - OPSIONAL):

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (default): mengabaikan lalu lintas langsung, insiden, dan penutupan. Latensi terendah.
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: menggunakan kondisi lalu lintas real-time jika tersedia. Tidak didukung untuk WALK atau BICYCLE. Tetapkan ini HANYA jika pengguna bertanya tentang lalu lintas, kemacetan, atau perkiraan waktu tiba (ETA) yang disesuaikan dengan lalu lintas. Hal ini menimbulkan biaya dan latensi yang lebih tinggi.

6. location_bias (objek - OPSIONAL): {"latitude": number, "longitude": number} digunakan untuk memperjelas nama tempat di alamat titik jalan. Jika nama bersifat ambigu (misalnya, "Springfield") dan pengguna tidak memberikan wilayah, pertahankan nama seperti yang diberikan di address dan tetapkan location_bias ke area yang dimaksud, bukan menebak wilayah.

7. compute_alternative_routes (boolean - OPSIONAL): Tetapkan ke true hanya jika pengguna meminta opsi atau alternatif rute. Defaultnya adalah false, yang hanya menampilkan rute yang direkomendasikan.

8. include_polyline (boolean - OPSIONAL): Setel ke true hanya jika geometri rute (encoded_polyline) diperlukan. Nilai defaultnya adalah false.

Petunjuk untuk Panggilan Alat:

• Jika asal atau tujuan tidak ada, Anda HARUS meminta klarifikasi kepada pengguna sebelum memanggil alat.
• Untuk pertanyaan "Seberapa jauh A dari B?", gunakan B sebagai origin dan A sebagai destination.

Contoh Panggilan Alat: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

Instructions for Response:

• Saat rute alternatif diminta, rute akan diurutkan dari yang paling direkomendasikan hingga yang paling tidak direkomendasikan.
• Jika routes kosong, beri tahu pengguna bahwa tidak ada rute yang ditemukan. Jangan menebak rute.
• Hanya nyatakan fakta yang ditampilkan oleh alat. JANGAN membuat rute belokan demi belokan, jalur transportasi umum, stasiun, peron, atau transfer.
• Output yang di-grounding harus diatribusikan ke sumber menggunakan kolom attribution setiap rute jika tersedia.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP compute_routes.

Skema Input

{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // Union field timing can be only one of the following:
  "departureTime": string,
  "arrivalTime": string
  // End of list of possible types for union field timing.
}

{
  "seconds": string,
  "nanos": integer
}

{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}

{
  "latitude": number,
  "longitude": number
}

Skema Output

{
  "routes": [
    {
      object (Route)
    }
  ]
}

{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  },
  "encodedPolyline": string,
  "retrievalToken": string
}

{
  "seconds": string,
  "nanos": integer
}

{
  "title": string,
  "url": string
}

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim kepada pengguna.

Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:

• readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
• destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan aditif. Default: true.
• idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
• openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌