MCP Tools Reference: mapstools.googleapis.com

Araç: compute_routes

Belirtilen bir başlangıç noktası ile varış noktası arasındaki seyahat rotasını hesaplar. Desteklenen ulaşım şekilleri: ARABA (varsayılan), YÜRÜME.

Giriş Koşulları (KRİTİK): Hem kalkış hem de varış noktası gerekir. Her biri, ilgili alanın içine yerleştirilmiş olarak aşağıdaki yöntemlerden biri kullanılarak sağlanmalıdır:

  • address: (dize, ör. "Eyfel Kulesi, Paris"). Not: Giriş adresi ne kadar ayrıntılı veya belirli olursa sonuçlar da o kadar iyi olur.

  • lat_lng: (object, {"latitude": number, "longitude": number})

  • place_id: (dize, ör. "ChIJOwE_Id1w5EAR4Q27FkL6T_0") Not: Bu kimlik, search_places aracından alınabilir. Giriş türlerinin herhangi bir kombinasyonuna izin verilir (ör. adresle başlangıç noktası, enlem/boylam ile hedef). Kaynak veya hedef eksikse aracı çağırmadan önce KULLANICIDAN AÇIKLAMA İSTEMENİZ GEREKİR.

Örnek Araç Çağrısı: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

Aşağıdaki örnekte, curl kullanılarak compute_routes MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
                  
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
}'

Giriş Şeması

ComputeRoutesRequest.

ComputeRoutesRequest

JSON gösterimi 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
Alanlar
origin

object (Waypoint)

Zorunlu. Başlangıç ara noktası.
destination

object (Waypoint)

Zorunlu. Hedef ara nokta.
travelMode

enum (RouteTravelMode)

İsteğe bağlıdır. Ulaşım şeklini belirtir.

Ara nokta

JSON gösterimi 
{

  // 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.
}
Alanlar
location_type birleşik alanı. Bir konumu temsil etmenin farklı yolları. location_type aşağıdakilerden yalnızca biri olabilir:
latLng

object (google.type.LatLng)

Coğrafi koordinatlar kullanılarak belirtilen bir nokta.
placeId

string

Ara nokta ile ilişkili yer kimliği.
address

string

Kullanıcı tarafından okunabilir adres veya artı kodu. Ayrıntılar için https://plus.codes adresini ziyaret edin.

LatLng

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.

Çıkış Şeması

ComputeRoutesResponse.

ComputeRoutesResponse

JSON gösterimi 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
Alanlar
routes[]

object (Route)

İstenen başlangıç ve varış noktaları arasındaki rotaları içerir. Şu anda yalnızca bir rota döndürülür.

Rota

JSON gösterimi 
{
  "distanceMeters": integer,
  "duration": string
}
Alanlar
distanceMeters

integer

Rotanın seyahat mesafesi (metre cinsinden).
duration

string (Duration format)

Rotada ilerlemek için gereken süre.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

Süre

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Zaman aralığının imzalı saniye değeri. -315.576.000.000 ile +315.576.000.000 arasında olmalıdır (bu değerler dahil). Not: Bu sınırlar şu şekilde hesaplanır: 60 sn/dk * 60 dk/sa * 24 sa/gün * 365,25 gün/yıl * 10.000 yıl
nanos

integer

Zaman aralığının nanosaniye çözünürlüğünde, saniyenin işaretli kesirleri. Bir saniyeden kısa süreler, 0 seconds alanı ve pozitif veya negatif nanos alanı ile gösterilir. Bir saniye veya daha uzun süreler için nanos alanının sıfır olmayan değeri, seconds alanıyla aynı işarete sahip olmalıdır. -999.999.999 ile +999.999.999 arasında olmalıdır (bu değerler dahil).

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌