ใช้ความสามารถของเครื่องมือตัวแทน Maps Experience ได้มากขึ้นด้วย SKU เวอร์ชัน Pro ติดต่อฝ่ายขายเพื่อขอสิทธิ์เข้าถึง

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

เครื่องมือ Agent สำหรับ Maps Experiments

เครื่องมือ Agent ของ Maps Experience (เดิมชื่อ Maps Grounding Lite) เป็นบริการของ Google Maps Platform ที่รองรับ Model Context Protocol (MCP) เพื่อใช้ข้อมูลเชิงพื้นที่ที่เชื่อถือได้จาก Google Maps เป็นข้อมูลอ้างอิงสำหรับแอปพลิเคชัน AI เซิร์ฟเวอร์ MCP มีเครื่องมือที่ช่วยให้ LLM เข้าถึงข้อมูลสถานที่ สภาพอากาศ และเส้นทางได้ เครื่องมืออื่นๆ จะแปลงชื่อสถานที่และ URL ของ Google Maps เป็นรหัสสถานที่ คุณลองใช้เครื่องมือตัวแทน Maps Experience ได้โดยเปิดใช้ในเครื่องมือที่รองรับเซิร์ฟเวอร์ MCP

เครื่องมือ Agent ของ Maps Experience เป็นผลิตภัณฑ์เดียวที่มี SKU 2 รายการ ได้แก่ Essentials และ Pro ระบบจะเรียกเก็บเงินสำหรับคำขอทุกรายการภายใต้แพ็กเกจ Essentials เว้นแต่จะใช้ตัวเลือก Pro ตัวเลือก Pro จะเพิ่มรายละเอียดสถานที่แบบขยาย สถานที่ต่อการค้นหามากขึ้น จุดแวะพักระหว่างทางต่อเส้นทางมากขึ้น และการกำหนดเส้นทางพร้อมการจราจรแบบเรียลไทม์ ในช่วง GA แบบจำกัด ตัวเลือก Pro จะใช้ได้กับโปรเจ็กต์ในรายการที่อนุญาตของ Pro เท่านั้น SKU ทั้ง 2 รายการใช้เซิร์ฟเวอร์ MCP, เครื่องมือ และข้อมูลเข้าสู่ระบบเดียวกัน โปรดดูรายละเอียดที่หัวข้อ Essentials และ Pro

เครื่องมือ

เครื่องมือตัวแทน Maps Experience ช่วยให้ LLM เข้าถึงความสามารถต่อไปนี้ของ Google Maps ได้

ค้นหาสถานที่: ขอข้อมูลเกี่ยวกับสถานที่และรับข้อมูลสรุปที่ AI สร้างขึ้น นอกจากนี้ การตอบกลับยังมีรหัสสถานที่ พิกัด และลิงก์ Google Maps สำหรับสถานที่แต่ละแห่งในข้อมูลสรุปด้วย คุณสามารถใช้รหัสสถานที่และพิกัดร่วมกับ Google Maps Platform API อื่นๆ เพื่อแสดงสถานที่บนแผนที่ได้ เมื่อใช้ Pro คุณจะขอรายละเอียดสถานที่เพิ่มเติมได้ เช่น ข้อมูลเชิงลึกจากรีวิว และขอรายละเอียดสถานที่ได้สูงสุด 10 แห่งต่อคำขอ
ค้นหาสภาพอากาศ: ขอข้อมูลเกี่ยวกับสภาพอากาศและแสดงสภาพอากาศปัจจุบัน พยากรณ์อากาศรายชั่วโมง และพยากรณ์อากาศรายวัน
คำนวณเส้นทาง: ขอเส้นทางระหว่างต้นทางและปลายทาง โดยอาจผ่านจุดแวะพักระหว่างทาง และแสดงระยะทางและระยะเวลาของเส้นทาง เมื่อใช้ Pro เส้นทางจะพิจารณาสภาพการจราจรแบบเรียลไทม์และรวมจุดแวะพักระหว่างทางได้มากขึ้น

หมายเหตุ: เครื่องมือ Agent ของ Maps Experience ไม่ได้ให้คำแนะนำแบบทีละขั้นตอนหรือข้อมูลการนำทาง เส้นทางที่คำนวณโดยไม่มีตัวเลือก Pro จะไม่พิจารณาการจราจรแบบเรียลไทม์
Resolve names และ Resolve Maps URLs: แปลงชื่อสถานที่ ที่อยู่ และ 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 อื่นๆ หรือสำหรับการควบคุมการเรียกใช้เครื่องมือแต่ละรายการโดยตรง

	เครื่องมือ Agent สำหรับ Maps Experiments		การเชื่อมต่อแหล่งข้อมูลกับ Google Maps
	SKU รุ่น Essentials (เดิมชื่อ Maps Grounding Lite)	SKU ของ Pro	การเชื่อมต่อแหล่งข้อมูลกับ Google Maps
วิธีเรียกเก็บเงินสำหรับคำขอ	คำขอเครื่องมือแต่ละรายการที่ไม่ได้ใช้ตัวเลือก Pro	คำขอเครื่องมือแต่ละรายการที่ใช้ตัวเลือก Pro: `include_extended_details`, `page_size` มากกว่า 5, `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` หรือจุดอ้างอิงระดับกลางมากกว่า 10 จุด	คำค้นหา Google Maps หรือพรอมต์ที่อิงตามข้อมูลจริงแต่ละรายการ โดยขึ้นอยู่กับแพลตฟอร์มและโมเดล
โมเดลและแพลตฟอร์ม	โมเดลหรือเฟรมเวิร์ก Agent ที่รองรับ MCP เซิร์ฟเวอร์ MCP 1 เครื่อง, เครื่องมือ 1 ชุด และข้อมูลเข้าสู่ระบบเดียวกันสำหรับ SKU ทั้ง 2 รายการ		โมเดล Gemini ใน Gemini API, Google AI Studio และแพลตฟอร์ม Agent ของ Gemini Enterprise
สิ่งที่เครื่องมือแสดงผล	ข้อมูลสำคัญ: รายละเอียดสถานที่สูงสุด 5 แห่งต่อการค้นหา ระยะทางและระยะเวลาของเส้นทางโดยไม่มีข้อมูลการจราจรแบบเรียลไทม์ รวมถึงสภาพอากาศปัจจุบันและการพยากรณ์อากาศ	ทุกอย่างใน Essentials รวมถึงรายละเอียดสถานที่เพิ่มเติม (เช่น ข้อมูลเชิงลึกจากรีวิว) สถานที่สูงสุด 10 แห่งต่อการค้นหา เส้นทางที่มีการจราจรแบบเรียลไทม์ และจุดอ้างอิงระหว่างทางสูงสุด 25 จุด	รายละเอียดสถานที่และข้อมูลเชิงลึกจากรีวิว รวมถึงข้อมูลเส้นทางพร้อมการจราจรแบบเรียลไทม์
ตัวอย่างคำขอ	คำถามเกี่ยวกับข้อเท็จจริงและโลจิสติกส์: การค้นหาร้านค้าหรือธุรกิจ เวลาทำการ ที่อยู่ และระยะทางหรือระยะเวลาเดินทางโดยประมาณ	คำถามเชิงอัตวิสัยหรือคำถามกว้างๆ: บรรยากาศ อาหารจานเด่น เคล็ดลับสำหรับผู้เข้าชม การเปรียบเทียบสถานที่ 6-10 แห่ง และระยะเวลาเดินทางในสภาพการจราจรปัจจุบัน	การค้นหาแบบสนทนา การวางแผนกำหนดการเดินทาง และการสำรวจสถานที่ในพื้นที่ใน 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	ไม่รวม	ไม่พร้อมใช้งาน
เริ่มต้นใช้งาน	การตั้งค่าเดียวสำหรับทั้ง 2 SKU: ดูหัวข้อกำหนดค่า LLM ให้ใช้เซิร์ฟเวอร์ MCP ในช่วง GA แบบจำกัด ตัวเลือก Pro ยังต้องมีโปรเจ็กต์ในรายการที่อนุญาตของ Pro ด้วย		Gemini API หรือ Agent Platform

ตัวเลือกเหล่านี้ทำงานในลักษณะเดียวกันกับ SKU ทั้ง 2 รายการ ได้แก่ โหมดการเดินทาง เวลาออกเดินทางและเวลาถึง เส้นทางอื่น เส้นประกอบของเส้นทาง การค้นหาสภาพอากาศ และ Resolution API แต่จะไม่เปลี่ยน SKU ที่ใช้เรียกเก็บเงินสำหรับคำขอ

รายการที่เรียกเก็บเงินภายใต้ 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`)
Lookup weather และ Resolution API	ไม่มีตัวเลือก Pro ระบบจะเรียกเก็บเงินคำขอทั้งหมดภายใต้ SKU ของ Essentials

ดูตัวเลือกคำขอที่เปิดใช้ความสามารถแต่ละอย่างได้ที่ค้นหาสถานที่และคำนวณเส้นทาง

ตัวเลือก Pro ในช่วง GA แบบจำกัด

ในช่วง GA แบบจำกัด ตัวเลือก Pro จะใช้ได้กับโปรเจ็กต์ Google Cloud ในรายการที่อนุญาตของ Pro เท่านั้น ติดต่อฝ่ายขายเพื่อขอสิทธิ์เข้าถึง เมื่อโปรเจ็กต์อยู่ในรายการที่อนุญาตแล้ว คีย์ API และไคลเอ็นต์ OAuth ทุกรายการในโปรเจ็กต์จะใช้ตัวเลือก Pro ได้

หากโปรเจ็กต์ยังไม่อยู่ในรายการที่อนุญาต คำขอที่ใช้ตัวเลือก Pro จะได้รับการจัดการดังนี้

ค้นหาสถานที่: ระบบจะไม่สนใจ include_extended_details และการตอบกลับจะมีสถานที่อย่างมาก 5 แห่ง แม้ว่าคุณจะตั้งค่า page_size ให้สูงกว่านั้นก็ตาม ระบบจะเรียกเก็บเงินคำขอภายใต้ SKU ของ Essentials
คำนวณเส้นทาง: ระบบจะถือว่า ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL เป็น ROUTING_PREFERENCE_TRAFFIC_UNAWARE และจะเรียกเก็บเงินสำหรับคำขอภายใต้ SKU Essentials คำขอที่มีจุดอ้างอิงกลางมากกว่า 10 จุดจะแสดงข้อผิดพลาด INVALID_ARGUMENT

หากต้องการตรวจสอบว่าโปรเจ็กต์อยู่ในรายการที่อนุญาตหรือไม่ ให้ส่งคำขอ search_places โดยตั้งค่า page_size เป็น 10 ใช้คำค้นหาแบบกว้าง เช่น restaurants in Chicago โปรเจ็กต์ในรายการที่อนุญาตจะแสดงผลสถานที่ได้มากกว่า 5 แห่ง โดยจะเรียกเก็บเงินภายใต้ SKU ระดับมืออาชีพ โปรเจ็กต์อื่นๆ จะแสดงผลลัพธ์สถานที่ได้สูงสุด 5 แห่ง

ควบคุมการใช้งาน Pro

ตัวเลือก Pro จะปิดอยู่โดยค่าเริ่มต้น LLM จะตั้งค่าพารามิเตอร์เหล่านี้เมื่อคำขอของผู้ใช้เรียกใช้ และสคีมาเครื่องมือหรือวิธีการของคุณอนุญาต สคีมาเครื่องมือจะอธิบายค่า page_size สูงสุด 5 ค่าและจุดอ้างอิงระดับกลางสูงสุด 10 จุด ดังนั้นโมเดลจะใช้ขีดจำกัดที่สูงขึ้นของ Pro เมื่อคำสั่งของคุณขอเท่านั้น วิธีจัดการค่าใช้จ่าย

บอกโมเดลว่าตัวเลือก Pro เหมาะสมเมื่อใด เช่น "ตั้งค่า include_extended_details เฉพาะเมื่อผู้ใช้ถามเกี่ยวกับรีวิว เมนู หรือบรรยากาศ" หรือ "ใช้ ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL เฉพาะเมื่อผู้ใช้ถามถึงระยะเวลาเดินทางปัจจุบัน"
หากต้องการให้ Agent อยู่ใน SKU Essentials ให้สั่งโมเดลไม่ให้ใช้ตัวเลือก Pro ตัวเลือก Pro ได้แก่ include_extended_details, page_size ที่มากกว่า 5, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL และจุดอ้างอิง ระดับกลางมากกว่า 10 จุด หากไคลเอ็นต์ MCP สามารถจำกัดอาร์กิวเมนต์ของเครื่องมือได้ คุณก็บล็อกค่าเหล่านั้นในการกำหนดค่าเครื่องมือได้เช่นกัน
ตรวจสอบการใช้งานในรายงานการเรียกเก็บเงินและตั้งค่าการแจ้งเตือนงบประมาณ

Resolution API

เครื่องมือ Agent ของ Maps Experience มี Resolution API โดยจะแปลงข้อความสถานที่และ URL แบบอิสระเป็นตัวระบุสถานที่ใน Google Maps ที่มีโครงสร้าง Resolution API พร้อมใช้งานเป็นเมธอด REST และเป็นเครื่องมือในเซิร์ฟเวอร์ MCP ดังนี้

Resolve names (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 แต่ละรายการนอกเหนือจากค่าบริการทั้งหมด ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการรายงาน

คำขอค้นหาสถานที่ คำนวณเส้นทาง หรือค้นหาสภาพอากาศแต่ละรายการจะเรียกเก็บเงินภายใต้ SKU เดียวเท่านั้น ไม่ว่าจะเป็น Essentials หรือ Pro คำขอที่ใช้ตัวเลือก Pro จะเรียกเก็บเงินภายใต้ SKU ของ Pro ระบบจะไม่เรียกเก็บเงินภายใต้ SKU ทั้ง 2 รายการ และจำนวนตัวเลือก Pro จะไม่เปลี่ยนแปลงค่าบริการ ตัวเลือกต่อไปนี้จะกำหนด SKU

เครื่องมือ	Essentials	Pro
`search_places`	คำขอที่ไม่มีตัวเลือก Pro: `page_size` มีค่าไม่เกิน 5 และไม่ได้ตั้งค่า `include_extended_details` หรือตั้งค่าเป็น `false`	`include_extended_details` ตั้งค่าเป็น `true` หรือ `page_size` ตั้งแต่ 6 ถึง 10
`compute_routes`	คำขอที่ไม่มีตัวเลือก Pro: `routing_preference` ไม่ได้ตั้งค่าหรือ `ROUTING_PREFERENCE_TRAFFIC_UNAWARE` และจุดอ้างอิงระดับกลางไม่เกิน 10 จุด โดยใช้โหมดการเดินทางใดก็ได้	`routing_preference` ตั้งค่าเป็น `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` หรือจุดอ้างอิงระดับกลาง 11 ถึง 25 จุด
`lookup_weather`	ทุกคำขอ	—

โปรดดูราคาของ Essentials ที่รายละเอียด SKU ของ Essentials คำขอ Pro จะเรียกเก็บเงินในราคา $14.00 ต่อ 1,000 คำขอหลังจาก 5,000 คำขอแรกในแต่ละเดือน ติดต่อฝ่ายขายเพื่อสอบถามราคาตามปริมาณการซื้อ

ในช่วง GA แบบจำกัด ตัวเลือก Pro จะมีผลกับโปรเจ็กต์ในรายการที่อนุญาตของ Pro เท่านั้น โปรดดูรายละเอียดที่หัวข้อตัวเลือก Pro ในช่วง GA แบบจำกัด

ดูรายละเอียดราคาได้ที่ตารางราคาหลักและตารางราคาสำหรับอินเดีย

ระบบจะไม่เรียกเก็บเงินสำหรับคำขอ Resolution API (ResolveNames และ ResolveMapsUrls) ภายใต้ SKU Places API Text Search Essentials (รหัสเท่านั้น)

การใช้งาน SKU Essentials จะรวมอยู่ในแพ็กเกจ Essentials และ Pro สมัครใช้บริการเพื่อประหยัดด้วย SKU ระดับมืออาชีพไม่รวมอยู่ในแพ็กเกจสมัครใช้บริการเพื่อประหยัด

โควต้า

โควต้าต่อไปนี้มีผลกับเครื่องมือและ API ที่เครื่องมือ Agent ของ Maps Experience มีให้

ค้นหาสถานที่: การค้นหา 300 ครั้งต่อนาทีต่อโปรเจ็กต์
ค้นหาสภาพอากาศ: คำค้นหา 300 รายการต่อนาทีต่อโปรเจ็กต์
Compute routes: การค้นหา 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

การตอบกลับของเครื่องมือแต่ละรายการจากเครื่องมือตัวแทน Maps Experience จะมีแหล่งที่มา เมื่อนำเสนอผลลัพธ์จากเครื่องมือตัวแทน Maps Experience คุณต้องระบุแหล่งที่มาของ Google Maps ที่เกี่ยวข้องและปฏิบัติตามข้อกำหนดต่อไปนี้

แหล่งที่มาของ Google Maps ต้องอยู่ต่อจากเนื้อหาที่สร้างขึ้นซึ่งแหล่งที่มานั้นรองรับทันที เนื้อหาที่สร้างขึ้นนี้เรียกอีกอย่างว่าเอาต์พุตที่มีที่มา
แหล่งที่มาของ Google Maps ต้องดูได้ภายในการโต้ตอบของผู้ใช้ 1 ครั้ง

แหล่งที่มาของเครื่องมือค้นหาสถานที่

ช่อง places ของเครื่องมือ search_places จะแสดงแหล่งข้อมูลที่สนับสนุน summary สำหรับ places ระบบจะแสดงผลข้อมูลเมตาต่อไปนี้

place (ชื่อทรัพยากร)
id
location
googleMapsLinks

คุณต้องสร้างตัวอย่างลิงก์ที่ตรงตามข้อกำหนดต่อไปนี้สำหรับแต่ละสถานที่

ระบุแหล่งที่มาแต่ละแหล่งเป็น Google Maps โดยทำตามหลักเกณฑ์การระบุแหล่งที่มาของข้อความสำหรับเครื่องมือตัวแทน Maps Experience
ลิงก์ไปยังแหล่งที่มาโดยใช้ places.googleMapsLinks.placeUrl จากการตอบกลับ

ข้อกำหนดเหล่านี้ยังมีผลกับข้อมูลสรุปที่มีรายละเอียดสถานที่เพิ่มเติมจาก Pro เช่น ข้อมูลเชิงลึกจากรีวิว summary จะอ้างอิงสถานที่แต่ละแห่งด้วยดัชนีแบบ Zero-Based เช่น [0] ซึ่งแมปกับรายการใน places แต่ละสถานที่จะมี googleMapsLinks.reviewsUrl ซึ่งลิงก์ไปยังรีวิวของสถานที่นั้นใน Google Maps ด้วย ผู้ใช้สามารถทำตามเพื่อดูรีวิวที่อยู่เบื้องหลังข้อมูลเชิงลึกได้

อินเทอร์เฟซที่เน้นเสียงเป็นหลัก

หากแอปแสดงผลลัพธ์ของเครื่องมือตัวแทน 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
เปิดใช้เครื่องมือตัวแทน 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 Experiments

หลังจากเปิดใช้บริการเครื่องมือ 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 เพื่อกำหนดค่าเซิร์ฟเวอร์ MCP
```
gemini 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 (5 tools)
Tools:
-   compute_routes
-   lookup_weather
-   resolve_maps_urls
-   resolve_names
-   search_places
```
เริ่มถาม Maps ด้วย CLI เช่น ลองพูดว่า "แนะนำร้านอาหารในเมาน์เทนวิวให้หน่อย" ซึ่งควรเรียกใช้เครื่องมือ search_places ในนามของคุณ

กำหนดค่าเครื่องมือ Agent ของ Maps Experience ด้วย Agent Development Kit (ADK)

ส่วนนี้แสดงวิธีกำหนดค่าเซิร์ฟเวอร์ MCP ด้วย Agent Development Kit (ADK) ใน Python, Java หรือ TypeScript

Python

คุณดูการใช้งานตัวอย่างนี้อย่างสมบูรณ์ได้ใน GitHub ในที่เก็บ adk-samples

ขั้นตอนที่ 1: กำหนด Agent ด้วยเครื่องมือ Agent ของ `McpToolset` สำหรับประสบการณ์การใช้งาน Maps

แก้ไขไฟล์ 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:
เรียกใช้คำสั่งต่อไปนี้เพื่อเริ่มอินเทอร์เฟซเว็บของ ADK
```
adk 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: "SseConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            headers: {
                "X-Goog-Api-Key": googleMapsApiKey,
                "Content-Type": "application/json",
                "Accept": "application/json, text/event-stream"
            }
        })
    ],
});

การแชร์ความคิดเห็น

หากต้องการแชร์ความคิดเห็นเกี่ยวกับเครื่องมือ Agent ของ Maps Experience ให้ใช้แบบฟอร์มต่อไปนี้