Grounding Lite

Google Maps Platform Grounding Lite adalah layanan dengan dukungan Model Context Protocol (MCP) yang memudahkan Anda merujuk aplikasi AI dengan data geospasial tepercaya dari Google Maps. Server MCP menyediakan alat yang memungkinkan LLM mengakses kemampuan untuk tempat, cuaca, dan rute. Anda dapat mencoba Grounding Lite dengan mengaktifkannya di alat apa pun yang mendukung server MCP.

Alat

Grounding Lite menyediakan alat yang memungkinkan LLM mengakses kemampuan Google Maps berikut:

  • Menelusuri tempat: Meminta informasi tentang tempat dan mendapatkan ringkasan data tempat yang dibuat AI, serta ID Tempat, koordinat lintang dan bujur, dan link Google Maps untuk setiap tempat yang disertakan dalam ringkasan. Anda dapat menggunakan ID Tempat dan koordinat garis lintang dan garis bujur yang ditampilkan dengan Google Maps Platform API lainnya untuk menampilkan tempat di peta.
  • Mencari cuaca: Meminta informasi tentang cuaca dan menampilkan kondisi saat ini, prakiraan per jam, dan prakiraan harian.

  • Menghitung rute: Meminta informasi tentang rute mengemudi atau berjalan kaki antara dua lokasi dan menampilkan informasi jarak dan durasi rute.

Mengaktifkan server MCP Perujukan Maps Lite memungkinkan LLM memanggil alat baru yang diekspos oleh server untuk menampilkan informasi perujukan tambahan untuk jenis data yang tercantum di atas. Meskipun LLM dapat menggunakan informasi tambahan ini untuk konteks, respons yang dihasilkan LLM pada akhirnya mungkin tidak menyertakan informasi persis yang ditampilkan oleh server MCP. Anda harus memverifikasi akurasi respons yang dihasilkan.

Coba aplikasi contoh Grounding Lite (Buka di tab baru)

Penagihan dan kuota

Penggunaan Grounding Lite tidak dikenai biaya selama masih dalam tahap Eksperimental. Namun, kuota berikut berlaku untuk alat yang disediakan oleh Grounding Lite:

  • Menelusuri tempat: 100 kueri per menit, per project. 1.000 kueri per hari, per project.
  • Mencari cuaca: 300 kueri per menit, per project.
  • Menghitung rute: 300 kueri per menit, per project.

Kebijakan dan persyaratan layanan

Grounding Lite tunduk pada Persyaratan Layanan Google Maps Platform, termasuk persyaratan khusus layanan untuk layanan ini. Bagian ini menjelaskan persyaratan penggunaan layanan tambahan untuk Grounding Lite, termasuk LLM yang kompatibel dan persyaratan atribusi sumber.

Persyaratan untuk LLM yang Kompatibel

Anda hanya boleh menggunakan Grounding Lite dengan LLM yang mematuhi Persyaratan Layanan Google Maps Platform.

Misalnya, Anda bertanggung jawab untuk memastikan bahwa Konten Google Maps tidak di-cache, disimpan, atau digunakan untuk meningkatkan kualitas LLM yang Anda pilih untuk digunakan. Sebelum menggunakan Grounding Lite, Anda harus meninjau Persyaratan Layanan untuk model apa pun yang ingin Anda gunakan dengan Grounding Lite. Anda tidak boleh menggunakan Grounding Lite dengan model apa pun yang menggunakan input data ke dalam model untuk pelatihan atau peningkatan kualitas model. Anda bertanggung jawab untuk memastikan bahwa penggunaan model oleh Anda sepenuhnya mematuhi batasan pada Konten Google Maps dalam Persyaratan Layanan Google Maps Platform, termasuk persyaratan khusus layanan.

Persyaratan atribusi untuk sumber Google Maps

Setiap respons alat dari Grounding Lite menyertakan sumber. Saat menyajikan hasil yang menggunakan alat yang disediakan oleh Grounding Lite, Anda harus menyertakan sumber Google Maps terkait dengan cara yang memenuhi persyaratan berikut:

  • Sumber Google Maps harus segera mengikuti konten yang dihasilkan yang didukung oleh sumber tersebut. Konten yang dihasilkan ini juga disebut sebagai Output yang Berbasis.
  • Sumber Google Maps harus dapat dilihat dalam satu interaksi pengguna.

Sumber untuk alat Penelusuran tempat

Kolom places alat search_places menyediakan sumber yang mendukung summary. Untuk places, metadata berikut ditampilkan:

  • place (nama resource)
  • id
  • location
  • googleMapsLinks

Untuk setiap tempat, Anda harus membuat pratinjau link yang memenuhi persyaratan berikut:

Mengonfigurasi LLM untuk menggunakan server MCP

Untuk menggunakan Grounding Lite, Anda memerlukan project Google Cloud dengan layanan API Maps Grounding Lite yang diaktifkan, serta kunci API atau client ID OAuth. Kemudian, Anda dapat mengonfigurasi LLM untuk mengakses server MCP. Server MCP Grounding Lite menggunakan transportasi HTTP yang dapat di-streaming.

Mengaktifkan layanan Maps Grounding Lite di project Google Cloud Anda

Untuk mengaktifkan API di project Anda:

  1. Di Konsol Google Cloud, pilih project yang ingin Anda gunakan untuk Grounding Lite.
  2. Aktifkan penagihan untuk project di Konsol Google Cloud.
  3. Dari navigasi atas, buka terminal Cloud Shell.

  4. Jalankan perintah berikut untuk mengaktifkan layanan dan endpoint MCP:

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

Melakukan autentikasi menggunakan kunci API

Anda dapat menggunakan kunci API yang sudah ada dengan Maps Grounding Lite atau membuat kunci API baru, selama Anda mengaktifkan layanan Maps Grounding Lite API di project Google Cloud dan kunci.

Untuk melakukan autentikasi menggunakan kunci API:

  1. Buat atau konfigurasi kunci API dengan mengikuti langkah-langkah di Mulai menggunakan Google Maps Platform.
  2. Teruskan kunci ke server MCP menggunakan header X-Goog-Api-Key. Anda perlu menentukannya sebagai header HTTP kustom dalam konfigurasi alat MCP LLM.

Melakukan autentikasi menggunakan OAuth

Anda dapat melakukan autentikasi menggunakan OAuth dengan membuat kredensial OAuth dan meneruskannya ke aplikasi host MCP atau server MCP.

Untuk mengautentikasi menggunakan OAuth:

  1. Di Konsol Google Cloud, pilih project yang ingin Anda gunakan untuk Grounding Lite.
  2. Di menu API & Services, pilih Credentials.
  3. Di menu atas, pilih Create credentials > OAuth client ID.
  4. Jika project tidak memiliki layar izin yang dikonfigurasi, klik Konfigurasi layar izin dan ikuti petunjuk di layar.
  5. Di bagian Metrik, klik Buat klien OAuth.
  6. Di layar Buat ID klien OAuth, pilih jenis aplikasi dan masukkan nama untuk ID klien.
  7. Tentukan detail tambahan yang relevan dengan jenis permohonan Anda. Misalnya, jika Anda membuat aplikasi web, tambahkan URI yang diizinkan untuk permintaan browser dan server.
  8. Setelah klien Anda dibuat, simpan ID dan rahasia klien.
  9. Saat mengonfigurasi host MCP atau aplikasi server MCP untuk mengakses Grounding Lite, teruskan ID dan secret klien OAuth Anda.

Untuk mengetahui informasi selengkapnya, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Mengonfigurasi LLM untuk mengakses server MCP Grounding Lite

Setelah memiliki project Google Cloud dengan layanan Maps Grounding Lite API yang diaktifkan dan kredensial yang valid, seperti kunci API atau ID dan secret klien OAuth, Anda dapat mengonfigurasi LLM untuk mengakses server MCP dengan mengikuti dokumentasi konfigurasi MCP yang sesuai dan menggunakan URL server MCP Grounding Lite: https://mapstools.googleapis.com/mcp

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi MCP di aplikasi AI.

Mengonfigurasi Grounding Lite dengan Gemini CLI

Bagian ini memberikan contoh cara mengonfigurasi server MCP Grounding Lite menggunakan Gemini CLI. Untuk mengetahui detail selengkapnya, lihat Server MCP dengan Gemini CLI.

  1. Setelah menginstal Gemini CLI, Anda dapat menggunakan perintah add untuk mengonfigurasi server 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

    Jika konfigurasi berhasil, Anda akan melihat konfirmasi bahwa server telah ditambahkan ke setelan pengguna Anda.

  2. Untuk memvalidasi bahwa server berfungsi dengan benar, jalankan perintah /mcp list:

    > /mcp list

Configured MCP servers:

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

  3. Mulai ajukan pertanyaan terkait Maps dengan CLI. Misalnya, coba ucapkan "Rekomendasikan beberapa restoran di Mountain View" yang akan memanggil alat search_places atas nama Anda.

Membagikan masukan

Untuk memberikan masukan tentang Grounding Lite, gunakan formulir berikut: