MCP Reference: mapstools.googleapis.com

นี่คือเซิร์ฟเวอร์ MCP ที่เครื่องมือ Agent สำหรับ Maps Experience มีให้ เซิร์ฟเวอร์นี้มีเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ในการสร้างแอปพลิเคชัน 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 ของเครื่องมือ Agent สำหรับ Maps Experience มีปลายทาง 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
  5. page_size (จำนวนเต็ม - ไม่บังคับ): จำนวนสถานที่สูงสุดที่จะแสดงผล ตั้งแต่ 1 ถึง 10 ค่าเริ่มต้นคือ 5 ตั้งค่าด้านบน 5 เฉพาะเมื่อผู้ใช้ต้องการเปรียบเทียบสถานที่มากกว่า 5 แห่ง ค่าตั้งแต่ 6 ถึง 10 จะมีค่าใช้จ่ายสูงขึ้นและเวลาในการตอบสนองนานขึ้น

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

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

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

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

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

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

lookup_weather ดึงข้อมูลอัจฉริยะด้านสิ่งแวดล้อมที่ครอบคลุมสำหรับสถานที่หนึ่งๆ ซึ่งรวมถึงสภาพอากาศ คุณภาพอากาศ (AQI และสารมลพิษ) และละอองเกสร (ระดับสารก่อภูมิแพ้จากต้นไม้ หญ้า วัชพืช และพืชชนิดต่างๆ) ได้แก่ สภาพปัจจุบัน พยากรณ์อากาศ/ประวัติรายชั่วโมง และพยากรณ์อากาศและคุณภาพอากาศรายวัน ส่วนละอองเกสรจะเป็นพยากรณ์รายวันเท่านั้น (วันนี้ถึง +4 วัน ไม่มีข้อมูลรายชั่วโมงหรือข้อมูลย้อนหลัง) โดเมนและขีดความสามารถด้านสิ่งแวดล้อมที่พร้อมใช้งาน (capabilities: WEATHER, AIR_QUALITY, POLLEN — สำคัญ): * การเลือกที่ชัดเจนและจำเป็น: คุณต้องรวม WEATHER, AIR_QUALITY หรือ POLLEN อย่างน้อย 1 รายการใน capabilities ในทุกการเรียก ไม่อนุญาตให้ละเว้น capabilities * คำถามเกี่ยวกับกิจกรรมกลางแจ้งแบบกว้างๆ/ไม่ชัดเจน (ชุดข้อมูลสภาพแวดล้อมกลางแจ้งแบบเต็ม): หากผู้ใช้ถามคำถามทั่วไปเกี่ยวกับกิจกรรมกลางแจ้ง การเดินทาง หรือสถานการณ์ต่างๆ โดยไม่จำกัดเฉพาะโดเมนใดโดเมนหนึ่ง (เช่น "ตอนนี้สภาพอากาศกลางแจ้งเหมาะกับการวิ่งไหม") ให้รวมความสามารถทั้ง 3 อย่างไว้อย่างชัดเจน (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]) เพื่อแสดงชุดข้อมูลสภาพแวดล้อมกลางแจ้งแบบเต็ม (สภาพอากาศ + คุณภาพอากาศ + ละอองเกสร) สำหรับdate/hourที่ผ่านมา ให้ละเว้นPOLLENซึ่งไม่มีข้อมูลย้อนหลัง * การเลือกโดเมนเป้าหมาย (คำถามที่เจาะจง): หากผู้ใช้ถามถึงโดเมนเพียง 1 หรือ 2 โดเมนโดยเฉพาะ (เช่น "AQI ในซีแอตเทิลขณะนี้เป็นเท่าไร") ให้รวมเฉพาะความสามารถที่ขอ (WEATHER, AIR_QUALITY และ/หรือ POLLEN) ระบบจะดำเนินการและแสดงผลเฉพาะโดเมนที่ขอเท่านั้น ข้อมูลที่เจาะจงซึ่งพร้อมใช้งานตามโดเมน: * สภาพอากาศ (weather): อุณหภูมิ (ปัจจุบัน, อุณหภูมิที่รู้สึก, สูงสุด/ต่ำสุด, ดัชนีความร้อน), ลม (ความเร็ว, ลมกระโชก, ทิศทาง), ปรากฏการณ์บนท้องฟ้า (พระอาทิตย์ขึ้น/พระอาทิตย์ตก, ข้างขึ้นข้างแรม), หยาดน้ำฟ้า (ประเภท, ความน่าจะเป็น, ปริมาณ/QPF) และสภาพบรรยากาศ (ดัชนีรังสียูวี, ความชื้น, เมฆปกคลุม, ความน่าจะเป็นที่จะเกิดพายุฝนฟ้าคะนอง, ความกดอากาศ) * คุณภาพอากาศ (air_quality): ดัชนีคุณภาพอากาศสากลและท้องถิ่น (ค่า AQI, หมวดหมู่, สารมลพิษหลัก), คำแนะนำด้านสุขภาพสำหรับกลุ่มที่ไวต่อสภาพอากาศ 7 กลุ่ม และความเข้มข้นของสารมลพิษ (include_pollutant_concentration: true) ดัชนีแต่ละรายการมีสารมลพิษหลักของตัวเอง ให้รายงานตามดัชนี (เช่น อย่าระบุสารมลพิษของ AQI สากลสำหรับ AQI ของสหรัฐอเมริกา) * ละอองเกสร (pollen): ดัชนีละอองเกสรสากล (UPI, 0-5) รายวันตามหมวดหมู่ต้นไม้ หญ้า และวัชพืช และตามชนิดพืช (index.value พร้อม index.category เช่น 1 = "ต่ำมาก") สถานะตามฤดูกาล ปฏิกิริยาข้ามชนิด และคำแนะนำด้านสุขภาพ * ไม่มีช่องละอองเกสร: หากไม่มี in_season หมายความว่าไม่อยู่ในช่วงฤดูกาล ไม่ต้องพูดถึงชนิดพันธุ์พืชที่แสดงผลโดยไม่มี index เว้นแต่ผู้ใช้จะถามถึงพืชชนิดนั้น จากนั้นให้บอกว่าไม่มีการรายงานข้อมูลละอองเกสรสำหรับพืชชนิดนั้นในวันนี้ (อย่าอนุมานระดับ) กฎสถานที่ตั้ง (สำคัญ): ต้องระบุสถานที่เป้าหมายใน location โดยใช้ฟิลด์ย่อย oneof ต่อไปนี้เพียงฟิลด์เดียว 1. พิกัดทางภูมิศาสตร์ (lat_lng): * ใช้เมื่อทราบพิกัดละติจูด/ลองจิจูดที่แน่นอน * ตัวอย่าง: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2 รหัสสถานที่ (place_id): * รหัสสถานที่ใน Google Maps ที่ชัดเจน (เช่น ได้มาจาก search_places หรือ resolve_names) * ตัวอย่าง: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. สตริงที่อยู่ (address): * เมือง/ภูมิภาค ย่าน สถานที่สำคัญหรือจุดที่น่าสนใจ ที่อยู่ หรือรหัสไปรษณีย์ โดยควรระบุเมือง/ประเทศด้วย * ตัวอย่าง: {"location": {"address": "Paris, France"}} โหมดเวลาและการใช้งาน (date และ hour — สำคัญ): * การอ้างอิงเขตเวลาท้องถิ่น: ข้อมูล date ({year, month, day}) และ hour (0-23) ทั้งหมดต้องแสดงในเขตเวลาท้องถิ่นของ location ที่ขอ (เช่น คำค้นหาสำหรับ "Paris tomorrow at 13:00" จะใช้วันที่และเวลาท้องถิ่นของ Europe/Paris 13) ไม่ใช่ UTC หรือเขตเวลาของผู้โทร * 1. เงื่อนไขปัจจุบัน (ละเว้น date และละเว้น hour): * ระบุ location และ capabilities เป้าหมาย (WEATHER, AIR_QUALITY, POLLEN) อย่าระบุ date หรือ hour * แสดงผลสภาพอากาศปัจจุบันแบบเรียลไทม์ (CC) สำหรับโดเมนที่ขอ (สภาพอากาศปัจจุบัน คุณภาพอากาศในชั่วโมงปัจจุบัน และ/หรือการพยากรณ์ละอองเกสรของวันนี้) * สำหรับคุณภาพอากาศ สภาพอากาศปัจจุบันคือชั่วโมงเดียว: อย่าใช้เพียงอย่างเดียวเพื่อตอบคำถามเกี่ยวกับคุณภาพอากาศหรือคำถามกว้างๆ เกี่ยวกับสภาพอากาศกลางแจ้งของวันนี้โดยรวม (ใช้คำถามรายวันด้านล่าง) * 2. พยากรณ์/ประวัติรายชั่วโมง (ระบุ date และระบุ hour 0-23): * ระบุ location, date ({year, month, day}), hour (0-23) และ capabilities เป้าหมาย หากมีการระบุนาที ให้ปัดเศษลงเป็นชั่วโมงที่ใกล้ที่สุด * ข้อจำกัดที่สำคัญ (ต้องระบุ date เมื่อตั้งค่า hour): ไม่อนุญาตให้ระบุ hour โดยไม่มี date (ละเว้น date แต่ตั้งค่า hour) และจะดำเนินการไม่สำเร็จพร้อมข้อผิดพลาด แม้ว่าผู้ใช้จะถามเกี่ยวกับชั่วโมงที่เฉพาะเจาะจงวันนี้ (เช่น "at 13:00 today") คุณต้องป้อนทั้ง date (วันที่วันนี้เวลา location) และ hour * ดำเนินการค้นหาข้อมูลสภาพอากาศและ/หรือคุณภาพอากาศที่ขอทุกชั่วโมงที่ YYYY-MM-DD-HH และค้นหาข้อมูลละอองเกสรที่ขอทุกวันใน YYYY-MM-DD * คำถามเกี่ยวกับสภาพอากาศที่ถามว่า "เมื่อใด": สำหรับคำถามเกี่ยวกับสภาพอากาศที่ถามว่าเมื่อใด/กี่โมง/เวลาใดดีที่สุด (เช่น "what time will it stop raining?") ให้ใช้การเรียก WEATHER รายชั่วโมง (date + hour) สำหรับชั่วโมงที่เกี่ยวข้อง พยากรณ์อากาศรายวันไม่มีค่ารายชั่วโมง สำหรับคำถามเกี่ยวกับกิจกรรมกลางแจ้งแบบกว้างๆ ที่มีคำว่า "เมื่อไร/เวลาที่ดีที่สุด" (เช่น "when is the best time to go walking today?") ให้เรียกใช้ WEATHER แบบรายชั่วโมงนอกเหนือจากการเรียกใช้แบบเต็มวันสำหรับคุณภาพอากาศ (และละอองเกสร) ที่อธิบายไว้ในส่วนคำถามรายวัน * 3. คำถามเกี่ยวกับวัน (ระบุ date และละเว้น hour): * ระบุ location, date ({year, month, day} ในเวลาท้องถิ่นของ location ที่ขอ) โดยไม่มี hour และ capabilities เป้าหมายสำหรับคำถามเกี่ยวกับทั้งวัน (เช่น "weather and pollen in London tomorrow") * คำถามเกี่ยวกับคุณภาพอากาศและคำถามกว้างๆ เกี่ยวกับสภาพอากาศภายนอกของวันนี้: สำหรับคำถามเกี่ยวกับคุณภาพอากาศและคำถามกว้างๆ เกี่ยวกับสภาพอากาศภายนอก (ซึ่งรวมถึงคุณภาพอากาศ) ของวันนี้ (เช่น "how will the air quality change today", "is today a good day for a picnic?") ให้ตั้งค่า date เป็นวันที่ของวันนี้ที่ location (ละเว้นชั่วโมง) เพื่อรับชุดข้อมูลคุณภาพอากาศรายชั่วโมงของวัน การเรียกใช้ Current Conditions เพียงอย่างเดียวจะแสดงเฉพาะคุณภาพอากาศในชั่วโมงปัจจุบันเท่านั้น ซึ่งไม่เพียงพอ คุณอาจเพิ่มการเรียกใช้ดังกล่าวหากผู้ใช้ถามเกี่ยวกับ "ตอนนี้" ด้วย กรอบเวลาคุณภาพอากาศ: สำหรับคำถามเกี่ยวกับคุณภาพอากาศเกี่ยวกับกรอบเวลาภายใน 1 วัน (เช่น "air quality between noon and 6 PM") ให้เลือกการเรียกใช้รายวัน 1 ครั้งสำหรับวันที่นั้น และอ่านชั่วโมงของกรอบเวลาจากชุดข้อมูลคุณภาพอากาศ แทนที่จะสุ่มตัวอย่างแต่ละชั่วโมง หากคุณใช้การเรียกรายชั่วโมง ให้ครอบคลุมทุกชั่วโมงของกรอบเวลา * แสดงผลการพยากรณ์รายวันสำหรับสภาพอากาศและ/หรือละอองเกสรที่ขอ และชุดข้อมูลคุณภาพอากาศรายชั่วโมงของวันซึ่งครอบคลุมทั้งวันตามเวลาท้องถิ่น (00:00-23:00 น. ตามเวลาท้องถิ่น) โดยแสดงข้อมูลย้อนหลัง 24 ชั่วโมงสำหรับวันที่ผ่านมา ข้อมูลพยากรณ์ 24 ชั่วโมงสำหรับวันที่ในอนาคต และสำหรับวันนี้จะแสดงข้อมูลชั่วโมงก่อนหน้า (ย้อนหลัง) ชั่วโมงปัจจุบัน และชั่วโมงที่เหลือ (พยากรณ์) ระยะเวลาที่รองรับตามโดเมน: * สภาพอากาศ: รายชั่วโมงตั้งแต่ 24 ชั่วโมงที่ผ่านมาจนถึง 240 ชั่วโมง (10 วัน) ข้างหน้า (ชั่วโมงที่ผ่านมาต้องมีทั้ง date และ hour) รายวันสูงสุด 10 วันรวมถึงวันนี้ (วันนี้จนถึง +9 วัน) ไม่มีประวัติรายวัน * คุณภาพอากาศ: รายชั่วโมงตั้งแต่ 720 ชั่วโมง (30 วัน) ที่ผ่านมาจนถึง 96 ชั่วโมง (4 วัน) ข้างหน้า การเรียกข้อมูลแบบเต็มวันต้องอยู่ภายในกรอบเวลาดังกล่าว (ในทางปฏิบัติคือวันนี้ -29 วันถึง +3 วัน) * ละอองเกสร: รายวันเท่านั้น ตั้งแต่วันนี้จนถึงอีก 4 วัน (รวมวันนี้เป็น 5 วัน) ไม่มีวันที่ที่ผ่านมา และระบบจะไม่สนใจ hour * (หมายเหตุ: หากมีการขอความสามารถหลายรายการและ date/hour อยู่นอกช่วงใดช่วงหนึ่ง การเรียกจะยังคงสำเร็จและแสดงเฉพาะความสามารถที่รองรับ) * คำขอที่อยู่นอกช่วง: หากวันที่หรือเวลาที่ขออยู่นอกช่วงที่รองรับของโดเมนข้างต้น (เช่น ละอองเกสรสำหรับวันที่ที่ผ่านมา) ให้เรียกใช้ lookup_weather สำหรับวันที่/เวลาที่ขอ ข้อผิดพลาดจะระบุช่วงที่รองรับ อย่าใช้วันที่ ชั่วโมง หรือโดเมนอื่นแทน ตัวเลือกโดเมนและการระบุแหล่งที่มา: * ภาษา (language_code): รหัสภาษา BCP-47 ที่ไม่บังคับ (เช่น "fr") ค่าเริ่มต้นคือ "en" * หน่วยวัดสภาพอากาศ (weather_options.units_system หรือ units_system): ค่าเริ่มต้นคือ METRIC ตั้งค่าเป็น IMPERIAL (ฟาเรนไฮต์/ไมล์ต่อชั่วโมง) หากผู้ใช้บอกเป็นนัยถึงมาตรฐานของสหรัฐอเมริกาหรือขอหน่วยอิมพีเรียลอย่างชัดเจน รองรับทั้งใน weather_options.units_system (แนะนำ) และ units_system ระดับบนสุด หากระบุทั้ง 2 รายการ จะต้องไม่ขัดแย้งกัน * ตัวเลือกคุณภาพอากาศ (air_quality_options): ตั้งค่า include_pollutant_concentration: true เมื่อต้องการความเข้มข้นของสารมลพิษที่เฉพาะเจาะจง (PM2.5, PM10, O3, NO2, SO2, CO) และตั้งค่า index_region_code (รหัสประเทศ ISO 2 ตัวอักษร เช่น "US") เพื่อขอระดับ AQI ระดับภูมิภาคที่เฉพาะเจาะจงได้ โดยค่าเริ่มต้น การตอบกลับจะรวม AQI สากลและ AQI ระดับภูมิภาคของสถานที่ตั้ง * การระบุแหล่งที่มา: เอาต์พุตที่มีข้อมูลสนับสนุนต้องระบุแหล่งที่มาโดยใช้ช่อง attribution ภายในคอนเทนเนอร์โดเมนที่แสดงผลแต่ละรายการ (weather.attribution, air_quality.attribution, pollen.attribution) * เวลาที่แสดงผล: ค่าคุณภาพอากาศ date_time อยู่ในเวลาท้องถิ่นของสถานที่นั้นอยู่แล้ว (รวม utc_offset) ให้แสดงตามที่เป็นอยู่ สภาพอากาศ date_time (ปัจจุบันและรายชั่วโมง) และเวลาพระอาทิตย์ขึ้น/ตกเป็นเวลา UTC ให้แปลงเป็นเวลาท้องถิ่นของสถานที่นั้นโดยใช้ time_zone ติดป้ายกำกับเวลาทั้งหมดเป็นเวลาท้องถิ่น
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 (อาร์เรย์ของออบเจ็กต์ - ไม่บังคับ): จุดแวะพักสูงสุด 25 จุดที่ต้องผ่านตามลำดับระหว่างต้นทางและปลายทาง รูปแบบเดียวกับ origin ไม่รองรับ TRANSIT รวมเฉพาะจุดแวะพักที่ผู้ใช้ขอเท่านั้น การระบุจุดอ้างอิงระดับกลางมากกว่า 10 จุดจะทำให้มีค่าใช้จ่ายสูงขึ้นและเวลาในการตอบสนองนานขึ้น

  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 ว่างเปล่า ให้แจ้งผู้ใช้ว่าไม่พบเส้นทาง อย่าเดาเส้นทาง
  • หากต้องการค้นหาสถานที่ตามเส้นทาง DRIVE ให้ส่ง retrieval_token ของเส้นทางไปยัง search_along_route โทเค็นจะใช้งานได้เป็นเวลา 10 นาที
  • ระบุเฉพาะข้อเท็จจริงที่เครื่องมือแสดงผลเท่านั้น อย่าสร้างเส้นทางแบบเลี้ยวต่อเลี้ยว สายขนส่งสาธารณะ สถานี ชานชาลา หรือการเปลี่ยนสายขึ้นมาเอง
  • เอาต์พุตที่มีการระบุแหล่งที่มาต้องระบุแหล่งที่มาโดยใช้ฟิลด์ attribution ของแต่ละเส้นทาง (หากมี)
search_along_route

เรียกใช้เครื่องมือนี้เมื่อผู้ใช้ต้องการค้นหาสถานที่ ธุรกิจ หรือจุดที่น่าสนใจตามเส้นทางการเดินทาง (เช่น "ปั๊มน้ำมันระหว่างทางไป Tahoe" "ร้านกาแฟระหว่าง SF กับ San Jose") การเรียกใช้เครื่องมือนี้มีค่าใช้จ่ายสูงกว่า search_places ดังนั้นให้ใช้ search_places แทนเมื่อค้นหาใกล้กับสถานที่เดียวแทนที่จะค้นหาตามเส้นทาง

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

  1. text_query (สตริง - บังคับ): คำอธิบายภาษาธรรมชาติของสิ่งที่ต้องการค้นหาตามเส้นทาง

    • ตัวอย่าง: 'ev chargers', 'coffee', 'vegetarian restaurants', 'rest stops'
  2. ข้อกำหนดเส้นทาง (บังคับ - ระบุรายการต่อไปนี้เพียง 1 รายการ)

    • retrieval_token (สตริง): retrieval_token ที่แสดงผลโดยการเรียก compute_routes ก่อนหน้าสำหรับเส้นทาง DRIVE ใช้ตัวเลือกนี้เมื่อคำนวณเส้นทางแล้ว โทเค็นจะใช้งานได้เป็นเวลา 10 นาที
    • route_endpoints (ออบเจ็กต์): origin และ destination ของเส้นทาง โดยต้องระบุแต่ละรายการโดยใช้ address, lat_lng หรือ place_id
      • เช่น {"route_endpoints": {"origin": {"address": "San Francisco, CA"}, "destination": {"address": "Lake Tahoe, CA"}}}
    • encoded_polyline (สตริง): เส้นประกอบที่เข้ารหัสซึ่งแสดงเส้นทาง DRIVE
  3. travel_mode (enum - ไม่บังคับ): DRIVE (ค่าเริ่มต้น), WALK หรือ BICYCLE WALK และ BICYCLE รองรับเฉพาะ route_endpoints เท่านั้น ไม่รองรับ TRANSIT

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

    • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (ค่าเริ่มต้น): คำนวณเส้นทางและทางอ้อมโดยไม่มีข้อมูลการจราจรแบบเรียลไทม์ เวลาในการตอบสนองต่ำที่สุด
    • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: ใช้สภาพการจราจรแบบเรียลไทม์เมื่อพร้อมใช้งาน ไม่รองรับ WALK หรือ BICYCLE ตั้งค่านี้เมื่อผู้ใช้ถามเกี่ยวกับการจราจร ความแออัด หรือเวลาในการเปลี่ยนเส้นทางที่ปรับตามการจราจรเท่านั้น ซึ่งจะทำให้เกิดเวลาในการตอบสนองที่สูงขึ้น
  5. include_extended_details (บูลีน - ไม่บังคับ): ตั้งค่าเป็น true เฉพาะเมื่อคำขอต้องการข้อมูลเชิงลึกเกี่ยวกับรีวิวเชิงคุณภาพ รายการเมนูหรือข้อเสนอที่เฉพาะเจาะจง บรรยากาศ เคล็ดลับสำหรับผู้เข้าชมหรือปริมาณผู้เข้าใช้บริการ ความพร้อมใช้งานของที่ชาร์จ EV ราคาน้ำมัน หรือรายละเอียดเชิงคุณภาพอื่นๆ ที่สมบูรณ์ ค่าเริ่มต้นคือ false การเปิดใช้ฟีเจอร์นี้อาจเพิ่มเวลาในการตอบสนอง

  6. language_code (สตริง - ไม่บังคับ): ภาษาสำหรับสรุปผลการค้นหาและรายละเอียดสถานที่ เช่น en, ja, en-US ค่าเริ่มต้นคือ en-US

  7. region_code (สตริง - ไม่บังคับ): รหัสภูมิภาค CLDR ของ Unicode ของผู้ใช้ เช่น US, CA

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

  • ผลลัพธ์แต่ละรายการจะมี detour_summary (หากมี) ซึ่งอธิบายระยะทางเพิ่มเติม (localized_detour_distance) และเวลาเพิ่มเติม (detour_duration) ที่เกิดขึ้นจากการแวะที่สถานที่นั้น เว้นแต่จะมีการระบุเส้นทางเป็น encoded_polyline ใช้เพื่อเปรียบเทียบตัวเลือกต่างๆ
  • คำตอบ summary อาจมีการอ้างอิงแบบอิงตามศูนย์ (เช่น "[0]") ที่อ้างอิงรายการใน results
  • เอาต์พุตที่มีการระบุแหล่งที่มาต้องระบุแหล่งที่มาโดยใช้ฟิลด์ attribution ของ results[].place แต่ละรายการ (หากมี)
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
}'