Grounding Lite

Google Maps Platform Grounding Lite là một dịch vụ có hỗ trợ Giao thức ngữ cảnh mô hình (MCP) giúp bạn dễ dàng đặt nền tảng cho các ứng dụng AI bằng dữ liệu không gian địa lý đáng tin cậy từ Google Maps. Máy chủ MCP cung cấp các công cụ cho phép LLM truy cập vào các chức năng về địa điểm, thời tiết và tuyến đường. Bạn có thể dùng thử Grounding Lite bằng cách bật tính năng này trong bất kỳ công cụ nào hỗ trợ máy chủ MCP.

Công cụ

Grounding Lite cung cấp các công cụ cho phép LLM truy cập vào các chức năng sau đây của Google Maps:

  • Tìm kiếm địa điểm: Yêu cầu thông tin về các địa điểm và nhận được bản tóm tắt dữ liệu về địa điểm do AI tạo, cũng như mã địa điểm, toạ độ vĩ độ và kinh độ, cùng đường liên kết đến Google Maps cho từng địa điểm có trong bản tóm tắt. Bạn có thể sử dụng mã địa điểm và toạ độ vĩ độ và kinh độ được trả về cùng với các API khác của Nền tảng Google Maps để hiển thị các địa điểm trên bản đồ.
  • Tra cứu thời tiết: Yêu cầu thông tin về thời tiết và trả về tình hình hiện tại, dự báo theo giờ và dự báo hằng ngày.

  • Tính toán tuyến đường: Yêu cầu thông tin về tuyến đường lái xe hoặc đi bộ giữa hai vị trí và trả về thông tin về khoảng cách và thời lượng của tuyến đường.

Việc bật máy chủ MCP Maps Grounding Lite cho phép LLM gọi các công cụ mới do máy chủ cung cấp để trả về thông tin bổ sung về cơ sở cho các loại dữ liệu nêu trên. Mặc dù LLM có thể sử dụng thông tin bổ sung này cho ngữ cảnh, nhưng câu trả lời mà LLM tạo ra cuối cùng có thể không bao gồm thông tin chính xác do máy chủ MCP trả về. Bạn nên xác minh độ chính xác của câu trả lời được tạo.

Thanh toán và hạn mức

Bạn không phải trả phí khi sử dụng Grounding Lite trong thời gian thử nghiệm. Tuy nhiên, các hạn mức sau đây áp dụng cho các công cụ do Grounding Lite cung cấp:

  • Tìm kiếm địa điểm: 100 truy vấn mỗi phút, trên mỗi dự án. 1.000 truy vấn mỗi ngày, mỗi dự án.
  • Tra cứu thời tiết: 300 lượt truy vấn mỗi phút, trên mỗi dự án.
  • Tính toán tuyến đường: 300 truy vấn mỗi phút, trên mỗi dự án.

Chính sách và điều khoản dịch vụ

Grounding Lite tuân thủ Điều khoản dịch vụ của Nền tảng Google Maps, bao gồm cả các điều khoản dành riêng cho dịch vụ đối với dịch vụ này. Phần này mô tả các yêu cầu bổ sung về việc sử dụng dịch vụ đối với Grounding Lite, bao gồm cả các LLM tương thích và các yêu cầu về việc ghi công nguồn.

Yêu cầu đối với LLM tương thích

Bạn chỉ có thể sử dụng Grounding Lite với một LLM tuân thủ Điều khoản dịch vụ của Nền tảng Google Maps.

Ví dụ: bạn chịu trách nhiệm đảm bảo rằng Nội dung trên Google Maps không được lưu vào bộ nhớ đệm, lưu trữ hoặc dùng để cải thiện LLM mà bạn chọn sử dụng. Trước khi sử dụng Grounding Lite, bạn cần xem Điều khoản dịch vụ của mọi mô hình mà bạn dự định sử dụng với Grounding Lite. Bạn không được sử dụng Grounding Lite với bất kỳ mô hình nào sử dụng dữ liệu đầu vào cho mô hình để huấn luyện hoặc cải thiện mô hình. Bạn có trách nhiệm đảm bảo rằng việc bạn sử dụng mô hình này hoàn toàn tuân thủ các quy định hạn chế đối với Nội dung trên Google Maps trong Điều khoản dịch vụ của Nền tảng Google Maps, bao gồm cả các điều khoản cụ thể về dịch vụ.

Yêu cầu về việc ghi công đối với các nguồn trên Google Maps

Mỗi câu trả lời của công cụ từ Grounding Lite đều có nguồn. Khi trình bày kết quả sử dụng các công cụ do Grounding Lite cung cấp, bạn phải đưa các nguồn Google Maps liên quan vào theo cách đáp ứng các yêu cầu sau:

  • Các nguồn trên Google Maps phải nằm ngay sau nội dung được tạo mà các nguồn đó hỗ trợ. Nội dung được tạo này còn được gọi là Đầu ra có căn cứ.
  • Người dùng phải xem được các nguồn của Google Maps trong một lượt tương tác.

Các nguồn cho công cụ Tìm địa điểm

Trường search_places của công cụ places cung cấp các nguồn hỗ trợ summary. Đối với places, siêu dữ liệu sau đây sẽ được trả về:

  • place (tên tài nguyên)
  • id
  • location
  • googleMapsLinks

Đối với mỗi vị trí, bạn phải tạo một bản xem trước đường liên kết đáp ứng các yêu cầu sau:

  • Ghi công từng nguồn cho Google Maps theo Nguyên tắc ghi công văn bản Grounding Lite.
  • Hiển thị tiêu đề trang nguồn từ siêu dữ liệu Open Graph og:title từ googleMapsLinks được cung cấp trong phản hồi.
  • Liên kết đến nguồn bằng cách sử dụng places.googleMapsLinks.placeUrl từ phản hồi.

Định cấu hình LLM để sử dụng máy chủ MCP

Để sử dụng Grounding Lite, trước tiên, bạn cần có một khoá API đã bật dịch vụ API Maps Grounding Lite. Sau đó, bạn có thể định cấu hình LLM để truy cập vào máy chủ MCP. Máy chủ Grounding Lite MCP sử dụng phương thức truyền tải HTTP có thể truyền trực tuyến.

Tạo hoặc định cấu hình khoá API

Bạn có thể sử dụng khoá API hiện có với Maps Grounding Lite hoặc tạo một khoá mới, miễn là bạn bật dịch vụ API Maps Grounding Lite trên khoá. Maps Grounding Lite API không tính phí trong quá trình thử nghiệm, nhưng bạn phải bật tính năng thanh toán cho dự án.

Cách bật API:

  1. Trong Google Cloud Console, hãy chọn dự án mà bạn muốn sử dụng cho Grounding Lite.
  2. Bật tính năng thanh toán cho dự án trong Google Cloud Console.
  3. Trên thanh điều hướng trên cùng, hãy mở thiết bị đầu cuối Cloud Shell.

  4. Chạy các lệnh sau để bật dịch vụ và điểm cuối MCP:

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

  5. Hãy làm theo các bước trong phần Bắt đầu sử dụng Google Maps Platform để tạo hoặc định cấu hình khoá API.

Khoá API phải được truyền đến máy chủ MCP bằng cách sử dụng tiêu đề X-Goog-Api-Key. Bạn cần chỉ định thông tin này làm tiêu đề HTTP tuỳ chỉnh trong cấu hình công cụ MCP của LLM.

Định cấu hình LLM để truy cập vào máy chủ Grounding Lite MCP

Sau khi có khoá API đã bật dịch vụ Maps Grounding Lite API, bạn có thể định cấu hình LLM để truy cập vào máy chủ MCP bằng cách làm theo tài liệu cấu hình MCP tương ứng và sử dụng URL máy chủ Grounding Lite MCP: https://mapstools.googleapis.com/mcp

Định cấu hình Grounding Lite bằng Gemini CLI

Phần này cung cấp ví dụ về cách định cấu hình máy chủ MCP Grounding Lite bằng Gemini CLI. Để biết thêm thông tin chi tiết, hãy xem phần Máy chủ MCP có Gemini CLI.

  1. Sau khi cài đặt Gemini CLI, bạn có thể dùng lệnh add để định cấu hình máy chủ 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

    Nếu cấu hình thành công, bạn sẽ thấy thông báo xác nhận rằng máy chủ đã được thêm vào chế độ cài đặt người dùng.

  2. Để xác thực rằng máy chủ đang hoạt động đúng cách, hãy chạy lệnh /mcp list:

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

  3. Bắt đầu đặt các câu hỏi liên quan đến Maps bằng CLI. Ví dụ: hãy thử "Đề xuất cho tôi một số nhà hàng ở Mountain View". Lệnh này sẽ gọi công cụ search_places thay cho bạn.

Chia sẻ ý kiến phản hồi

Để chia sẻ ý kiến phản hồi về Grounding Lite, hãy sử dụng các biểu mẫu sau: