MCP Tools Reference: mapstools.googleapis.com

Alat: compute_routes

Menghitung rute perjalanan antara tempat asal dan tujuan yang ditentukan. Mode Perjalanan yang Didukung: DRIVE (default), WALK.

Persyaratan Input (KRITIS): Memerlukan asal dan tujuan. Setiap nilai harus diberikan menggunakan salah satu metode berikut, yang disusun bertingkat dalam kolom masing-masing:

  • alamat: (string, misalnya, 'Menara Eiffel, Paris'). Catatan: Makin terperinci atau spesifik alamat input, makin baik hasilnya.

  • lat_lng: (objek, {"latitude": angka, "longitude": angka})

  • place_id: (string, misalnya, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Catatan: ID ini dapat diperoleh dari alat search_places. Kombinasi jenis input apa pun diizinkan (misalnya, asal menurut alamat, tujuan menurut lat_lng). Jika asal atau tujuan tidak ada, Anda HARUS meminta klarifikasi kepada pengguna sebelum mencoba memanggil alat.

Contoh Panggilan Alat: {"origin":{"address":"Menara Eiffel"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

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

Permintaan Curl 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

ComputeRoutesRequest.

ComputeRoutesRequest

Representasi JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
Kolom
origin

object (Waypoint)

Wajib. Titik jalan asal.
destination

object (Waypoint)

Wajib. Titik jalan tujuan.
travelMode

enum (RouteTravelMode)

Opsional. Menentukan moda transportasi.

Waypoint

Representasi JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Kolom
Kolom union location_type. Berbagai cara untuk merepresentasikan lokasi. location_type hanya dapat berupa salah satu dari berikut:
latLng

object (google.type.LatLng)

Titik yang ditentukan menggunakan koordinat geografis.
placeId

string

ID Tempat yang terkait dengan titik jalan.
address

string

Alamat yang dapat dibaca manusia atau plus code. Lihat https://plus.codes untuk mengetahui detailnya.

LatLng

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

Skema Output

ComputeRoutesResponse.

ComputeRoutesResponse

Representasi JSON 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
Kolom
routes[]

object (Route)

Berisi rute antara tempat asal dan tujuan yang diminta. Saat ini hanya satu rute yang ditampilkan.

Rute

Representasi JSON 
{
  "distanceMeters": integer,
  "duration": string
}
Kolom
distanceMeters

integer

Jarak perjalanan rute, dalam meter.
duration

string (Duration format)

Durasi waktu yang diperlukan untuk menavigasi rute.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

Durasi

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/j * 24 j/h * 365,25 h/thn * 10.000 thn
nanos

integer

Pecahan detik bertanda pada resolusi nanodetik rentang waktu. Durasi kurang dari satu detik ditampilkan dengan kolom seconds 0 dan kolom nanos positif atau negatif. Untuk durasi satu detik atau lebih, nilai non-nol untuk kolom nanos harus memiliki tanda yang sama dengan kolom seconds. Harus dari -999.999.999 hingga +999.999.999 inklusif.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌