Halaman ini diterjemahkan oleh Cloud Translation API.

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 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.

Catatan: Grounding Lite tidak memberikan perutean, rute, info lalu lintas real-time, atau informasi navigasi langkah demi langkah

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.

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:

Telusuri tempat: 100 kueri per menit, per project. 1.000 kueri per hari, per project.
Mencari cuaca: 300 kueri per menit, per project.
Rute komputasi: 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 memberikan 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:

Atribusikan setiap sumber ke Google Maps, dengan mengikuti panduan atribusi teks Grounding Lite.
Tampilkan judul halaman sumber dari metadata Open Graph og:title dari googleMapsLinks yang diberikan dalam respons.
Tautkan ke sumber menggunakan places.googleMapsLinks.placeUrl dari respons.

Mengonfigurasi LLM untuk menggunakan server MCP

Untuk menggunakan Grounding Lite, Anda memerlukan kunci API dengan layanan API Maps Grounding Lite diaktifkan terlebih dahulu. Kemudian, Anda dapat mengonfigurasi LLM untuk mengakses server MCP. Server MCP Grounding Lite menggunakan transportasi HTTP yang dapat di-streaming.

Membuat atau mengonfigurasi kunci API

Anda dapat menggunakan kunci API yang ada dengan Maps Grounding Lite atau membuat kunci API baru, selama Anda mengaktifkan Maps Grounding Lite API service di kunci tersebut. Maps Grounding Lite API tidak dikenai biaya selama eksperimental, tetapi penagihan harus diaktifkan di project.

Untuk mengaktifkan API:

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

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

Ikuti langkah-langkah di Memulai Google Maps Platform untuk membuat atau mengonfigurasi kunci API.

Kunci API harus diteruskan ke server MCP menggunakan header X-Goog-Api-Key. Anda harus menentukannya sebagai header HTTP kustom dalam konfigurasi alat MCP LLM.

Mengonfigurasi LLM untuk mengakses server MCP Grounding Lite

Setelah memiliki kunci API dengan layanan Maps Grounding Lite API yang diaktifkan, 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

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.

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.

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

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: