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 25 durak. origin ile aynı biçim. TRANSIT ile desteklenmez. Yalnızca kullanıcının istediği durakları ekleyin. 10'dan fazla ara nokta belirtmek daha yüksek maliyete ve daha yüksek gecikmeye neden olur.

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 et" 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 (ör. "saat 09:00'da orada ol") kullanın.

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

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (varsayılan): Canlı trafik, olaylar ve kapalı yollar dikkate alınmaz. 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 ayarlayı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 alanında verildiği gibi bırakın ve bölgeyi tahmin etmek yerine location_bias alanını amaçlanan bölgeye 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 (Boole - İSTEĞE BAĞLI): Yalnızca rota geometrisi (encoded_polyline) gerektiğinde true olarak ayarlayın. Varsayılan değer false'dir.

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

• Başlangıç veya hedef eksikse aracı çağırmadan önce kullanıcıdan açıklama istemeniz ZORUNLUDUR.
• "A, B'den ne kadar uzakta?" sorularında B'yi origin, A'yı 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 etmeye çalışmayın.
• DRIVE rotası üzerindeki yerleri bulmak için rotanın retrieval_token değerini search_along_route değerine iletin. Jeton 10 dakika boyunca geçerlidir.
• Yalnızca aracın döndürdüğü 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.
}

{

  // 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
}

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

Çı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ç ek açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olarak değerlendirmez 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şim kurabilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya olurken bellek aracı açık dünya olmaz.

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