MCP Reference: mapstools.googleapis.com

นี่คือเซิร์ฟเวอร์ MCP ที่ Maps Experience Agent Tools มีให้ เซิร์ฟเวอร์นี้มีเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ในการสร้างแอปพลิเคชัน LLM บน Google Maps Platform

เซิร์ฟเวอร์ Model Context Protocol (MCP) ทำหน้าที่เป็นพร็อกซีระหว่างบริการภายนอกที่ให้บริบท ข้อมูล หรือความสามารถแก่โมเดลภาษาขนาดใหญ่ (LLM) หรือแอปพลิเคชัน AI เซิร์ฟเวอร์ MCP จะเชื่อมต่อแอปพลิเคชัน AI กับระบบภายนอก เช่น ฐานข้อมูลและบริการบนเว็บ โดยจะแปลคำตอบให้อยู่ในรูปแบบที่แอปพลิเคชัน AI เข้าใจได้

การตั้งค่าเซิร์ฟเวอร์

คุณต้องเปิดใช้เซิร์ฟเวอร์ MCP และตั้งค่าการตรวจสอบสิทธิ์ก่อนใช้งาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เซิร์ฟเวอร์ MCP ระยะไกลของ Google และ Google Cloud ได้ที่ภาพรวมเซิร์ฟเวอร์ MCP ของ Google Cloud

ปลายทางของเซิร์ฟเวอร์

ปลายทางบริการ MCP คือที่อยู่เครือข่ายและอินเทอร์เฟซการสื่อสาร (โดยปกติจะเป็น URL) ของเซิร์ฟเวอร์ MCP ที่แอปพลิเคชัน AI (โฮสต์สำหรับไคลเอ็นต์ MCP) ใช้เพื่อสร้างการเชื่อมต่อที่ปลอดภัยและเป็นมาตรฐาน ซึ่งเป็นจุดติดต่อสำหรับ LLM ในการขอข้อมูลบริบท เรียกใช้เครื่องมือ หรือเข้าถึงแหล่งข้อมูล ปลายทาง MCP ของ Google อาจเป็นแบบทั่วโลกหรือระดับภูมิภาคก็ได้

เซิร์ฟเวอร์ MCP ของ Maps Experience Agent Tools มีปลายทาง MCP ทั่วโลกดังต่อไปนี้

  • https://mapstools.googleapis.com/mcp

เครื่องมือ MCP

เครื่องมือ MCP คือฟังก์ชันหรือความสามารถที่เรียกใช้ได้ซึ่งเซิร์ฟเวอร์ MCP แสดงต่อ LLM หรือแอปพลิเคชัน AI เพื่อดำเนินการในชีวิตจริง

เครื่องมือ

เซิร์ฟเวอร์ MCP mapstools.googleapis.com มีเครื่องมือต่อไปนี้

เครื่องมือ MCP
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 เฉพาะในกรณีที่มีการระบุพิกัดอย่างชัดเจน หรือหากการอนุมานตำแหน่งจากบริบทที่ทราบของผู้ใช้มีความเหมาะสมและจำเป็นเพื่อให้ได้ผลลัพธ์ที่ดีขึ้น

  • เอาต์พุตที่มีการระบุแหล่งที่มาต้องระบุแหล่งที่มาโดยใช้ข้อมูลจากช่อง attribution (หากมี)
lookup_weather

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

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

Location & Location Rules (CRITICAL):

ระบบจะระบุตำแหน่งที่ขอข้อมูลสภาพอากาศโดยใช้ช่อง location ช่องนี้เป็นโครงสร้าง "oneof" ซึ่งหมายความว่าคุณต้องระบุค่าสำหรับช่องย่อยของสถานที่ตั้งเพียงช่องเดียวจาก 3 ช่องด้านล่างเพื่อให้การค้นหาข้อมูลสภาพอากาศถูกต้อง

  1. พิกัดทางภูมิศาสตร์ (lat_lng)

    • ใช้เมื่อคุณได้รับพิกัดละติจูด/ลองจิจูดที่แน่นอน
    • ตัวอย่าง: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // ลอสแอนเจลิส

  2. รหัสสถานที่ (place_id)

    • ตัวระบุสตริงที่ชัดเจน (รหัสสถานที่ของ Google Maps)
    • คุณสามารถดึงข้อมูล place_id ได้จากเครื่องมือ search_places
    • ตัวอย่าง: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // หอไอเฟล

  3. สตริงที่อยู่ (address)

    • สตริงรูปแบบอิสระที่ต้องระบุเฉพาะเจาะจงสำหรับการเข้ารหัสพิกัดภูมิศาสตร์
    • เมืองและภูมิภาค: ระบุภูมิภาค/ประเทศเสมอ (เช่น "London, UK" ไม่ใช่ "London")
    • ที่อยู่: ระบุที่อยู่แบบเต็ม (เช่น "1600 Pennsylvania Ave NW, Washington, DC")
    • รหัสไปรษณีย์: ต้องระบุชื่อประเทศด้วย (เช่น "90210, USA" ไม่ใช่ "90210")
    • ตัวอย่าง: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

โหมดการใช้งาน

  • สภาพอากาศปัจจุบัน: ระบุเฉพาะ location เท่านั้น อย่าระบุ date และ hour

  • พยากรณ์รายชั่วโมง: ระบุ location, date และ hour (0-23) ใช้สำหรับเวลาที่เจาะจง (เช่น "ตอน 17:00 น.") หรือคำต่างๆ เช่น "อีก 2-3 ชั่วโมงข้างหน้า" หรือ "วันนี้ในช่วงสาย" หากผู้ใช้ระบุนาที ให้ปัดเศษลงเป็นชั่วโมงที่ใกล้ที่สุด ระบบไม่รองรับการพยากรณ์รายชั่วโมงที่เกิน 120 ชั่วโมงนับจากนี้ ระบบรองรับสภาพอากาศรายชั่วโมงย้อนหลังสูงสุด 24 ชั่วโมงที่ผ่านมา

  • พยากรณ์อากาศประจำวัน: แสดงlocationและdate อย่าระบุ hour ใช้สำหรับคำขอเกี่ยวกับวันทั่วไป (เช่น "สภาพอากาศพรุ่งนี้" "สภาพอากาศวันศุกร์" "สภาพอากาศวันที่ 25/12") หากวันที่ของวันนี้ไม่อยู่ในบริบท คุณควรชี้แจงกับผู้ใช้ ระบบไม่รองรับการพยากรณ์รายวันเกิน 10 วันนับจากวันนี้ ไม่รองรับข้อมูลสภาพอากาศที่ผ่านมา

ข้อจำกัดของพารามิเตอร์

  • เขตเวลา: ข้อมูล date และ hour ทั้งหมดที่ป้อนต้องสัมพันธ์กับเขตเวลาท้องถิ่นของสถานที่ตั้ง ไม่ใช่เขตเวลาของผู้ใช้
  • รูปแบบวันที่: ข้อมูลที่ป้อนต้องแยกเป็นจำนวนเต็ม {year, month, day} รายการ
  • หน่วย: ค่าเริ่มต้นคือ METRIC ตั้งค่า units_system เป็น IMPERIAL สำหรับฟาเรนไฮต์/ไมล์ หากผู้ใช้บอกเป็นนัยถึงมาตรฐานของสหรัฐอเมริกาหรือขออย่างชัดเจน

  • เอาต์พุตที่มีการระบุแหล่งที่มาต้องระบุแหล่งที่มาโดยใช้ข้อมูลจากช่อง attribution (หากมี)
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 ของแต่ละเส้นทาง (หากมี)
resolve_names

แปลงรายการคำค้นหาสถานที่ที่เฉพาะเจาะจง (ชื่อจุดสังเกตหรือที่อยู่ที่แน่นอน) เป็นรหัสสถานที่ Canonical ของ Google Maps

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

  1. queries (อาร์เรย์ของออบเจ็กต์ - บังคับ): รายการคำค้นหาตำแหน่งที่จะแก้ไข คุณระบุคำค้นหาได้สูงสุด 20 รายการ

    • ออบเจ็กต์การค้นหาแต่ละรายการต้องมีสิ่งต่อไปนี้
      • text (สตริง - บังคับ): คำค้นหาข้อความที่แสดงชื่อหรือที่อยู่ของสถานที่ที่ต้องการแก้ไข
        • ตัวอย่าง: 'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'

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

    • รูปแบบ: {"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}

  3. region_code (สตริง - ไม่บังคับ): รหัสภูมิภาค CLDR ของ Unicode (รหัสประเทศ 2 ตัวอักษร เช่น US, CA) ของผู้ใช้เพื่อให้น้ำหนักกับผลลัพธ์

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

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

บันทึกลงใน Google Maps

  • การตอบกลับจะมีช่อง save_to_maps_url ซึ่งเป็นลิงก์ Google Maps รายการเดียวที่มีสถานที่ทั้งหมดที่ได้รับการแก้ไขเรียบร้อยแล้ว
  • เมื่อผู้ใช้ต้องการบันทึก แชร์ หรือเปิดสถานที่ที่ได้รับการแก้ไขเป็นรายการใน Google Maps ให้แสดงลิงก์นี้แก่ผู้ใช้ อย่าสร้างลิงก์นี้ด้วยตนเอง

การจัดการข้อผิดพลาด (สำคัญ):

  • นี่คือเครื่องมือประมวลผลแบบกลุ่ม คำขออาจแสดง "ผลลัพธ์แบบผสม" (เช่น การค้นหาบางรายการได้รับการแก้ไขเรียบร้อยแล้ว แต่บางรายการไม่สำเร็จ)
  • รายการเอาต์พุตของ results จะจับคู่แบบ 1:1 กับดัชนี queries ของอินพุตอย่างแน่นอน การค้นหาที่ล้มเหลวจะส่งผลให้เกิดข้อความ Result ที่ว่างเปล่า (ไม่ได้ตั้งค่า entity) ที่ดัชนีที่เกี่ยวข้องในรายการ results
  • คุณต้องตรวจสอบช่องแผนที่ failed_requests ในการตอบกลับเพื่อระบุดัชนีการค้นหาที่เฉพาะเจาะจงซึ่งดำเนินการไม่สำเร็จ คีย์ของ failed_requests แสดงถึงดัชนีแบบ 0-based ของคำค้นหาที่ล้มเหลวในคำขอ อย่าถือว่าการเรียกใช้แบบเป็นกลุ่มทั้งหมดล้มเหลวเนื่องจากความล้มเหลวบางส่วน
resolve_maps_urls

แปลงรายการ URL ของ Google Maps เป็นรหัสสถานที่ Canonical ของ Google Maps

กรณีที่ควรเรียกใช้เครื่องมือนี้ (สำคัญ):

  • ใช้เครื่องมือนี้เมื่อผู้ใช้ระบุลิงก์หรือ URL การแชร์ของ Google Maps อย่างน้อย 1 รายการ (เช่น "https://maps.app.goo.gl/..." "https://www.google.com/maps/place/..." หรือ "https://maps.google.com/...") และคุณต้องดึงข้อมูลรหัสสถานที่ Canonical ที่สำคัญ
  • คุณระบุ URL ที่ต้องการแก้ไขได้สูงสุด 20 รายการในคำขอแบบกลุ่มรายการเดียว

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

  • urls (อาร์เรย์ของสตริง - บังคับ): รายการ URL ของ Google Maps ที่จะแก้ไข URL แต่ละรายการต้องเป็น URL ของ Google Maps ที่ถูกต้องและมีสถานที่เดียว

บันทึกลงใน Google Maps

  • การตอบกลับจะมีช่อง save_to_maps_url ซึ่งเป็นลิงก์ Google Maps รายการเดียวที่มีสถานที่ทั้งหมดที่ได้รับการแก้ไขเรียบร้อยแล้ว
  • เมื่อผู้ใช้ต้องการบันทึก แชร์ หรือเปิดสถานที่ที่ได้รับการแก้ไขเป็นรายการใน Google Maps (เช่น การรวบรวมสถานที่ที่แชร์ในการสนทนา) ให้แสดงลิงก์นี้แก่ผู้ใช้ อย่าสร้างลิงก์นี้ด้วยตนเอง

การจัดการข้อผิดพลาด (สำคัญ):

  • นี่คือเครื่องมือประมวลผลแบบกลุ่ม คำขออาจแสดง "ผลลัพธ์แบบผสม" (เช่น URL บางรายการแปลงเป็นที่อยู่ IP สำเร็จ ขณะที่บางรายการไม่สำเร็จ)
  • รายการเอาต์พุตของ entities จะจับคู่แบบ 1:1 กับดัชนี urls ของอินพุตอย่างแน่นอน การแปลง URL ที่ไม่สำเร็จจะส่งผลให้ข้อความ Entity ว่างเปล่า (ไม่มีการตั้งค่าช่อง) ที่ดัชนีที่เกี่ยวข้องในรายการ entities
  • คุณต้องตรวจสอบช่องแผนที่ failed_requests ในการตอบกลับเพื่อระบุว่าการจัดทำดัชนี URL ใดไม่สำเร็จ คีย์ของ failed_requests แสดงถึงดัชนีแบบ 0-based ของ URL ที่ไม่สำเร็จในคำขอ อย่าถือว่าการเรียกใช้แบบเป็นกลุ่มทั้งหมดล้มเหลวเนื่องจากความล้มเหลวบางส่วน

ดูข้อกำหนดเฉพาะของเครื่องมือ 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
}'