Grounding Lite

Grounding Lite ของ Google Maps Platform เป็นบริการที่รองรับ 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 สถานที่ และแสดงข้อมูลระยะทางและระยะเวลาของเส้นทาง

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

ลองใช้แอปตัวอย่าง Grounding Lite (เปิดในแท็บใหม่)

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

ราคาที่เป็นไปได้

การใช้ Grounding Lite ในขณะที่ยังอยู่ในระยะทดลองจะไม่มีค่าใช้จ่าย

ตารางต่อไปนี้อธิบายช่วงราคาที่เป็นไปได้สำหรับ Maps Grounding Lite หากมีการเปิดตัวแบบความพร้อมใช้งานทั่วไป (GA) ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายเกี่ยวกับระยะการเปิดตัว

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

ค่าใช้จ่ายที่แสดงต่อเหตุการณ์ 1,000 รายการ ราคาทั้งหมดเป็นสกุลเงิน USD ช่วงนี้ใช้สำหรับจำนวน กิจกรรมรายเดือน

หมวดหมู่

ชื่อ SKU

โควต้าการใช้งานฟรี

สูงสุด - 100,000

100,001 - 500,000

500,001 - 1,000,000

1,000,001 - 5,000,000

5,000,000+
Essentials Grounding Lite 10,000 $7.00 $5.95 $4.90 $3.85 $2.80

หมวดหมู่

ชื่อ SKU

โควต้าการใช้งานฟรี

สูงสุด - 5,000,000

5,000,000+
Essentials Grounding Lite (อินเดีย) 70,000 $3.85 $2.80

โควต้า

โควต้าต่อไปนี้มีผลกับเครื่องมือที่ 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

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

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

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

เปิดใช้บริการ Grounding Lite ของ Maps ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

วิธีเปิดใช้ API ในโปรเจ็กต์

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

ตรวจสอบสิทธิ์โดยใช้คีย์ API

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

วิธีตรวจสอบสิทธิ์โดยใช้คีย์ API

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

ตรวจสอบสิทธิ์โดยใช้ OAuth

คุณสามารถตรวจสอบสิทธิ์โดยใช้ OAuth ได้ด้วยการสร้างข้อมูลเข้าสู่ระบบ OAuth และส่งข้อมูลดังกล่าว ไปยังแอปพลิเคชันโฮสต์ MCP หรือเซิร์ฟเวอร์ MCP

วิธีตรวจสอบสิทธิ์โดยใช้ OAuth

  1. ใน คอนโซล Google Cloud ให้เลือกโปรเจ็กต์ที่ต้องการใช้สำหรับ Grounding Lite
  2. ในเมนู API และบริการ ให้เลือกข้อมูลเข้าสู่ระบบ
  3. ในเมนูด้านบน ให้เลือกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth
  4. หากโปรเจ็กต์ไม่มีหน้าจอขอความยินยอมที่กำหนดค่าไว้ ให้คลิกกำหนดค่าหน้าจอขอความยินยอม แล้วทำตามวิธีการบนหน้าจอ
  5. ในส่วนเมตริก ให้คลิกสร้างไคลเอ็นต์ OAuth
  6. ในหน้าจอสร้างรหัสไคลเอ็นต์ OAuth ให้เลือกประเภทแอปพลิเคชันและป้อน ชื่อสำหรับรหัสไคลเอ็นต์
  7. ระบุรายละเอียดเพิ่มเติมที่เกี่ยวข้องกับประเภทการสมัคร เช่น หากคุณสร้างเว็บแอปพลิเคชัน ให้เพิ่ม URI ที่ได้รับอนุญาตสำหรับคำขอของเบราว์เซอร์และเซิร์ฟเวอร์
  8. เมื่อสร้างไคลเอ็นต์แล้ว ให้บันทึกรหัสไคลเอ็นต์และรหัสลับ
  9. เมื่อกำหนดค่าโฮสต์ MCP หรือแอปพลิเคชันเซิร์ฟเวอร์ MCP เพื่อเข้าถึง Grounding Lite ให้ส่งรหัสไคลเอ็นต์และรหัสลับ OAuth นอกจากนี้ คุณต้องขอขอบเขตต่อไปนี้ด้วย https://www.googleapis.com/auth/maps-platform.mapstools

ดูข้อมูลเพิ่มเติมได้ที่การใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs

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

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

ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่า MCP ในแอปพลิเคชัน AI

กำหนดค่า 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 ให้ใช้แบบฟอร์มต่อไปนี้