MCP Tools Reference: mapstools.googleapis.com

เครื่องมือ: compute_routes

คำนวณเส้นทางการเดินทางระหว่างต้นทางและปลายทาง โดยอาจผ่านจุดแวะพักระหว่างทาง แสดงระยะทางและระยะเวลาของแต่ละเส้นทาง

ข้อกำหนดในการป้อนข้อมูล (สำคัญ):

1. origin และ destination (ออบเจ็กต์ - บังคับ): ต้องระบุแต่ละรายการโดยใช้รายการใดรายการหนึ่งต่อไปนี้เท่านั้น

   • address (สตริง เช่น 'Eiffel Tower, Paris') ระบบจะแก้ไขชื่อสถานที่ จุดสังเกต และธุรกิจโดยตรง ดังนั้นอย่าเรียกใช้ search_places ก่อนเพียงเพื่อเข้ารหัสพิกัดภูมิศาสตร์ของจุดอ้างอิง ระบุเมือง ภูมิภาค หรือประเทศที่ผู้ใช้พูดถึง
   • lat_lng (ออบเจ็กต์, {"latitude": number, "longitude": number})
   • place_id (สตริง เช่น 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') เช่น จาก search_places

2. intermediate_waypoints (อาร์เรย์ของออบเจ็กต์ - ไม่บังคับ): จุดแวะพักสูงสุด 10 จุดที่ต้องผ่านตามลำดับระหว่างต้นทางและปลายทาง รูปแบบเดียวกับ origin ไม่รองรับ TRANSIT รวมเฉพาะจุดแวะพักที่ผู้ใช้ขอเท่านั้น

3. travel_mode (enum - ไม่บังคับ): DRIVE (ค่าเริ่มต้น), WALK, BICYCLE หรือ TRANSIT

4. เวลา (ไม่บังคับ - ตั้งค่าได้ไม่เกิน 1 รายการ): การประทับเวลา RFC 3339 ที่มีการชดเชยเวลา UTC เช่น '2026-09-19T08:00:00-07:00' ค่าเริ่มต้นคือออกเดินทางตอนนี้ สำหรับ TRANSIT เวลาอาจเป็นอดีตได้สูงสุด 7 วันหรืออนาคตได้สูงสุด 100 วัน สำหรับโหมดอื่นๆ เวลาอาจเป็นเวลาในอนาคตได้สูงสุด 365 วัน และต้องไม่เป็นเวลาในอดีต

   • departure_time: ใช้เมื่อผู้ใช้ระบุเวลาที่จะออก (เช่น "พรุ่งนี้ตอน 8 โมงเช้า")
   • arrival_time: ใช้เมื่อผู้ใช้ระบุเวลาที่ต้องไปถึง (เช่น "ไปถึงที่นั่นภายใน 9:00 น.")

5. routing_preference (enum - ไม่บังคับ):

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (ค่าเริ่มต้น): ไม่สนใจสภาพการจราจรแบบเรียลไทม์ เหตุการณ์ และการปิดถนน เวลาในการตอบสนองต่ำที่สุด
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: ใช้สภาพการจราจรแบบเรียลไทม์เมื่อพร้อมใช้งาน ไม่รองรับ WALK หรือ BICYCLE ตั้งค่านี้เมื่อผู้ใช้ถามเกี่ยวกับการจราจร ความแออัด หรือ ETA ที่ปรับตามการจราจรเท่านั้น ซึ่งทำให้มีค่าใช้จ่ายและเวลาในการตอบสนองสูงขึ้น

6. location_bias (ออบเจ็กต์ - ไม่บังคับ): {"latitude": number, "longitude": number} ใช้เพื่อแก้ความกำกวมของชื่อสถานที่ในที่อยู่จุดอ้างอิง หากชื่อมีความกำกวม (เช่น "Springfield") และผู้ใช้ไม่ได้ระบุภูมิภาค ให้คงชื่อตามที่ระบุไว้ใน address และตั้งค่า location_bias ไปยังพื้นที่ที่ต้องการแทนการเดาภูมิภาค

7. compute_alternative_routes (บูลีน - ไม่บังคับ): ตั้งค่าเป็น true เฉพาะเมื่อผู้ใช้ขอตัวเลือกเส้นทางหรือทางเลือกอื่น ค่าเริ่มต้นคือ false ซึ่งจะแสดงเฉพาะเส้นทางที่แนะนำ

8. include_polyline (บูลีน - ไม่บังคับ): ตั้งค่าเป็น true เฉพาะเมื่อจำเป็นต้องใช้เรขาคณิตของเส้นทาง (encoded_polyline) ค่าเริ่มต้นคือ false

วิธีการเรียกใช้เครื่องมือ

• หากไม่มีต้นทางหรือปลายทาง คุณต้องขอให้ผู้ใช้ชี้แจงก่อนเรียกใช้เครื่องมือ
• สำหรับคำถาม "A อยู่ห่างจาก B เท่าใด" ให้ใช้ B เป็น origin และ A เป็น destination

ตัวอย่างการเรียกใช้เครื่องมือ: {"origin":{"address":"หอไอเฟล"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"พิพิธภัณฑ์ลูฟวร์"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

วิธีการตอบกลับ

• เมื่อมีการขอเส้นทางอื่น ระบบจะจัดเรียงเส้นทางจากเส้นทางที่แนะนำมากที่สุดไปจนถึงน้อยที่สุด
• หาก routes ว่างเปล่า ให้แจ้งผู้ใช้ว่าไม่พบเส้นทาง อย่าเดาเส้นทาง
• ระบุเฉพาะข้อเท็จจริงที่เครื่องมือแสดงผลเท่านั้น อย่าสร้างเส้นทางแบบเลี้ยวต่อเลี้ยว สายขนส่งสาธารณะ สถานี ชานชาลา หรือการเปลี่ยนสายขึ้นมาเอง
• เอาต์พุตที่มีการตรวจสอบข้อมูลจากแหล่งที่มาต้องระบุแหล่งที่มาโดยใช้ช่อง attribution ของแต่ละเส้นทาง (หากมี)

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ MCP compute_routes

สคีมาอินพุต

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

สคีมาเอาต์พุต

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

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

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

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

คำอธิบายประกอบเครื่องมือ

ระบบจะส่งคำอธิบายประกอบเครื่องมือไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือหนึ่งๆ ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งยืนยันไปยังผู้ใช้เมื่อใด

นอกจากสตริงชื่อแล้ว ยังมีการกำหนดคำแนะนำบูลีนต่อไปนี้ด้วย

• readOnlyHint: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อมของตนเอง ค่าเริ่มต้น: false
• destructiveHint: หากเป็น "จริง" เครื่องมือจะดำเนินการที่ทำลายล้างได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการแบบเพิ่มเท่านั้น ค่าเริ่มต้น: true
• idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: false
• openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบได้เฉพาะกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นเว็บจะเป็นแบบโอเพนเวิลด์ ส่วนเครื่องมือความทรงจำจะไม่ใช่แบบโอเพนเวิลด์

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