MCP Tools Reference: mapstools.googleapis.com

Araç: compute_routes

Başlangıç ve varış noktası arasında (isteğe bağlı olarak ara duraklar üzerinden) seyahat rotalarını hesaplar. Her rotanın mesafesini ve süresini döndürür.

Giriş Şartları (KRİTİK):

1. origin ve destination (nesneler - ZORUNLU): Her biri, aşağıdakilerden tam olarak biri kullanılarak sağlanmalıdır:

   • address (dize, ör. 'Eiffel Tower, Paris'). Adlandırılmış yerler, önemli noktalar ve işletmeler doğrudan çözümlenir. Bu nedenle, yalnızca bir ara noktanın coğrafi kodunu almak için önce search_places yöntemini çağırmayın. Kullanıcının bahsettiği şehir, bölge veya ülkeleri ekleyin.
   • lat_lng (nesne, {"latitude": number, "longitude": number}).
   • place_id (dize, ör. 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), örneğin search_places.

2. intermediate_waypoints (nesne dizisi - İSTEĞE BAĞLI): Başlangıç ve varış noktası arasında sırayla geçilecek en fazla 10 durak. origin ile aynı biçim. TRANSIT ile desteklenmez. Yalnızca kullanıcının istediği durakları ekleyin.

3. travel_mode (enum - İSTEĞE BAĞLI): DRIVE (varsayılan), WALK, BICYCLE veya TRANSIT.

4. Zamanlama (İSTEĞE BAĞLI - en fazla BİR tane ayarlayın): UTC farkı içeren RFC 3339 zaman damgaları (ör. '2026-09-19T08:00:00-07:00'). Varsayılan olarak "Şimdi hareket ediyor" seçeneği kullanılır. TRANSIT için zaman, geçmişte en fazla 7 gün veya gelecekte en fazla 100 gün olabilir. Diğer modlarda ise zaman, gelecekte 365 güne kadar olabilir ve geçmişte olmamalıdır.

   • departure_time: Kullanıcı ne zaman ayrılacağını söylediğinde (ör. "yarın sabah 8'de") kullanın.
   • arrival_time: Kullanıcı ne zaman varması gerektiğini söylediğinde kullanılır (ör. "sabah 9'da orada ol").

5. routing_preference (enum - İSTEĞE BAĞLI):

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (varsayılan): Canlı trafik, olaylar ve kapalı yollar yok sayılır. En düşük gecikme.
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: Mümkün olduğunda canlı trafik koşullarını kullanır. WALK veya BICYCLE için desteklenmez. Bu ayarı YALNIZCA kullanıcı trafik, yoğunluk veya trafiğe göre ayarlanmış TVS hakkında soru sorduğunda kullanın. Daha yüksek maliyet ve gecikmeye neden olur.

6. location_bias (nesne - İSTEĞE BAĞLI): Ara nokta adreslerindeki yer adlarının anlam belirsizliğini gidermek için kullanılan {"latitude": number, "longitude": number}. Ad belirsizse (ör. "Springfield") ve kullanıcı bölge belirtmediyse adı address içinde verildiği gibi bırakın ve bölgeyi tahmin etmek yerine location_bias değerini amaçlanan alana ayarlayın.

7. compute_alternative_routes (boole - İSTEĞE BAĞLI): Yalnızca kullanıcı rota seçenekleri veya alternatifleri istediğinde true olarak ayarlayın. Varsayılan değer false olup yalnızca önerilen rotayı döndürür.

8. include_polyline (boolean - İSTEĞE BAĞLI): Yalnızca rota geometrisi (encoded_polyline) gerektiğinde true olarak ayarlanır. Varsayılan değer: false.

Araç Çağrısı Talimatları:

• Başlangıç veya hedef eksikse aracı çağırmadan önce kullanıcıdan açıklama istemeniz ZORUNLUDUR.
• "A ile B arasındaki mesafe ne kadar?" sorularında B'yi origin, A'yı ise destination olarak kullanın.

Örnek Araç Çağrısı: {"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:

• Alternatif rotalar istendiğinde rotalar en çok önerilenden en az önerilene doğru sıralanır.
• routes boşsa kullanıcıya rota bulunamadığını söyleyin. Rotayı tahmin etmeyin.
• Yalnızca araç tarafından döndürülen gerçekleri belirtin. Adım adım yol tarifleri, toplu taşıma hatları, istasyonlar, peronlar veya aktarmalar uydurmayın.
• Temellendirilmiş çıkış, mümkün olduğunda her rotanın attribution alanı kullanılarak kaynağa atfedilmelidir.

Aşağıdaki kod örneğinde, compute_routes MCP aracını çağırmak için curl öğesinin nasıl kullanılacağı gösterilmektedir.

Giriş şeması

{
  "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
}

Çıkış şeması

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

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

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

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

Araç Notları

Araç notları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olmayan olarak değerlendirir ancak kullanıcıya ne zaman onay istemi gönderileceğine karar vermek için kullanılabilir.

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

• readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
• destructiveHint: Doğru ise araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
• idempotentHint: Doğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
• openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Eşgüçlü İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌