MCP Tools Reference: mapstools.googleapis.com

ข้อมูลอ้างอิงเครื่องมือ MCP

เอกสารนี้อธิบายปลายทาง REST API ที่หันหน้าออกสู่ภายนอกซึ่งใช้ในการเรียกใช้เครื่องมือ Model Context Protocol (MCP) ระยะไกลของ Google API นี้ทำหน้าที่เป็นพร็อกซีที่ปลอดภัยระหว่างไคลเอ็นต์ HTTP ภายนอก (เช่น curl หรือบริการเว็บ) กับเซิร์ฟเวอร์ MCP ภายใน

ดูข้อกำหนดของเครื่องมือ MCP

หากต้องการดูข้อกำหนดของเครื่องมือ MCP สำหรับเครื่องมือทั้งหมดในเซิร์ฟเวอร์ MCP ให้ใช้วิธี `tools/list` ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อแสดงรายการเครื่องมือทั้งหมดและข้อกำหนดของเครื่องมือเหล่านั้นที่พร้อมใช้งานในเซิร์ฟเวอร์ MCP

คำขอ Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'

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

เรียกใช้เครื่องมือนี้เมื่อคำขอของผู้ใช้คือการค้นหาสถานที่ ธุรกิจ ที่อยู่ สถานที่ตั้ง จุดที่น่าสนใจ หรือการค้นหาอื่นๆ ที่เกี่ยวข้องกับ Google Maps

ข้อกำหนดของข้อมูล (สำคัญ):

  1. text_query (สตริง - จำเป็น): คำค้นหาหลัก โดยต้องระบุสิ่งที่ผู้ใช้ต้องการอย่างชัดเจน

    • ตัวอย่าง: 'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'
    • สำหรับรายละเอียดสถานที่ที่เฉพาะเจาะจง: ระบุแอตทริบิวต์ที่ขอ (เช่น 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address')

  2. location_bias (ออบเจ็กต์ - ไม่บังคับ): ใช้เพื่อจัดลำดับความสำคัญของผลลัพธ์ที่อยู่ใกล้พื้นที่ทางภูมิศาสตร์ที่เฉพาะเจาะจง

    • รูปแบบ: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • การใช้งาน:
      • หากต้องการให้ความสำคัญกับรัศมี 5 กม. {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • หากต้องการให้ค่ากลางมีน้ำหนักมาก {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (ละเว้น radius_meters)

  3. language_code (สตริง - ไม่บังคับ): ภาษาที่จะแสดงข้อมูลสรุปของผลการค้นหา

    • รูปแบบ: รหัสภาษาแบบ 2 ตัวอักษร (ISO 639-1) ตามด้วยขีดล่างและรหัสประเทศแบบ 2 ตัวอักษร (ISO 3166-1 alpha-2) โดยไม่บังคับ เช่น en, ja, en_US, zh_CN, es_MX หากไม่ได้ระบุรหัสภาษา ผลลัพธ์จะเป็นภาษาอังกฤษ

  4. region_code (สตริง - ไม่บังคับ): รหัสภูมิภาค CLDR ของ Unicode ของผู้ใช้ พารามิเตอร์นี้ใช้เพื่อแสดงรายละเอียดสถานที่ เช่น ชื่อสถานที่เฉพาะภูมิภาค หากมี พารามิเตอร์อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

    • รูปแบบ: รหัสประเทศ 2 ตัวอักษร (ISO 3166-1 alpha-2) เช่น US, CA

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

  • ข้อมูลตำแหน่ง (สำคัญ): การค้นหาต้องมีข้อมูลตำแหน่งที่เพียงพอ หากตำแหน่งไม่ชัดเจน (เช่น เพียงแค่ "ร้านพิซซ่า") คุณต้องระบุใน text_query (เช่น ร้านพิซซ่าในนิวยอร์ก") หรือใช้พารามิเตอร์ location_bias ระบุชื่อเมือง รัฐ/จังหวัด และภูมิภาค/ประเทศ หากจำเป็นเพื่อไม่ให้เกิดความสับสน

  • ระบุtext_queryที่เฉพาะเจาะจงและมีบริบทมากที่สุดเท่าที่จะทำได้เสมอ

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

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

คำขอ 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": search_places,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

แสดงสภาพอากาศปัจจุบัน พยากรณ์รายชั่วโมง และพยากรณ์รายวันสำหรับทุกสถานที่ ใช้เครื่องมือนี้สำหรับคำถามทั้งหมดที่เกี่ยวข้องกับสภาพอากาศ

ข้อมูลที่เฉพาะเจาะจงที่พร้อมใช้งาน: อุณหภูมิ (ปัจจุบัน, อุณหภูมิที่รู้สึก, สูงสุด/ต่ำสุด, ดัชนีความร้อน), ลม (ความเร็ว, ลมกระโชก, ทิศทาง), ปรากฏการณ์บนท้องฟ้า (พระอาทิตย์ขึ้น/ตก, ข้างขึ้นข้างแรม), ปริมาณน้ำฝน (ประเภท, ความน่าจะเป็น, ปริมาณ/QPF), สภาพอากาศ (ดัชนีรังสียูวี, ความชื้น, ปริมาณเมฆ, ความน่าจะเป็นที่จะเกิดพายุฝนฟ้าคะนอง) และที่อยู่ของสถานที่ที่เข้ารหัสพิกัดภูมิศาสตร์

ข้อกำหนดของข้อมูล (สำคัญ):

  • สภาพอากาศปัจจุบัน: ต้องระบุเพียงสถานที่ (เช่น เมืองหรือที่อยู่) อย่าระบุวันที่หรือชั่วโมง

  • พยากรณ์รายชั่วโมง: ต้องระบุตำแหน่งและชั่วโมง (0-23) ใช้ในกรณีที่ผู้ใช้ถามถึงสภาพอากาศในเวลาที่เฉพาะเจาะจงหรือใช้คำอย่าง "อีกไม่กี่ชั่วโมง" หรือ "ช่วงเย็นวันนี้"

  • การพยากรณ์รายวัน: ต้องระบุสถานที่และวันที่แบบเต็ม

การจัดการวันที่ (สําคัญ): ต้องระบุวันที่และเวลาที่ได้จากผู้ใช้ในเขตเวลาท้องถิ่นของสถานที่ที่ขอ ต้องแยกวันที่ออกเป็นพารามิเตอร์จำนวนเต็มที่แยกกัน ได้แก่ ปี เดือน และวัน รูปแบบที่ต้องระบุสำหรับพารามิเตอร์เหล่านี้คือ {"year": , "month": , "day": }

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

คำขอ 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": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

คำนวณเส้นทางการเดินทางระหว่างต้นทางและปลายทางที่ระบุ โหมดการเดินทางที่รองรับ: DRIVE (ค่าเริ่มต้น), WALK

ข้อกำหนดของอินพุต (สำคัญ): ต้องระบุทั้งต้นทางและปลายทาง โดยต้องระบุโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ ซึ่งซ้อนอยู่ในฟิลด์ที่เกี่ยวข้อง

  • address: (สตริง เช่น "หอไอเฟล ปารีส") หมายเหตุ: ยิ่งที่อยู่ที่ป้อนมีความละเอียดหรือเฉพาะเจาะจงมากเท่าใด ผลลัพธ์ก็จะยิ่งดีขึ้นเท่านั้น

  • lat_lng: (ออบเจ็กต์, {"latitude": number, "longitude": number})

  • place_id: (สตริง เช่น "ChIJOwE_Id1w5EAR4Q27FkL6T_0") หมายเหตุ: คุณขอรับรหัสนี้ได้จากเครื่องมือ search_places ระบบอนุญาตให้ใช้ชุดค่าผสมของประเภทอินพุต (เช่น ต้นทางตามที่อยู่ ปลายทางตาม lat_lng) หากไม่มีทั้งต้นทางหรือปลายทาง คุณต้องขอคำชี้แจงจากผู้ใช้ก่อนที่จะพยายามเรียกใช้เครื่องมือ

การเรียกใช้เครื่องมือตัวอย่าง: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

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

คำขอ 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: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'