นี่คือเซิร์ฟเวอร์ 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 ข้อกำหนดในการป้อนข้อมูล (สำคัญ):
วิธีการเรียกใช้เครื่องมือ
|
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 |
คำนวณเส้นทางการเดินทางระหว่างต้นทางและปลายทาง โดยอาจผ่านจุดแวะพักระหว่างทาง แสดงระยะทางและระยะเวลาของแต่ละเส้นทาง ข้อกำหนดในการป้อนข้อมูล (สำคัญ):
วิธีการเรียกใช้เครื่องมือ
ตัวอย่างการเรียกใช้เครื่องมือ: {"origin":{"address":"หอไอเฟล"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"พิพิธภัณฑ์ลูฟวร์"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} วิธีการตอบกลับ
|
search_along_route |
เรียกใช้เครื่องมือนี้เมื่อผู้ใช้ต้องการค้นหาสถานที่ ธุรกิจ หรือจุดที่น่าสนใจตามเส้นทางการเดินทาง (เช่น "ปั๊มน้ำมันระหว่างทางไป Tahoe" "ร้านกาแฟระหว่าง SF กับ San Jose") การเรียกใช้เครื่องมือนี้มีค่าใช้จ่ายสูงกว่า ข้อกำหนดในการป้อนข้อมูล (สำคัญ):
วิธีการเรียกใช้เครื่องมือ
|
resolve_names |
แปลงรายการคำค้นหาสถานที่ที่เฉพาะเจาะจง (ชื่อจุดสังเกตหรือที่อยู่ที่แน่นอน) เป็นรหัสสถานที่ Canonical ของ Google Maps ข้อกำหนดในการป้อนข้อมูล (สำคัญ):
วิธีการเรียกใช้เครื่องมือ
บันทึกลงใน Google Maps
การจัดการข้อผิดพลาด (สำคัญ):
|
resolve_maps_urls |
แปลงรายการ URL ของ Google Maps เป็นรหัสสถานที่ Canonical ของ Google Maps กรณีที่ควรเรียกใช้เครื่องมือนี้ (สำคัญ):
ข้อกำหนดในการป้อนข้อมูล (สำคัญ):
บันทึกลงใน Google Maps
การจัดการข้อผิดพลาด (สำคัญ):
|
ดูข้อกำหนดเฉพาะของเครื่องมือ 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 }' |