เครื่องมือ Agent สำหรับ Maps Experience (เดิมชื่อ Maps Grounding Lite) เป็นบริการของ Google Maps Platform ที่รองรับ Model Context Protocol (MCP) และ REST เพื่อใช้ข้อมูลเชิงพื้นที่ที่เชื่อถือได้จาก Google Maps เป็นข้อมูลอ้างอิงสำหรับแอปพลิเคชัน AI ของคุณ เครื่องมือของ API นี้ช่วยให้ LLM เข้าถึงข้อมูลสถานที่ สภาพอากาศ คุณภาพอากาศ ละอองเกสรดอกไม้ และเส้นทางได้ เครื่องมืออื่นๆ จะแปลงชื่อสถานที่และ URL ของ Google Maps เป็นรหัสสถานที่ คุณลองใช้เครื่องมือ Agent สำหรับ Maps Experience ได้โดยเปิดใช้เซิร์ฟเวอร์ MCP ในเครื่องมือที่รองรับเซิร์ฟเวอร์ MCP นอกจากนี้ คุณยังเรียกใช้เครื่องมือแต่ละรายการเป็นเมธอด REST ได้ด้วย โปรดดูรายละเอียดที่หัวข้อเรียกใช้เครื่องมือด้วย REST
เครื่องมือ Agent สำหรับ Maps Experience เป็นผลิตภัณฑ์เดียวที่มี SKU 2 รายการ ได้แก่ Essentials และ Pro ระบบจะเรียกเก็บเงินสำหรับคำขอทุกรายการภายใต้ Essentials เว้นแต่จะใช้ตัวเลือก Pro ตัวเลือก Pro จะเพิ่มการค้นหาสถานที่ตามเส้นทาง รายละเอียดสถานที่ที่ขยาย สถานที่ต่อการค้นหามากขึ้น จุดแวะพักระหว่างทางต่อเส้นทางมากขึ้น การกำหนดเส้นทางพร้อมการจราจรแบบเรียลไทม์ การพยากรณ์ละอองเกสร และคุณภาพอากาศในอดีต SKU ทั้ง 2 รายการใช้เครื่องมือ, เซิร์ฟเวอร์ MCP, เมธอด REST และข้อมูลเข้าสู่ระบบเดียวกัน โปรดดูรายละเอียดที่หัวข้อ Essentials และ Pro
เครื่องมือ
เครื่องมือ Agent สำหรับ Maps Experience ช่วยให้ LLM เข้าถึงความสามารถต่อไปนี้ของ Google Maps ได้
- ค้นหาสถานที่: ขอข้อมูลเกี่ยวกับสถานที่และรับข้อมูลสรุปที่ AI สร้างขึ้น การตอบกลับยังรวมถึงรหัสสถานที่ พิกัดละติจูด/ลองจิจูด และลิงก์ Google Maps สำหรับสถานที่แต่ละแห่งในข้อมูลสรุปด้วย คุณสามารถใช้รหัสสถานที่และพิกัดละติจูด/ลองจิจูดกับ Google Maps Platform API อื่นๆ เพื่อแสดงสถานที่บนแผนที่ได้ หากต้องการแสดงสถานที่เหล่านี้ด้วย Places UI Kit โดยไม่มีค่าใช้จ่ายเพิ่มเติม ให้ใช้โทเค็นการแสดงข้อมูลผ่านภาพแบบ Agentic (เวอร์ชันตัวอย่าง) เมื่อใช้ Pro คุณจะขอรายละเอียดสถานที่เพิ่มเติมได้ เช่น ข้อมูลเชิงลึกจากรีวิว และขอสถานที่ได้สูงสุด 10 แห่งต่อคำขอ
- ค้นหาตามเส้นทาง:
ค้นหาสถานที่ตามเส้นทางการเดินทาง ซึ่งระบุโดยใช้
retrieval_tokenจากcompute_routes,route_endpointsหรือencoded_polylineและรับข้อมูลสรุปที่ AI สร้างขึ้น รายละเอียดสถานที่ ระยะทางและระยะเวลาเดินทางที่อ้อม และโทเค็นการแสดงข้อมูลผ่านภาพแบบ Agentic (เวอร์ชันตัวอย่าง) ระบบจะเรียกเก็บเงินสำหรับคำขอsearch_along_routeทุกรายการภายใต้ SKU ระดับ Pro - ค้นหาสภาพอากาศ: ขอข้อมูลสภาพแวดล้อมของสถานที่หนึ่งๆ ซึ่งรวมถึงสภาพอากาศ (สภาพอากาศปัจจุบัน ประวัติรายชั่วโมงตลอด 24 ชั่วโมง และพยากรณ์อากาศรายชั่วโมงและรายวันสูงสุด 10 วัน) และคุณภาพอากาศปัจจุบันหรือพยากรณ์อากาศสูงสุด 4 วัน นอกจากนี้ เมื่อใช้ Pro คุณยังสามารถขอการพยากรณ์ละอองเกสรรายวันสูงสุด 5 วัน (พร้อมรายละเอียดชนิดพันธุ์พืช) และประวัติคุณภาพอากาศรายชั่วโมงสูงสุด 30 วันได้ด้วย
คำนวณเส้นทาง: ขอเส้นทางระหว่างต้นทางและปลายทาง โดยอาจผ่านจุดแวะพักระหว่างทาง และแสดงระยะทาง ระยะเวลา และ
retrievalTokenสำหรับเส้นทางDRIVEที่คุณสามารถส่งไปยังsearch_along_routeเมื่อใช้ Pro เส้นทางจะพิจารณาสภาพการจราจรแบบเรียลไทม์และรวมจุดแวะพักระหว่างทางได้มากขึ้นแปลงชื่อ และ แปลง URL ของ Maps: แปลงชื่อสถานที่ ที่อยู่ และ URL ของ Google Maps เป็นรหัสสถานที่ ดูข้อมูลเพิ่มเติมได้ที่ Resolution API
หลังจากเปิดใช้เซิร์ฟเวอร์ MCP แล้ว LLM จะเรียกใช้เครื่องมือของเซิร์ฟเวอร์เพื่อรับข้อมูลที่อิงตามความเป็นจริงสำหรับข้อมูลประเภทเหล่านี้ได้ LLM สามารถใช้ข้อมูลนี้เป็นบริบทได้ อย่างไรก็ตาม คำตอบสุดท้ายอาจไม่มีข้อมูลที่ตรงกับที่เซิร์ฟเวอร์ MCP แสดงผล ตรวจสอบความถูกต้องของคำตอบที่สร้างขึ้น
Essentials และ Pro
Essentials และ Pro เป็น SKU 2 รายการของผลิตภัณฑ์เดียวกัน ไม่ใช่ผลิตภัณฑ์หรือแพ็กเกจที่แยกกัน ระบบจะเรียกเก็บเงินคำขอภายใต้ Pro เมื่อใช้ตัวเลือก Pro ส่วนคำขออื่นๆ ทั้งหมดจะเรียกเก็บเงินภายใต้ Essentials ตัวเลือก Pro เป็นช่องธรรมดาในคำขอเครื่องมือ ดังนั้น LLM จึงใช้ตัวเลือกเหล่านี้ในนามของคุณได้ นอกจากนี้ ตัวแทนยังใช้ SKU ทั้ง 2 รายการในการสนทนาเดียวกันได้ด้วย เช่น ตัวแทนอาจใช้ Essentials เพื่อค้นหาร้านกาแฟใกล้สถานที่สำคัญ จากนั้นอาจใช้ Pro เพื่อตอบคำถามติดตามผลเกี่ยวกับเครื่องดื่มซิกเนเจอร์และที่นั่ง ไม่มีเซิร์ฟเวอร์ MCP, ปลายทาง หรือข้อมูลเข้าสู่ระบบแยกต่างหากสำหรับ Pro
เปรียบเทียบ Essentials, Pro และการเชื่อมต่อแหล่งข้อมูลกับ Google Maps
การเชื่อมต่อแหล่งข้อมูลกับ Google Maps เป็นผลิตภัณฑ์แยกต่างหาก โดยจะติดตั้งมาพร้อมกับโมเดล Gemini ใน Gemini API, Google AI Studio และ Gemini Enterprise Agent Platform โมเดลจะตัดสินใจว่าจะค้นหา Google Maps เมื่อใด และแสดงคำตอบที่มีข้อมูลอ้างอิงพร้อมการอ้างอิง เลือกการเชื่อมต่อแหล่งข้อมูลกับ Google Maps เมื่อคุณสร้างบน Gemini และต้องการให้โมเดลจัดการการเชื่อมต่อแหล่งข้อมูล เลือกเครื่องมือ Agent สำหรับ Maps Experience สำหรับโมเดลหรือเฟรมเวิร์ก Agent อื่นๆ หรือสำหรับการควบคุมการเรียกใช้เครื่องมือแต่ละรายการโดยตรง
ตารางต่อไปนี้เปรียบเทียบ SKU Essentials, SKU Pro และการเชื่อมต่อแหล่งข้อมูลกับ Google Maps
| เครื่องมือ Agent สำหรับ Maps Experience | การเชื่อมต่อแหล่งข้อมูลกับ Google Maps | ||
|---|---|---|---|
| SKU รุ่น Essentials (เดิมชื่อ Maps Grounding Lite) |
SKU ของ Pro | ||
| วิธีเรียกเก็บเงินสำหรับคำขอ | คำขอเครื่องมือแต่ละรายการที่ไม่ได้ใช้ตัวเลือก Pro | คำขอ search_along_route ทุกรายการ หรือคำขอใดๆ ไปยังเครื่องมืออื่นที่ใช้ตัวเลือก Pro ดูรายการที่เรียกเก็บเงินภายใต้ SKU รุ่น Pro |
คำค้นหา Google Maps หรือพรอมต์ที่อิงตามข้อมูลจริงแต่ละรายการ โดยขึ้นอยู่กับแพลตฟอร์มและโมเดล |
| โมเดลและแพลตฟอร์ม | เฟรมเวิร์กโมเดลหรือ Agent ที่รองรับ MCP หรือเรียกใช้ REST API ได้ ใช้เครื่องมือชุดเดียวและข้อมูลเข้าสู่ระบบเดียวกันสำหรับ SKU ทั้ง 2 รายการ | โมเดล Gemini ใน Gemini API, Google AI Studio และแพลตฟอร์ม Agent ของ Gemini Enterprise | |
| สิ่งที่เครื่องมือแสดงผล | ข้อมูลสำคัญ: รายละเอียดสถานที่สูงสุด 5 แห่งต่อการค้นหา ระยะทางและระยะเวลาของเส้นทางโดยไม่มีการจราจรแบบเรียลไทม์ สภาพอากาศปัจจุบันและการพยากรณ์อากาศ (รวมถึงประวัติสภาพอากาศรายชั่วโมงตลอด 24 ชั่วโมง) และคุณภาพอากาศปัจจุบันหรือที่พยากรณ์ไว้ | ทุกอย่างใน Essentials รวมถึงสถานที่ตามเส้นทางพร้อมเวลาและระยะทางในการอ้อม รายละเอียดสถานที่เพิ่มเติม (เช่น ข้อมูลเชิงลึกจากรีวิว) สถานที่สูงสุด 10 แห่งต่อการค้นหา เส้นทางที่มีการจราจรแบบเรียลไทม์ จุดอ้างอิงระหว่างทางสูงสุด 25 จุด การพยากรณ์ละอองเกสร และคุณภาพอากาศย้อนหลังสูงสุด 30 วัน | รายละเอียดสถานที่และข้อมูลเชิงลึกจากรีวิว รวมถึงข้อมูลเส้นทางพร้อมการจราจรแบบเรียลไทม์ |
| ตัวอย่างคำขอ | คำถามเกี่ยวกับข้อเท็จจริงและโลจิสติกส์: การค้นหาร้านค้าหรือธุรกิจ เวลาทำการ ที่อยู่ ระยะทางหรือระยะเวลาเดินทางโดยประมาณ สภาพอากาศปัจจุบัน พยากรณ์อากาศ 10 วัน และพยากรณ์คุณภาพอากาศปัจจุบันหรือ 4 วัน | คำถามเชิงอัตวิสัย คำถามกว้างๆ หรือคำถามเฉพาะทาง: สถานที่ตามเส้นทาง บรรยากาศ อาหารจานเด่น เคล็ดลับสำหรับผู้เข้าชม การเปรียบเทียบสถานที่ 6-10 แห่ง ระยะเวลาเดินทางในสภาพการจราจรปัจจุบัน การพยากรณ์ละอองเกสรและภูมิแพ้ และประวัติคุณภาพอากาศในช่วง 30 วันที่ผ่านมา | การค้นหาแบบสนทนา การวางแผนกำหนดการเดินทาง และการสำรวจสถานที่ในพื้นที่ใน Gemini |
| การแสดงภาพ Places UI Kit | รวมอยู่ในโทเค็นการแสดงข้อมูลเป็นภาพแบบ Agentic (เวอร์ชันตัวอย่าง) โดยไม่มีค่าใช้จ่ายเพิ่มเติม | เรียกเก็บเงินแยกกัน | |
| การใช้งานรายเดือนโดยไม่มีค่าใช้จ่าย | คำขอ 10,000 รายการ | คำขอ 5,000 รายการ | ขึ้นอยู่กับแพลตฟอร์มและโมเดล ตัวอย่างเช่น ใน Gemini API, Gemini 3 และโมเดลที่ใหม่กว่าจะรวมคำค้นหา 5,000 รายการต่อเดือนโดยไม่มีค่าใช้จ่าย หลังจากนั้น คำค้นหาจะมีค่าใช้จ่าย $14 ต่อ 1,000 รายการ |
| ราคาแบบจ่ายเมื่อใช้ | $7.00 ต่อคำขอ 1,000 รายการ พร้อมส่วนลดตามปริมาณ | $14.00 ต่อคำขอ 1,000 รายการ พร้อมส่วนลดตามปริมาณ | |
| สมัครใช้บริการเพื่อประหยัด | รวมอยู่ในแพ็กเกจ Essentials และ Pro | รวมอยู่ในแพ็กเกจ Pro | ไม่พร้อมใช้งาน |
| เริ่มต้นใช้งาน | การตั้งค่าเดียวสำหรับทั้ง 2 SKU: ดูหัวข้อกำหนดค่า LLM ให้ใช้เซิร์ฟเวอร์ MCP หรือเรียกใช้เครื่องมือด้วย REST | Gemini API หรือ Agent Platform | |
ตัวเลือกเหล่านี้ทำงานในลักษณะเดียวกันกับ SKU ทั้ง 2 รายการ ได้แก่ รูปแบบการเดินทาง เวลาออกเดินทางและเวลาถึง เส้นทางอื่น เส้นประกอบของเส้นทาง การค้นหาสภาพอากาศ การค้นหาคุณภาพอากาศปัจจุบันและการพยากรณ์คุณภาพอากาศ (รวมถึงความเข้มข้นของสารมลพิษและระดับ AQI ในพื้นที่) ระบบหน่วยวัดสภาพอากาศ และ Resolution API แต่จะไม่เปลี่ยน SKU ที่ใช้เรียกเก็บเงินสำหรับคำขอ
รายการที่เรียกเก็บเงินภายใต้ SKU ของ Pro
ตารางต่อไปนี้จะสรุปความสามารถที่รวมอยู่ใน Essentials และความสามารถที่ต้องใช้ SKU ของ Pro
| เครื่องมือ | ความสามารถ | Essentials | Pro |
|---|---|---|---|
| ค้นหาสถานที่ | สถานที่ต่อคำขอ | สูงสุด 5 รายการ | 6 ถึง 10 (page_size จาก 6 ถึง 10) |
| รายละเอียดสถานที่เพิ่มเติมในข้อมูลสรุปการค้นหา (ข้อมูลเชิงลึกจากรีวิว ไฮไลต์เมนู บรรยากาศ ความพลุกพล่านของสถานที่ เคล็ดลับสำหรับผู้เข้าชม และระยะทางหรือระยะเวลาเดินทางสำหรับการค้นหาความใกล้ชิด) | ไม่พร้อมใช้งาน | พร้อมให้บริการใน include_extended_details |
|
| ค้นหาบนเส้นทาง | สถานที่ตามเส้นทาง ระยะทางและระยะเวลาเดินทางของทางอ้อม และรายละเอียดสถานที่เพิ่มเติมหรือเวลาของทางอ้อมที่คำนึงถึงการจราจร (ไม่บังคับ) | ไม่พร้อมใช้งาน | ทุกคำขอ |
| คำนวณเส้นทาง | ค่ากำหนดการกำหนดเส้นทาง | ไม่พิจารณาการจราจรแบบเรียลไทม์ | พิจารณาการจราจรแบบเรียลไทม์หรือข้อมูลขนส่งสาธารณะแบบเรียลไทม์สำหรับเส้นทางขนส่งสาธารณะด้วย ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL |
| จุดอ้างอิงระดับกลางต่อเส้นทาง | สูงสุด 10 วินาที | 11 ถึง 25 (มากกว่า 10 intermediate_waypoints) |
|
| ค้นหาสภาพอากาศ | สภาพอากาศ | สภาพอากาศปัจจุบัน พยากรณ์อากาศรายชั่วโมงและรายวัน (สูงสุด 10 วัน) และประวัติรายชั่วโมงสูงสุด 24 ชั่วโมง (WEATHER ใน capabilities หรือคำขอเดิมที่ละเว้น capabilities, weather_options, air_quality_options และ language_code) |
ไม่มีตัวเลือก Pro (ข้อมูล WEATHER ทั้งหมดรวมอยู่ใน Essentials) |
| คุณภาพอากาศ | สภาพอากาศปัจจุบัน ผลลัพธ์รายชั่วโมงตลอดทั้งวันของวันนี้ และพยากรณ์อากาศรายชั่วโมงสูงสุด 4 วัน (AIR_QUALITY ใน capabilities) |
คุณภาพอากาศในอดีตสูงสุด 30 วันที่ผ่านมา (AIR_QUALITY ใน capabilities ที่มี date ก่อนวันนี้หรือ hour ที่ผ่านมาในเขตเวลาของสถานที่) เมื่อแสดงในคำตอบ |
|
| ละอองเกสร | ไม่พร้อมใช้งาน | การคาดการณ์ละอองเกสรรายวันสูงสุด 5 วันและรายละเอียดชนิดพันธุ์พืช (POLLEN ใน capabilities) เมื่อแสดงในคำตอบ |
|
| Resolution API | ไม่มีตัวเลือก Pro ระบบจะเรียกเก็บเงินคำขอทั้งหมดภายใต้ SKU Places API การค้นหาข้อความ Search Essentials (รหัสเท่านั้น) โดยไม่มีค่าใช้จ่าย | ||
ดูตัวเลือกคำขอที่เปิดใช้ความสามารถแต่ละอย่างได้ที่ค้นหาสถานที่, ค้นหาตามเส้นทาง, คำนวณเส้นทาง และค้นหาสภาพอากาศ
ควบคุมการใช้งาน Pro
ตัวเลือกระดับโปรจะปิดอยู่โดยค่าเริ่มต้นใน search_places, compute_routes และ lookup_weather LLM จะตั้งค่าหรือเรียกใช้ search_along_route เมื่อคำขอของผู้ใช้เรียกใช้ และคำอธิบายเครื่องมือหรือวิธีการของคุณอนุญาต
คำอธิบายเครื่องมือจะบอกโมเดลว่าตัวเลือกใดมีค่าใช้จ่ายมากกว่าและควรใช้เมื่อใด เช่น page_size ที่มากกว่า 5, รายละเอียดสถานที่แบบขยาย, จุดอ้างอิงระดับกลางมากกว่า 10 จุด, การกำหนดเส้นทางที่คำนึงถึงการจราจร และsearch_along_route หากคุณเรียกใช้เครื่องมือด้วย REST โค้ดของคุณจะตั้งค่าทุกตัวเลือก วิธีจัดการค่าใช้จ่าย
- บอกโมเดลว่าตัวเลือก Pro เหมาะสมเมื่อใด เช่น "ตั้งค่า
include_extended_detailsเฉพาะเมื่อผู้ใช้ถามเกี่ยวกับรีวิว เมนู หรือบรรยากาศ" หรือ "ใช้ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMALเฉพาะเมื่อผู้ใช้ถามถึงระยะเวลาเดินทางปัจจุบัน" หรือ "เรียกใช้search_along_routeเฉพาะเมื่อผู้ใช้ถามหาสถานที่ตามเส้นทาง" หรือ "รวมPOLLENหรือAIR_QUALITYพร้อมdateหรือhourในอดีต เฉพาะเมื่อผู้ใช้ถามเกี่ยวกับละอองเกสร อาการแพ้ หรือคุณภาพอากาศในอดีต" - หากต้องการให้ Agent ใช้ SKU Essentials ให้สั่งโมเดลไม่ให้เรียกใช้
search_along_routeหรือใช้ตัวเลือก Pro ตัวเลือก Pro ได้แก่include_extended_details,page_sizeที่มากกว่า 5,ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, จุดอ้างอิงระดับกลางมากกว่า 10 จุด,POLLENในcapabilitiesและdateหรือhourที่ผ่านมาพร้อมAIR_QUALITYในcapabilitiesหากไคลเอ็นต์ MCP สามารถจำกัดเครื่องมือหรืออาร์กิวเมนต์ของเครื่องมือได้ คุณก็บล็อกsearch_along_routeและค่าอาร์กิวเมนต์เหล่านั้นในการกำหนดค่าเครื่องมือได้ด้วย - ตรวจสอบ SKU ของ Maps Grounding Pro ในรายงานการเรียกเก็บเงินและตั้งค่าการแจ้งเตือนงบประมาณ
Resolution API
เครื่องมือ Agent สำหรับ Maps Experience มี Resolution API โดยจะแปลงข้อความตำแหน่งและ URL ในรูปแบบอิสระเป็นตัวระบุสถานที่ใน Google Maps ที่มีโครงสร้าง Resolution API พร้อมใช้งานเป็นเมธอด REST และเป็นเครื่องมือในเซิร์ฟเวอร์ MCP ดังนี้
- แปลงชื่อ (REST, MCP): แปลงชื่อหรือที่อยู่ของสถานที่หลายรายการเป็นเอนทิตีสถานที่ที่เฉพาะเจาะจงใน Google Maps เครื่องมือนี้ช่วยเชื่อมโยงคำค้นหาที่ไม่มีโครงสร้างของผู้ใช้กับรหัสสถานที่ที่เสถียร
- Resolve Maps URLs (REST, MCP): แปลงกลุ่ม URL ของ Google Maps เป็นเอนทิตีสถานที่ที่เฉพาะเจาะจง รูปแบบที่รองรับ ได้แก่ URL ของสถานที่มาตรฐานและ URL แบบย่อ
คุณใช้รหัสสถานที่ที่แสดงผลกับ Google Maps Platform API อื่นๆ ได้ คำตอบแต่ละรายการยังมีลิงก์ที่บันทึกสถานที่ที่แก้ไขแล้วเป็นรายการใน Google Maps ด้วย
ดูข้อมูลเพิ่มเติมได้ที่ Maps Tools Resolution API
ลองใช้แอปตัวอย่าง (เปิดในแท็บใหม่)
การเรียกเก็บเงินและโควต้า
วิธีเรียกเก็บเงินจากคุณ
เมื่อใช้รูปแบบการกำหนดราคาแบบจ่ายเมื่อใช้ของ Google Maps Platform ระบบจะคำนวณการใช้งานเครื่องมือ Agent สำหรับ Maps Experience สำหรับคำขอแต่ละรายการ คำขอแต่ละรายการแสดงถึงเหตุการณ์การเรียกเก็บเงิน 1 รายการ ระบบจะติดตามการใช้งานสำหรับ SKU ของผลิตภัณฑ์แต่ละรายการ ใบแจ้งหนี้จะแสดงบรรทัดรายการสำหรับ SKU แต่ละรายการนอกเหนือจากค่าบริการทั้งหมด ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการรายงาน
คำขอการค้นหาสถานที่ ค้นหาตามเส้นทาง คำนวณเส้นทาง หรือค้นหาสภาพอากาศแต่ละรายการผ่านเซิร์ฟเวอร์ MCP หรือด้วย REST จะเรียกเก็บเงินภายใต้ SKU เดียว ได้แก่
Maps Grounding Essentials
หรือ
Maps Grounding Pro
ระบบจะเรียกเก็บเงินคำขอ search_along_route ทุกรายการและคำขอที่ใช้ตัวเลือก Pro ภายใต้ SKU ของ Pro ระบบจะไม่เรียกเก็บเงินสำหรับคำขอภายใต้ SKU ทั้ง 2 รายการ และจำนวนตัวเลือก Pro ในคำขอจะไม่เปลี่ยนแปลงค่าใช้จ่าย ดูความสามารถและตัวเลือกที่กำหนด SKU สำหรับเครื่องมือแต่ละรายการได้ที่หัวข้อรายการที่เรียกเก็บเงินภายใต้ SKU เวอร์ชัน Pro
คำขอ Maps Grounding Essentials จะเรียกเก็บเงินที่ $7.00 ต่อ 1,000 คำขอหลังจาก 10,000 คำขอแรกในแต่ละเดือน คำขอ Maps Grounding Pro จะเรียกเก็บเงินที่ $14.00 ต่อ 1,000 คำขอหลังจาก 5,000 คำขอแรกในแต่ละเดือน SKU ทั้ง 2 รายการมีส่วนลดตามปริมาณสำหรับการใช้งานรายเดือนที่สูงขึ้น
ดูรายละเอียดราคาได้ที่ตารางราคาหลักและตารางราคาสำหรับอินเดีย
ระบบจะเรียกเก็บเงินสำหรับคำขอ Resolution API (ResolveNames และ ResolveMapsUrls) โดยไม่มีค่าใช้จ่ายภายใต้ SKU Places API Text Search Essentials (รหัสเท่านั้น)
หากแสดงสถานที่จากการตอบกลับ search_places หรือ search_along_route ด้วย Places UI Kit คุณสามารถใช้โทเค็นการแสดงข้อมูลผ่านภาพแบบ Agentic (เวอร์ชันตัวอย่าง) เพื่อไม่ให้ระบบเรียกเก็บเงินสำหรับคำขอ Places UI Kit เหล่านั้น
การใช้งาน SKU Essentials รวมอยู่ในแพ็กเกจ Essentials และ Pro สมัครใช้บริการเพื่อประหยัด ส่วนการใช้งาน SKU Pro รวมอยู่ในแพ็กเกจ Pro
โควต้า
โควต้าต่อไปนี้มีผลกับเครื่องมือและ API ที่เครื่องมือ Agent สำหรับ Maps Experience มีให้
- ค้นหาสถานที่: การค้นหา 300 ครั้งต่อนาทีสำหรับแต่ละโปรเจ็กต์
- ค้นหาตามเส้นทาง: การค้นหา 300 ครั้งต่อนาทีสำหรับแต่ละโปรเจ็กต์
- ค้นหาสภาพอากาศ: การค้นหา 300 ครั้งต่อนาทีสำหรับแต่ละโปรเจ็กต์
- คำนวณเส้นทาง: คำค้นหา 300 รายการต่อนาทีสำหรับแต่ละโปรเจ็กต์
- Resolve names: การค้นหา 600 ครั้งต่อนาทีสำหรับแต่ละโปรเจ็กต์
- Resolve Maps URLs: การค้นหา 600 ครั้งต่อนาทีสำหรับแต่ละโปรเจ็กต์
ระบบจะนับโควต้าสำหรับเครื่องมือแต่ละรายการ และแชร์โดย SKU Essentials และ Pro คำขอ Pro จะใช้โควต้าเดียวกับคำขอ Essentials สำหรับเครื่องมือเดียวกัน
คำขอ Resolution API แต่ละรายการจะนับเป็น 1 คำค้นหา ไม่ว่าจะมีรายการกี่รายการก็ตาม
นโยบายและข้อกำหนดในการให้บริการ
เครื่องมือ Agent สำหรับ Maps Experience อยู่ภายใต้ข้อกำหนดในการให้บริการของ Google Maps Platform รวมถึงข้อกำหนดเฉพาะบริการ ส่วนนี้อธิบายข้อกำหนดการใช้งานเพิ่มเติมสำหรับเครื่องมือตัวแทน Maps Experience ซึ่งรวมถึง LLM ที่เข้ากันได้และการระบุแหล่งที่มา ข้อกำหนดเหล่านี้มีผลกับผลลัพธ์ทั้งหมด ไม่ว่าจะเรียกเก็บเงินคำขอภายใต้ SKU ใดก็ตาม
ข้อกำหนดสำหรับ LLM ที่เข้ากันได้
คุณสามารถใช้เครื่องมือ Agent สำหรับ Maps Experience กับ LLM ที่เป็นไปตามข้อกำหนดในการให้บริการของ Google Maps Platform เท่านั้น
ตัวอย่างเช่น คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าเนื้อหา Google Maps ไม่ได้ถูกแคช จัดเก็บ หรือใช้เพื่อปรับปรุง LLM ที่คุณเลือกใช้ ก่อนใช้เครื่องมือ Agent สำหรับ Maps Experience คุณจะต้องอ่านข้อกำหนดในการให้บริการของโมเดลที่ต้องการใช้กับเครื่องมือ Agent สำหรับ Maps Experience คุณต้องไม่ใช้เครื่องมือ Agent ของ Maps Experience กับโมเดลใดๆ ที่ใช้ข้อมูลที่ป้อนลงในโมเดลเพื่อการฝึกหรือปรับปรุงโมเดล คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าการใช้โมเดลเป็นไปตามข้อจำกัดเกี่ยวกับเนื้อหาของ Google Maps ในข้อกำหนดในการให้บริการของ Google Maps Platform อย่างเต็มรูปแบบ ซึ่งรวมถึงข้อกำหนดเฉพาะของบริการ
ข้อกำหนดการระบุแหล่งที่มาสำหรับแหล่งที่มาของ Google Maps
การตอบกลับของเครื่องมือแต่ละรายการจากเครื่องมือ Agent สำหรับ Maps Experience จะมีแหล่งที่มา เมื่อแสดงผลลัพธ์จากเครื่องมือ Agent สำหรับ Maps Experience คุณต้องระบุแหล่งที่มาของ Google Maps ที่เกี่ยวข้องและปฏิบัติตามข้อกำหนดต่อไปนี้
- แหล่งที่มาของ Google Maps ต้องอยู่ต่อจากเนื้อหาที่สร้างขึ้นซึ่งแหล่งที่มานั้นรองรับทันที เนื้อหาที่สร้างขึ้นนี้เรียกอีกอย่างว่าเอาต์พุตที่อิงตามข้อมูลจริง
- แหล่งที่มาของ Google Maps ต้องดูได้ภายในการโต้ตอบของผู้ใช้ 1 ครั้ง
แหล่งที่มาของเครื่องมือค้นหาสถานที่และค้นหาตามเส้นทาง
ช่อง places ของเครื่องมือ search_places และช่อง results[].place ของเครื่องมือ search_along_route จะแสดงแหล่งข้อมูลที่สนับสนุน summary ระบบจะแสดงข้อมูลเมตาต่อไปนี้สำหรับสถานที่แต่ละแห่ง
place(ชื่อทรัพยากร)idlocationgoogleMapsLinksattribution
คุณต้องสร้างตัวอย่างลิงก์ที่ตรงตามข้อกำหนดต่อไปนี้สำหรับแต่ละสถานที่
- ระบุแหล่งที่มาแต่ละแหล่งให้กับ Google Maps โดยทำตามหลักเกณฑ์การระบุแหล่งที่มาของข้อความสำหรับเครื่องมือ Agent ของ Maps Experience
- ลิงก์ไปยังแหล่งที่มาโดยใช้
googleMapsLinks.placeUrlจากคำตอบ
ข้อกำหนดเหล่านี้ยังมีผลกับข้อมูลสรุปที่มีรายละเอียดสถานที่เพิ่มเติมจาก Pro เช่น ข้อมูลเชิงลึกจากรีวิว summary จะอ้างอิงสถานที่แต่ละแห่งด้วยดัชนีแบบ Zero-Based เช่น [0] ซึ่งแมปกับรายการใน places หรือ results
สถานที่แต่ละแห่งยังมี googleMapsLinks.reviewsUrl ซึ่งลิงก์ไปยังรีวิวของสถานที่นั้นใน Google Maps ด้วย ผู้ใช้สามารถติดตามเพื่อดูรีวิวที่อยู่เบื้องหลังข้อมูลเชิงลึกได้
อินเทอร์เฟซที่เน้นเสียงเป็นหลัก
หากแอปแสดงผลลัพธ์ของเครื่องมือ Agent สำหรับ Maps Experience ด้วยเสียง คุณต้องปฏิบัติตามข้อกำหนดสำหรับอินเทอร์เฟซที่เน้นเสียงเป็นหลักด้วย สรุป
- การจัดหา: แสดงแหล่งที่มาของ Google Maps ใน UI ที่แสดงร่วมซึ่งแสดงบันทึกย้อนหลังแบบคำต่อคำของการสนทนาด้วยเสียง
- การเปิดเผยข้อมูลอย่างชัดเจน: แจ้งให้ผู้ใช้ทราบในขณะที่มีการโต้ตอบว่าเนื้อหาที่ AI สร้างขึ้นอาจมีข้อมูลจาก Google Maps นอกจากนี้ ให้บอกผู้ใช้ด้วยว่าแหล่งข้อมูลโดยละเอียดมีอยู่ใน UI ของ Companion คุณทำได้บนหน้าจอหรือใช้เสียงพูด
- การเปิดเผยข้อมูลอย่างต่อเนื่อง: แสดงคำอธิบายอย่างต่อเนื่อง เช่น ในเมนูการตั้งค่าเสียง ว่าเนื้อหาที่ AI สร้างขึ้นอาจรวมถึงเนื้อหา Google Maps
- คำถามของผู้ใช้: ตอบคำถามของผู้ใช้เกี่ยวกับแหล่งที่มาของเนื้อหาอย่างถูกต้อง และนำผู้ใช้ไปยัง UI ของแอปที่ใช้ร่วมกันเพื่อดูรายละเอียด
กำหนดค่า LLM ให้ใช้เซิร์ฟเวอร์ MCP
หากต้องการใช้เครื่องมือ Agent สำหรับ Maps Experience คุณต้องมีโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ที่เปิดใช้บริการ API เครื่องมือ Agent สำหรับ Maps Experience นอกจากนี้ คุณยังต้องมีคีย์ API หรือรหัสไคลเอ็นต์ OAuth ด้วย จากนั้นคุณจะกำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ได้ เซิร์ฟเวอร์ MCP ใช้การส่งผ่าน HTTP ที่สตรีมได้
เปิดใช้เครื่องมือ Agent สำหรับ Maps Experience ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
วิธีเปิดใช้ API ในโปรเจ็กต์
- ในคอนโซล Google Cloud ให้เลือกโปรเจ็กต์ที่ต้องการใช้สำหรับเครื่องมือ Agent สำหรับ Maps Experience
- เปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ในคอนโซล Google Cloud
- เปิดใช้เครื่องมือ Agent สำหรับ Maps Experience ในคลัง API ของคอนโซล Google Cloud
ตรวจสอบสิทธิ์โดยใช้คีย์ API
คุณสามารถใช้คีย์ API ที่มีอยู่กับเครื่องมือ Agent สำหรับ Maps Experience หรือจะสร้างคีย์ใหม่ก็ได้ ไม่ว่าจะด้วยวิธีใด ให้เปิดใช้บริการ API เครื่องมือ Agent สำหรับ Maps Experience ทั้งในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google และคีย์
วิธีตรวจสอบสิทธิ์โดยใช้คีย์ API
- สร้างหรือกำหนดค่าคีย์ API โดยทำตามขั้นตอนในการเริ่มต้นใช้งาน Google Maps Platform
- ส่งคีย์ไปยังเซิร์ฟเวอร์ MCP โดยใช้ส่วนหัว
X-Goog-Api-Keyคุณต้องระบุส่วนหัวนี้เป็นส่วนหัว HTTP ที่กำหนดเองในการกำหนดค่าเครื่องมือ MCP ของ LLM
ตรวจสอบสิทธิ์โดยใช้ OAuth
คุณสามารถตรวจสอบสิทธิ์โดยใช้ OAuth ได้ด้วยการสร้างข้อมูลเข้าสู่ระบบ OAuth และส่งข้อมูลดังกล่าวไปยังโฮสต์ MCP หรือแอปพลิเคชันเซิร์ฟเวอร์ MCP
วิธีตรวจสอบสิทธิ์โดยใช้ OAuth
- ในคอนโซล Google Cloud ให้เลือกโปรเจ็กต์ที่ต้องการใช้สำหรับเครื่องมือ Agent สำหรับ Maps Experience
- ในเมนู API และบริการ ให้เลือกข้อมูลเข้าสู่ระบบ
- ในเมนูด้านบน ให้เลือกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth
- หากโปรเจ็กต์ไม่มีหน้าจอขอความยินยอมที่กำหนดค่าไว้ ให้คลิกกำหนดค่าหน้าจอขอความยินยอม แล้วทำตามวิธีการบนหน้าจอ
- ในส่วนเมตริก ให้คลิกสร้างไคลเอ็นต์ OAuth
- ในหน้าจอสร้างรหัสไคลเอ็นต์ OAuth ให้เลือกประเภทแอปพลิเคชันและป้อนชื่อรหัสไคลเอ็นต์
- ระบุรายละเอียดเพิ่มเติมที่เกี่ยวข้องกับประเภทแอปพลิเคชันของคุณ เช่น หากคุณกำลังสร้างเว็บแอปพลิเคชัน ให้เพิ่ม URI ที่ได้รับอนุญาตสำหรับคำขอเบราว์เซอร์และเซิร์ฟเวอร์
- เมื่อสร้างไคลเอ็นต์แล้ว ให้บันทึกรหัสไคลเอ็นต์และรหัสลับ
- เมื่อกำหนดค่าแอปพลิเคชันโฮสต์ MCP หรือเซิร์ฟเวอร์ MCP ให้ส่งรหัสไคลเอ็นต์ OAuth และรหัสลับ นอกจากนี้ คุณต้องขอขอบเขตต่อไปนี้ด้วย
https://www.googleapis.com/auth/maps-platform.mapstools
ดูข้อมูลเพิ่มเติมได้ที่การใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs
กำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ของเครื่องมือ Agent สำหรับ Maps Experience
หลังจากเปิดใช้บริการเครื่องมือ Agent สำหรับ Maps Experience และสร้างข้อมูลเข้าสู่ระบบแล้ว คุณจะกำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ได้ ทำตามเอกสารประกอบการกำหนดค่า MCP ของ LLM และใช้ URL ของเซิร์ฟเวอร์ MCP ต่อไปนี้ https://mapstools.googleapis.com/mcp
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อกำหนดค่า MCP ในแอปพลิเคชัน AI
กำหนดค่าเครื่องมือ Agent สำหรับ Maps Experience ด้วย Gemini CLI
ส่วนนี้แสดงตัวอย่างวิธีกำหนดค่าเซิร์ฟเวอร์ MCP ของเครื่องมือ Agent สำหรับ Maps Experience โดยใช้ Gemini CLI ดูรายละเอียดเพิ่มเติมได้ที่เซิร์ฟเวอร์ MCP ที่มี Gemini CLI
หลังจากติดตั้ง Gemini CLI แล้ว ให้เรียกใช้
gemini mcp addเพื่อกำหนดค่าเซิร์ฟเวอร์ MCPgemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-experience-agent-tools-mcp https://mapstools.googleapis.com/mcpหากการกำหนดค่าสำเร็จ คุณจะเห็นการยืนยันว่าได้เพิ่มเซิร์ฟเวอร์ลงในการตั้งค่าผู้ใช้แล้ว
หากต้องการตรวจสอบว่าเซิร์ฟเวอร์ทำงานอยู่ ให้เรียกใช้คำสั่ง
/mcp listดังนี้> /mcp list Configured MCP servers: maps-experience-agent-tools-mcp - Ready (6 tools) Tools: - compute_routes - lookup_weather - resolve_maps_urls - resolve_names - search_along_route - search_placesเริ่มถาม Maps ด้วย CLI เช่น ลองพูดว่า "แนะนำร้านอาหารใน Mountain View" ซึ่งจะเรียกใช้เครื่องมือ
search_placesในนามของคุณ
กำหนดค่าเครื่องมือ Agent สำหรับ Maps Experience ด้วย Agent Development Kit (ADK)
ส่วนนี้แสดงวิธีกำหนดค่าเซิร์ฟเวอร์ MCP ด้วย Agent Development Kit (ADK) ใน Python, Java หรือ TypeScript
Python
คุณดูการใช้งานตัวอย่างนี้อย่างสมบูรณ์ได้ใน GitHub ในที่เก็บ adk-samples
ขั้นตอนที่ 1: กำหนด Agent ด้วยเครื่องมือ Agent สำหรับ Maps Experience ของ McpToolset
แก้ไขไฟล์ agent.py แทนที่ YOUR_GOOGLE_MAPS_API_KEY ด้วยคีย์ API จริง
# ./adk_agent_samples/mcp_agent/agent.py import os from google.adk.agents.llm_agent import Agent from google.adk.tools.mcp_tool import McpToolset from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams # Retrieve the API key from an environment variable or directly insert it. GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY") if not GOOGLE_MAPS_API_KEY: GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE" if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE": print("WARNING: GOOGLE_MAPS_API_KEY is not set.") root_agent = Agent( model='gemini-flash-latest', name='travel_planner_agent', description='A helpful assistant for planning travel routes.', tools=[ McpToolset( connection_params=StreamableHTTPConnectionParams( url="https://mapstools.googleapis.com/mcp", headers={ "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY, "Content-Type": "application/json", "Accept": "application/json, text/event-stream" } ) ) ] )
ขั้นตอนที่ 2: ตรวจสอบว่ามี __init__.py อยู่
ตรวจสอบว่าคุณมี __init__.py ในไดเรกทอรีเดียวกับ agent.py ดังนี้
from . import agent
ขั้นตอนที่ 3: เรียกใช้ adk web และโต้ตอบ
- ตั้งค่าตัวแปรสภาพแวดล้อม:
ตั้งค่าคีย์ Google Maps API เป็นตัวแปรสภาพแวดล้อมในเทอร์มินัล:export GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_GOOGLE_MAPS_API_KEY"
- เรียกใช้
adk web:
เรียกใช้คำสั่งต่อไปนี้เพื่อเริ่มอินเทอร์เฟซเว็บของ ADKadk web
- โต้ตอบใน UI
- เลือก
travel_planner_agent - ลองใช้พรอมต์ต่อไปนี้
- "พรุ่งนี้ฉันจะไปซานฟรานซิสโก อากาศเป็นยังไงบ้าง"
- "หาร้านกาแฟใกล้สวนลุมพินี"
- "ขอเส้นทางจาก GooglePlex ไป SFO"
- เลือก
Java
กำหนด Agent ที่เริ่มต้น McpToolset ใน Java
แทนที่ YOUR_GOOGLE_MAPS_API_KEY_HERE ด้วยคีย์ API จริงที่คุณได้รับหากไม่ได้ใช้ตัวแปรสภาพแวดล้อม
package agents; import com.google.adk.agents.LlmAgent; import com.google.adk.runner.InMemoryRunner; import com.google.adk.sessions.SessionKey; import com.google.adk.tools.mcp.McpToolset; import com.google.adk.tools.mcp.StreamableHttpServerParameters; import com.google.genai.types.Content; import com.google.genai.types.Part; import java.util.HashMap; import java.util.Map; public class MapsAgentCreator { public static void main(String[] args) { String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY"); if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) { googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE"; if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) { System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set."); } } Map<String, String> headers = new HashMap<>(); headers.put("X-Goog-Api-Key", googleMapsApiKey); headers.put("Content-Type", "application/json"); headers.put("Accept", "application/json, text/event-stream"); StreamableHttpServerParameters serverParams = StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp") .headers(headers) .build(); try (McpToolset toolset = new McpToolset(serverParams)) { LlmAgent agent = LlmAgent.builder() .model("gemini-flash-latest") .name("travel_planner_agent") .description("A helpful assistant for planning travel routes.") .tools(toolset) .build(); System.out.println("Agent created: " + agent.name()); InMemoryRunner runner = new InMemoryRunner(agent); String userId = "maps-user-" + System.currentTimeMillis(); String sessionId = "maps-session-" + System.currentTimeMillis(); String promptText = "Please give me directions to the nearest pharmacy to Madison Square Garden."; SessionKey sessionKey = runner.sessionService() .createSession(runner.appName(), userId, null, sessionId) .blockingGet() .sessionKey(); System.out.println("Session created: " + sessionId + " for user: " + userId); Content promptContent = Content.fromParts(Part.fromText(promptText)); System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n"); runner.runAsync(sessionKey, promptContent) .blockingForEach(event -> { System.out.println("Event received: " + event.toJson()); }); } catch (Exception e) { System.err.println("An error occurred: " + e.getMessage()); e.printStackTrace(); } } }
TypeScript
กำหนด Agent ที่เริ่มต้น MCPToolset ใน TypeScript:
import 'dotenv/config'; import {LlmAgent, MCPToolset} from "@google/adk"; const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY; if (!googleMapsApiKey) { console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set."); throw new Error( 'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.' ); } export const rootAgent = new LlmAgent({ model: "gemini-flash-latest", name: "travel_planner_agent", description: "A helpful assistant for planning travel.", tools: [ new MCPToolset({ type: "StreamableHTTPConnectionParams", url: "https://mapstools.googleapis.com/mcp", transportOptions: { requestInit: { headers: { "X-Goog-Api-Key": googleMapsApiKey, "Content-Type": "application/json", "Accept": "application/json, text/event-stream" } } } }) ], });
เรียกใช้เครื่องมือด้วย REST
เครื่องมือแต่ละรายการในเครื่องมือ Agent สำหรับ Maps Experience ยังพร้อมใช้งานเป็นเมธอด REST ด้วย เรียกใช้เมธอด REST โดยตรงเมื่อต้องการเชื่อมต่อเครื่องมือเข้ากับ Agent หรือแอปพลิเคชันของคุณเอง เช่น เพื่อประกาศฟังก์ชันของคุณเองสำหรับโมเดล เลือกตัวเลือกที่โมเดลสามารถตั้งค่าได้ หรือตั้งค่าเริ่มต้นในโค้ด
ตารางต่อไปนี้แสดงเมธอด REST สำหรับเครื่องมือแต่ละรายการ
| เครื่องมือ | เมธอด REST |
|---|---|
search_places |
POST https://mapstools.googleapis.com/v1:searchText |
search_along_route |
POST https://mapstools.googleapis.com/v1:searchAlongRoute |
lookup_weather |
POST https://mapstools.googleapis.com/v1:lookupWeather |
compute_routes |
POST https://mapstools.googleapis.com/v1:computeRoutes |
resolve_names |
POST https://mapstools.googleapis.com/v1:resolveNames |
resolve_maps_urls |
POST https://mapstools.googleapis.com/v1:resolveMapsUrls |
คำขอ REST จะใช้ตัวเลือกเดียวกับเครื่องมือที่เกี่ยวข้องและแสดงผลลัพธ์เดียวกัน ในเนื้อหาคำขอและการตอบกลับ REST ชื่อฟิลด์จะใช้การเขียนแบบ Camel Case ตัวพิมพ์เล็ก เช่น textQuery แทน text_query ระบบจะเรียกเก็บเงินคำขอ REST ภายใต้ SKU เดียวกัน เป็นไปตามกฎเดียวกันสำหรับตัวเลือก Pro และนับรวมในโควต้าเดียวกันกับการเรียกใช้เครื่องมือ MCP
หากต้องการตรวจสอบสิทธิ์ ให้ใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google Cloud และข้อมูลเข้าสู่ระบบเดียวกันกับเซิร์ฟเวอร์ MCP ดูขั้นตอนการตั้งค่าได้ที่หัวข้อกำหนดค่า LLM ให้ใช้เซิร์ฟเวอร์ MCP
ส่งคีย์ API ในส่วนหัว X-Goog-Api-Key หรือส่งโทเค็นเพื่อการเข้าถึง OAuth ที่มีขอบเขต https://www.googleapis.com/auth/maps-platform.mapstools ในส่วนหัว Authorization
ตัวอย่างต่อไปนี้จะเรียกใช้เมธอด searchText
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
"textQuery": "coffee shops near Golden Gate Park"
}' \
"https://mapstools.googleapis.com/v1:searchText"
แทนที่ API_KEY ด้วยคีย์ API ของคุณ
การตอบกลับจะมีช่อง summary, places และ contentToken เหมือนกับผลลัพธ์ของเครื่องมือ search_places คู่มือของเครื่องมือแต่ละรายการจะแสดงตัวอย่างเวอร์ชัน REST
การแชร์ความคิดเห็น
หากต้องการแชร์ความคิดเห็นเกี่ยวกับเครื่องมือ Agent สำหรับ Maps Experience ให้ใช้แบบฟอร์มต่อไปนี้