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 mọi công cụ 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ề địa điểm và nhận 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 độ, và đườ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ề 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.

Dùng thử ứng dụng mẫu Grounding Lite (Mở trong thẻ mới)

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, 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 nhận 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:

Đị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 dự án trên Google Cloud đã bật dịch vụ API Maps Grounding Lite, cũng như khoá API hoặc mã nhận dạng ứng dụng OAuth. Sau đó, bạn có thể định cấu hình các 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.

Bật dịch vụ Maps Grounding Lite trên dự án Google Cloud

Cách bật API trên dự án:

  1. Trong Google Cloud Console, hãy chọn dự án mà bạn muốn 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

Xác thực bằng 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 cả dự án Google Cloud và khoá.

Cách xác thực bằng khoá API:

  1. Tạo hoặc định cấu hình khoá API bằng cách làm theo các bước trong phần Bắt đầu sử dụng Nền tảng Google Maps.
  2. Truyền khoá đến máy chủ MCP bằng tiêu đề X-Goog-Api-Key. Bạn cần chỉ định tham số này làm tiêu đề HTTP tuỳ chỉnh trong cấu hình công cụ MCP của LLM.

Xác thực bằng OAuth

Bạn có thể xác thực bằng OAuth bằng cách tạo thông tin đăng nhập OAuth và truyền thông tin đăng nhập đó đến máy chủ lưu trữ MCP hoặc ứng dụng máy chủ MCP.

Cách xác thực bằng OAuth:

  1. Trong Google Cloud Console, hãy chọn dự án mà bạn muốn dùng cho Grounding Lite.
  2. Trong trình đơn API và Dịch vụ, hãy chọn Thông tin xác thực.
  3. Trong trình đơn trên cùng, hãy chọn Tạo thông tin xác thực > Mã ứng dụng khách OAuth.
  4. Nếu dự án chưa có màn hình đồng ý đã định cấu hình, hãy nhấp vào Định cấu hình màn hình đồng ý rồi làm theo hướng dẫn trên màn hình.
  5. Trong mục Chỉ số, hãy nhấp vào Tạo ứng dụng khách OAuth.
  6. Trên màn hình Tạo mã ứng dụng OAuth, hãy chọn một loại ứng dụng và nhập tên cho mã ứng dụng.
  7. Nêu rõ thông tin chi tiết bổ sung liên quan đến loại ứng dụng của bạn. Ví dụ: nếu bạn đang tạo một ứng dụng web, hãy thêm các URI được uỷ quyền cho yêu cầu của trình duyệt và máy chủ.
  8. Sau khi bạn tạo ứng dụng khách, hãy lưu mã ứng dụng khách và khoá bí mật.
  9. Khi định cấu hình ứng dụng máy chủ MCP hoặc máy chủ lưu trữ MCP để truy cập vào Grounding Lite, hãy truyền mã ứng dụng khách và khoá bí mật OAuth của bạn.

Để biết thêm thông tin, hãy xem bài viết Sử dụng OAuth 2.0 để truy cập vào các API của Google.

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

Sau khi có một dự án trên Google Cloud đã bật dịch vụ Maps Grounding Lite API và thông tin đăng nhập hợp lệ, chẳng hạn như khoá API hoặc mã ứng dụng và khoá bí mật OAuth, 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 định cấu hình MCP tương ứng và sử dụng URL máy chủ Grounding Lite MCP: https://mapstools.googleapis.com/mcp

Để biết thêm thông tin, hãy xem phần Định cấu hình MCP trong ứng dụng AI.

Đị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: