Grounding Lite

เวอร์ชันทดลอง: Grounding Lite อยู่ในขั้นทดลอง (ก่อน GA) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป อาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์ และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจไม่เข้ากันกับเวอร์ชันก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอื่นๆ ข้อเสนอก่อนเปิดให้ใช้งานทั่วไปอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายระยะการเปิดตัว ไม่มี ค่าใช้จ่ายในการใช้ Grounding Lite ขณะที่ยังเป็นเวอร์ชันทดลอง

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

เครื่องมือ

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

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

• คำนวณเส้นทาง: ขอข้อมูลเกี่ยวกับเส้นทางการขับรถหรือเดินระหว่าง 2 สถานที่ และแสดงข้อมูลระยะทางและระยะเวลาของเส้นทาง

  หมายเหตุ: Grounding Lite ไม่ได้ให้การกำหนดเส้นทาง คำแนะนำ การจราจรแบบเรียลไทม์ หรือข้อมูลการนำทางแบบทีละขั้นตอน

การเปิดใช้เซิร์ฟเวอร์ MCP ของ Maps Grounding Lite จะช่วยให้ LLM เรียกใช้เครื่องมือใหม่ ที่เซิร์ฟเวอร์แสดงเพื่อแสดงข้อมูลการอ้างอิงเพิ่มเติมสำหรับข้อมูล ประเภทที่ระบุไว้ข้างต้นได้ แม้ว่า LLM จะใช้ข้อมูลเพิ่มเติมนี้เพื่อ บริบทได้ แต่คำตอบที่ LLM สร้างขึ้นในท้ายที่สุดอาจไม่มี ข้อมูลที่แน่นอนซึ่งเซิร์ฟเวอร์ MCP ส่งคืน คุณควรตรวจสอบความถูกต้องของคำตอบที่สร้างขึ้น

การเรียกเก็บเงินและโควต้า

ไม่มีค่าใช้จ่ายในการใช้ Grounding Lite ในช่วงทดลอง อย่างไรก็ตาม โควต้าต่อไปนี้จะมีผลกับเครื่องมือที่ Grounding Lite จัดหาให้

• ค้นหาสถานที่: 100 คำค้นหาต่อนาทีต่อโปรเจ็กต์ การค้นหา 1,000 ครั้งต่อวันต่อโปรเจ็กต์
• ค้นหาสภาพอากาศ: 300 คำค้นหาต่อนาทีต่อโปรเจ็กต์
• เส้นทางการคำนวณ: 300 คำค้นหาต่อนาทีต่อโปรเจ็กต์

นโยบายและข้อกำหนดในการให้บริการ

Grounding Lite อยู่ภายใต้ข้อกำหนดในการให้บริการของ Google Maps Platform ซึ่งรวมถึงข้อกำหนดเฉพาะบริการสำหรับบริการนี้ ส่วนนี้จะอธิบายข้อกำหนดเพิ่มเติมในการใช้บริการสำหรับ Grounding Lite ซึ่งรวมถึง LLM ที่เข้ากันได้และข้อกำหนดในการระบุแหล่งที่มา

ข้อกำหนดสำหรับ LLM ที่เข้ากันได้

คุณใช้ Grounding Lite ได้เฉพาะกับ LLM ที่เป็นไปตามข้อกำหนดในการให้บริการของ Google Maps Platform เท่านั้น

ตัวอย่างเช่น คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าเนื้อหาของ Google Maps ไม่ได้ แคช จัดเก็บ หรือใช้เพื่อปรับปรุง LLM ที่คุณเลือกใช้ ก่อนใช้ Grounding Lite คุณจะต้องอ่านข้อกำหนดในการให้บริการของโมเดลใดก็ตามที่คุณต้องการใช้กับ Grounding Lite คุณต้องไม่ใช้ Grounding Lite กับโมเดลที่ใช้ข้อมูลที่ป้อนลงในโมเดลเพื่อการฝึกหรือปรับปรุงโมเดล คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าการใช้โมเดลของคุณเป็นไปตามข้อจำกัดเกี่ยวกับเนื้อหา Google Maps ในข้อกำหนดในการให้บริการของ Google Maps Platform อย่างครบถ้วน ซึ่งรวมถึงข้อกำหนดเฉพาะของบริการ

ข้อกำหนดในการระบุแหล่งที่มาสำหรับแหล่งที่มาของ Google Maps

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

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

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

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

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

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

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

กำหนดค่า LLM ให้ใช้เซิร์ฟเวอร์ MCP

หากต้องการใช้ Grounding Lite คุณต้องมีคีย์ API ที่เปิดใช้บริการ API Maps Grounding Lite ก่อน จากนั้นคุณจะกำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ได้ เซิร์ฟเวอร์ Grounding Lite MCP ใช้การรับส่งข้อมูล HTTP ที่สตรีมได้

สร้างหรือกำหนดค่าคีย์ API

คุณสามารถใช้คีย์ API ที่มีอยู่กับ Maps Grounding Lite หรือสร้างคีย์ใหม่ได้ ตราบใดที่คุณเปิดใช้Maps Grounding Lite API service ในคีย์ Maps Grounding Lite API จะไม่เรียกเก็บเงินในช่วงทดลองใช้ แต่ต้องเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์

วิธีเปิดใช้ API

1. ใน Google Cloud Console ให้เลือกโปรเจ็กต์ที่ต้องการใช้สำหรับ Grounding Lite
2. เปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ใน Google Cloud Console
3. เปิดเทอร์มินัล Cloud Shell จากการนำทางด้านบน

4. เรียกใช้คำสั่งต่อไปนี้เพื่อเปิดใช้บริการและปลายทาง MCP

   gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
   gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID
   

5. ทำตามขั้นตอนในการเริ่มต้นใช้งาน Google Maps Platform เพื่อสร้างหรือกำหนดค่าคีย์ API

หมายเหตุ: เมื่อสร้างหรือกำหนดค่าคีย์ API โปรดจำกัดการใช้คีย์โดยใช้ข้อจำกัดที่เหมาะสม ดูข้อมูลเพิ่มเติมได้ที่จำกัดคีย์ API

ควรส่งคีย์ API ไปยังเซิร์ฟเวอร์ MCP โดยใช้ส่วนหัว X-Goog-Api-Key คุณต้องระบุสิ่งนี้เป็นส่วนหัว HTTP ที่กำหนดเองในการกำหนดค่าเครื่องมือ MCP ของ LLM

กำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ของ Grounding Lite

เมื่อมีคีย์ API ที่เปิดใช้บริการ Maps Grounding Lite API แล้ว คุณจะกำหนดค่า LLM ให้เข้าถึงเซิร์ฟเวอร์ MCP ได้โดยทำตามเอกสารการกำหนดค่า MCP ที่เกี่ยวข้อง และใช้ URL เซิร์ฟเวอร์ MCP ของ Grounding Lite ดังนี้ https://mapstools.googleapis.com/mcp

กำหนดค่า Grounding Lite ด้วย Gemini CLI

ส่วนนี้จะแสดงตัวอย่างวิธีกำหนดค่าเซิร์ฟเวอร์ Grounding Lite MCP โดยใช้ Gemini CLI โปรดดูรายละเอียดเพิ่มเติมที่เซิร์ฟเวอร์ MCP ที่มี Gemini CLI

1. เมื่อติดตั้ง Gemini CLI แล้ว คุณจะใช้คำสั่ง add เพื่อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Maps Grounding Lite ได้โดยทำดังนี้

   gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp
   

   หากกำหนดค่าสำเร็จ คุณควรเห็นการยืนยันว่าระบบได้เพิ่มเซิร์ฟเวอร์ลงในการตั้งค่าผู้ใช้แล้ว

2. หากต้องการตรวจสอบว่าเซิร์ฟเวอร์ทำงานอย่างถูกต้อง ให้เรียกใช้/mcp list คำสั่งต่อไปนี้

   > /mcp list
   
   Configured MCP servers:
   
   maps-grounding-lite-mcp - Ready (3 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   search_places
   

3. เริ่มถามคำถามที่เกี่ยวข้องกับ Maps ด้วย CLI เช่น ลองพูดว่า "แนะนำร้านอาหารในเมาน์เทนวิวให้หน่อย" ซึ่งควรเรียกใช้เครื่องมือ search_places ในนามของคุณ

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

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

• รายงานข้อบกพร่อง
• ส่งคำขอฟีเจอร์
• แสดงความคิดเห็น