Perujukan dengan Google Maps di Vertex AI menggabungkan kecanggihan Gemini dengan Google Maps, yang memiliki akses ke informasi tentang lebih dari 250 juta tempat. Integrasi penting yang tersedia melalui Vertex AI ini dirancang untuk membantu Anda membuat aplikasi generatif generasi baru.
Halaman ini menjelaskan cara menggunakan Google Maps untuk membatasi respons LLM Anda.
Ringkasan
Grounding dengan Google Maps di Vertex AI adalah layanan yang memungkinkan Anda menggunakan data Google Maps dengan LLM untuk memberikan respons yang lebih akurat dan sesuai konteks terhadap perintah Anda. Grounding dengan Google Maps terintegrasi dengan Vertex AI untuk mendukung penggunaan data geografis dengan model Gemini Anda.
Perujukan dengan Google Maps membantu Anda menemukan tempat baru, merencanakan acara, dan mendapatkan rekomendasi untuk berbagai lokasi. Anda dapat melakukan hal berikut:
- Tanyakan kepada asisten percakapan tentang area tersebut dan tempat terdekat. Asisten Anda memiliki akses ke informasi waktu perjalanan dan dapat memberi tahu Anda seberapa jauh suatu tempat dari lokasi Anda. Misalnya, Apakah ada taman di dekat sini?
- Lihat deskripsi yang dipersonalisasi tentang tempat yang sesuai dengan kriteria Anda. Misalnya, Dapatkah Anda memberi tahu saya lebih lanjut tentang taman dan restoran ramah keluarga yang berada dalam jarak yang dapat ditempuh dengan berjalan kaki?
Dengan perujukan menggunakan Google Maps, Anda dapat membuat aplikasi AI generatif dari chat yang didukung LLM menggunakan konteks geospasial untuk membuat ringkasan berbasis lokasi yang dipersonalisasi guna membantu Anda membuat keputusan yang lebih baik.
Untuk mendapatkan bantuan, kirim pesan ke maps-grounding-feedback-external@google.com
.
Model yang didukung
Bagian ini mencantumkan model yang mendukung perujukan dengan Google Maps.
- Gemini 2.5 Flash-Lite
Pratinjau - Gemini 2.5 Flash dengan audio native Live API
Pratinjau - Gemini 2.0 Flash dengan Live API
Pratinjau - Gemini 2.5 Pro
- Gemini 2.5 Flash
- Gemini 2.0 Flash
Untuk mengetahui informasi selengkapnya tentang model Gemini, lihat Model Gemini.
Akses ke Perujukan dengan Google Maps
Untuk menggunakan Perujukan dengan Google Maps di Vertex AI, ikuti langkah-langkah berikut:
Untuk meminta akses guna menggunakan Perujukan dengan Google Maps di Vertex AI untuk project tertentu, isi dan kirimkan formulir Ikut serta atau Tidak ikut serta untuk menggunakan Google Maps.
Formulir ini memerlukan alamat email, nama perusahaan, project ID, dan persetujuan Anda terhadap persyaratan.
Jika Anda tidak memiliki project, lihat Membuat dan mengelola project.
Di konsol Google Cloud , buka halaman Maps Grounding API.
Untuk mengaktifkan Maps Grounding API, klik Aktifkan. Pilih project, dan halaman Maps Grounding API akan ditampilkan.
Di Google Cloud konsol, buka halaman Maps JavaScript API.
Untuk mengaktifkan JavaScript, klik Aktifkan. Pilih project, lalu halaman APIs & Services akan ditampilkan.
Untuk memverifikasi bahwa Google Maps diaktifkan, buka Vertex AI Studio.
Pilih project yang Anda aktifkan API-nya.
Untuk mengaktifkan fitur Google Maps di bagian Alat pada panel model, klik tombol Perujukan: Google.
Pilih Pratinjau Google Maps.
Masukkan Kunci API.
- Jika Anda tidak memiliki Kunci API, lihat Membuat kunci API.
- Batasi penggunaan API dengan Membatasi kunci API.
Pilih Lokasi untuk respons berbasis lokasi.
Klik Terapkan.
Properti tempat
Bagian ini mencantumkan properti tempat yang digunakan untuk mendeskripsikan lokasi dan digunakan oleh Perujukan dengan Google Maps untuk menghasilkan respons. Properti ini digunakan untuk menentukan jenis pertanyaan yang dapat dijawab oleh Perujukan dengan Google Maps.
Contoh properti tempat
Daftar ini memberikan contoh properti yang diurutkan berdasarkan abjad tentang tempat yang mungkin digunakan oleh model Anda untuk menghasilkan respons.
- Alamat
- Khusus tunai
- Kartu kredit
- Pengambilan di tepi jalan
- Kartu debit
- Jarak
- Tempat parkir gratis
- Musik live
- Menu untuk anak-anak
- Jam buka
- Boleh bawa hewan peliharaan
- Menyajikan bir
- Menyajikan makanan vegetarian
- Dapat diakses pengguna kursi roda
- Wi-Fi
Contoh penggunaan properti tempat
Contoh berikut menggunakan properti tempat dalam pertanyaan tentang berbagai jenis tempat. Perujukan dengan Google Maps menggunakan properti untuk memahami maksud Anda, lalu memberikan jawaban yang relevan berdasarkan data yang terkait dengan tempat di Google Maps.
Merencanakan makan malam keluarga: Anda dapat bertanya, Apakah "The Italian Place" cocok untuk anak-anak, dan apakah mereka menawarkan layanan pesan bawa? Berapa rating mereka?
Jawaban atas pertanyaan-pertanyaan ini akan membantu Anda menentukan apakah restoran cocok untuk keluarga dan apakah restoran menawarkan layanan yang nyaman.
Memeriksa aksesibilitas untuk teman: Anda dapat bertanya, Saya perlu restoran yang memiliki pintu masuk yang dapat diakses kursi roda.
Respons terhadap perintah ini dapat membantu Anda menentukan apakah lokasi tersebut memenuhi kebutuhan aksesibilitas tertentu.
Menemukan lokasi untuk camilan larut malam: Anda dapat bertanya, Apakah "Burger Joint" buka sekarang? Apakah mereka menyajikan makan malam? Jam berapa mereka buka pada hari Jumat?
Jawaban atas pertanyaan ini membantu Anda menemukan restoran yang buka dan menyajikan makanan tertentu pada waktu tertentu.
Bertemu klien di kedai kopi: Anda dapat bertanya, Apakah "Cafe Central" memiliki Wi-Fi? Apakah mereka menyajikan kopi? Berapa tingkat harganya, dan apakah mereka menerima kartu kredit?
Jawaban atas pertanyaan ini membantu Anda menilai kesesuaian kafe untuk pertemuan bisnis berdasarkan fasilitas, penawaran, dan opsi pembayaran.
Menggunakan Perujukan dengan Google Maps untuk merujuk model Anda
Anda dapat menggunakan Google Maps API untuk mendasari respons model Anda.
Contoh kode ini menunjukkan cara menggunakan Maps API untuk mendasari respons model Anda menggunakan Perujukan dengan Google Maps.
Gen AI SDK for Python
Instal
pip install --upgrade google-genai
Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.
Tetapkan variabel lingkungan untuk menggunakan Gen AI SDK dengan Vertex AI:
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT export GOOGLE_CLOUD_LOCATION=global export GOOGLE_GENAI_USE_VERTEXAI=True
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- LOCATION: Region untuk memproses permintaan.
- PROJECT_ID: Project ID Anda.
- MODEL_ID: ID model multimodal.
- TEXT: Petunjuk teks yang akan disertakan dalam perintah.
- API_KEY: Kunci API Anda.
- LATITUDE: Garis lintang lokasi.
- LONGITUDE: Bujur lokasi.
Metode HTTP dan URL:
POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent
Meminta isi JSON:
{ "contents": [{ "role": "user", "parts": [{ "text": "TEXT" }] }], "tools": [{ "googleMaps": { "authConfig": { "apiKeyConfig": { "apiKeyString": "API_KEY" } } } }], "toolConfig": { "retrievalConfig": { "latLng": { "latitude": LATITUDE, "longitude": LONGITUDE } } }, "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID" }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "candidates": [ { "content": { "role": "model", "parts": [ { "text": "Here are a few options for late-night burgers in San Jose, based on the search results. Keep in mind that \"late night\" can be subjective, so I've included places with varying closing times. I recommend double-checking their hours before you go, as these can change.\n\n* **Campus Burgers:** Open until 12:00 AM every night except Sunday (closed).\n* **Lazy Dog Restaurant & Bar:** Open until 12:00 AM every night.\n* **Dough Burger:** Open until 1:30 AM Monday through Thursday and Sunday, and until 3:00 AM on Friday and Saturday.\n* **El Apartamento Colombian Burgers:** Open until 1:00 AM on Friday and Saturday, and until 10:30 PM Monday through Wednesday and until 11:00 PM Thursday and Sunday.\n* **Paper Plane:** Open until 2:00 AM Thursday through Saturday, and until 12:00 AM on Tuesday and Wednesday and Sunday. Closed on Monday.\n\nNote that opening hours are subject to change.\n" } ] }, "finishReason": "STOP", "groundingMetadata": { "retrievalQueries": [ "late night burger san jose" ], "groundingChunks": [ { "maps": { "uri": "https://maps.google.com/?cid=15700677770979677665", "title": "El Apartamento Colombian Burgers", "text": "**About:**\n\n* **Type:** Hamburger Restaurant\n* **Address:** 76 E Santa Clara St, San Jose, CA 95113, USA\n* **Open Now:** No\n* **Rating:** 4.9 (25 reviews)\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Outdoor Seating:** No\n* **Live Music:** No\n* **Curbside Pickup:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 5:00 – 10:30 PM\n* Tuesday: 5:00 – 10:30 PM\n* Wednesday: 5:00 – 10:30 PM\n* Thursday: 4:00 – 11:00 PM\n* Friday: 4:00 PM – 1:00 AM\n* Saturday: 4:00 PM – 1:00 AM\n* Sunday: 4:00 – 11:00 PM\n\n**Parking options:**\n\n* **Free street parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Cash Only:** No\n\n**Distance & Travel Time:**\n\n* 4733.0 kilometers\n* 43.4 hours" } }, { "maps": { "uri": "https://maps.google.com/?cid=8798666889278262772", "title": "Campus Burgers", "text": "**About:**\n\n* **Type:** Hamburger Restaurant\n* **Address:** 108 Paseo de San Antonio, San Jose, CA 95113, USA\n* **Open Now:** Yes\n* **Rating:** 4.4 (207 reviews)\n* **Price Level:** Inexpensive\n* **Phone:** (408) 352-5507\n* **Additional Summary:** Simple hamburger restaurant with a limited menu of comfort fare such as burgers and fries.\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Good for Groups:** Yes\n* **Outdoor Seating:** Yes\n* **Live Music:** No\n* **Menu for Children:** No\n* **Serves Cocktails:** No\n* **Serves Dessert:** Yes\n* **Serves Coffee:** No\n* **Good for Watching Sports:** No\n* **Serves Lunch:** Yes\n* **Serves Dinner:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 11:00 AM – 12:00 AM\n* Tuesday: 11:00 AM – 12:00 AM\n* Wednesday: 11:00 AM – 12:00 AM\n* Thursday: 11:00 AM – 12:00 AM\n* Friday: 11:00 AM – 12:00 AM\n* Saturday: 11:00 AM – 12:00 AM\n* Sunday: Closed\n\n**Parking options:**\n\n* **Paid parking lot:** Yes\n* **Free street parking:** Yes\n* **Paid street parking:** Yes\n* **Valet parking:** No\n* **Paid garage parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Debit Card:** Yes\n* **Cash Only:** No\n* **NFC:** Yes\n\n**Distance & Travel Time:**\n\n* 4732.5 kilometers\n* 43.4 hours" } }, { "maps": { "uri": "https://maps.google.com/?cid=3915125089239094417", "title": "Paper Plane", "text": "**About:**\n\n* **Type:** Bar\n* **Address:** 72 S 1st St, San Jose, CA 95113, USA\n* **Open Now:** No\n* **Rating:** 4.4 (2452 reviews)\n* **Price Level:** Moderate\n* **Phone:** (408) 713-2625\n* **Summary:** Relaxed spot with a long bar in an exposed brick space for creative or classic cocktails & snacks.\n* **Additional Summary:** Casual, popular bar serving signature cocktails and New American fare, including burgers and tacos.\n* **Takes Reservations:** Yes\n* **Offers Takeout:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** No\n* **Allows Dogs:** No\n* **Has Restroom:** Yes\n* **Good for Groups:** Yes\n* **Outdoor Seating:** No\n* **Live Music:** No\n* **Serves Cocktails:** Yes\n* **Good for Watching Sports:** No\n* **Serves Beer:** Yes\n* **Serves Wine:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: Closed\n* Tuesday: 5:00 PM – 12:00 AM\n* Wednesday: 5:00 PM – 12:00 AM\n* Thursday: 5:00 PM – 2:00 AM\n* Friday: 5:00 PM – 2:00 AM\n* Saturday: 5:00 PM – 2:00 AM\n* Sunday: 5:00 PM – 12:00 AM\n\n**Parking options:**\n\n* **Paid parking lot:** Yes\n* **Free street parking:** Yes\n* **Paid street parking:** Yes\n* **Valet parking:** No\n* **Paid garage parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible entrance:** Yes\n* **Wheelchair accessible restroom:** Yes\n* **Wheelchair accessible seating:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Cash Only:** No\n* **NFC:** Yes\n\n**Distance & Travel Time:**\n\n* 4733.0 kilometers\n* 43.4 hours" } }, { "maps": { "uri": "https://maps.google.com/?cid=12662287798905863411", "title": "Lazy Dog Restaurant & Bar", "text": "**About:**\n\n* **Type:** American Restaurant\n* **Address:** 5305 Almaden Expy, San Jose, CA 95118, USA\n* **Open Now:** Yes\n* **Rating:** 4.2 (940 reviews)\n* **Price Level:** Moderate\n* **Phone:** (408) 786-9594\n* **Summary:** Relaxed, lodge-chic chain serving global comfort fare, including stir-fries, pot roast & pastas.\n* **Additional Summary:** American food including comfort fare and small plates served in a casual setting with a bar.\n* **Takes Reservations:** Yes\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Allows Dogs:** Yes\n* **Has Restroom:** Yes\n* **Good for Groups:** Yes\n* **Outdoor Seating:** Yes\n* **Live Music:** No\n* **Menu for Children:** Yes\n* **Serves Cocktails:** Yes\n* **Serves Dessert:** Yes\n* **Serves Coffee:** Yes\n* **Has Wifi:** Yes\n* **Good for Watching Sports:** Yes\n* **Curbside Pickup:** Yes\n* **Serves Lunch:** Yes\n* **Serves Dinner:** Yes\n* **Serves Beer:** Yes\n* **Serves Wine:** Yes\n* **Serves Brunch:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 11:00 AM – 12:00 AM\n* Tuesday: 11:00 AM – 12:00 AM\n* Wednesday: 11:00 AM – 12:00 AM\n* Thursday: 11:00 AM – 12:00 AM\n* Friday: 11:00 AM – 12:00 AM\n* Saturday: 10:00 AM – 12:00 AM\n* Sunday: 10:00 AM – 12:00 AM\n\n**Parking options:**\n\n* **Free parking lot:** Yes\n* **Free street parking:** Yes\n* **Valet parking:** No\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n* **Wheelchair accessible restroom:** Yes\n* **Wheelchair accessible seating:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Debit Card:** Yes\n* **Cash Only:** No\n* **NFC:** Yes\n\n**Distance & Travel Time:**\n\n* 4745.7 kilometers\n* 43.5 hours" } }, { "maps": { "uri": "https://maps.google.com/?cid=12520445715080978741", "title": "Dough Burger", "text": "**About:**\n\n* **Type:** Restaurant\n* **Address:** 1721 Old Bayshore Hwy, San Jose, CA 95112, USA\n* **Open Now:** No\n* **Rating:** 4.2 (61 reviews)\n* **Phone:** (408) 515-0161\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Live Music:** No\n* **Curbside Pickup:** Yes\n* **Serves Lunch:** Yes\n* **Serves Dinner:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 6:00 PM – 1:30 AM\n* Tuesday: 6:00 PM – 1:30 AM\n* Wednesday: 6:00 PM – 1:30 AM\n* Thursday: 6:00 PM – 1:30 AM\n* Friday: 6:00 PM – 3:00 AM\n* Saturday: 6:00 PM – 3:00 AM\n* Sunday: 6:00 PM – 1:30 AM\n\n**Parking options:**\n\n* **Free parking lot:** Yes\n* **Free street parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Cash Only:** No\n\n**Distance & Travel Time:**\n\n* 4740.1 kilometers\n* 43.3 hours" } } ], "groundingSupports": [ { "segment": { "startIndex": 267, "endIndex": 346, "text": "* **Campus Burgers:** Open until 12:00 AM every night except Sunday (closed)." }, "groundingChunkIndices": [ 1 ], "confidenceScores": [ 0.76444983 ] } ], "googleMapsWidgetContextToken": "widgetcontent/AcBXPQfo6pGrCXPJeN2xtADMw1TPz8Wzwm-..." } } ], "usageMetadata": { "promptTokenCount": 7, "candidatesTokenCount": 236, "totalTokenCount": 243, "trafficType": "ON_DEMAND", "promptTokensDetails": [ { "modality": "TEXT", "tokenCount": 7 } ], "candidatesTokensDetails": [ { "modality": "TEXT", "tokenCount": 236 } ] }, "modelVersion": "gemini-2.0-flash-001", "createTime": "2025-04-03T20:11:51.118341Z" } ```
Merender widget kontekstual Google Maps
Merender widget kontekstual Google Maps diperlukan sebagai bagian dari penggunaan Perujukan dengan Google Maps di Vertex AI. Dalam setiap respons yang didasarkan pada Google Maps, terdapat googleMapsWidgetContextToken
yang sesuai yang digunakan untuk merender widget kontekstual di dekat respons yang dihasilkan.
"googleMapsWidgetContextToken": "widgetcontent/AcBXPQdpWQWbap9H-OH8sEKmOXxmEKAYvff0tvthhneMQC3VrqWCjpnPBl4-Id98FGiA_S_t8aeAeJj0T6JkWFX56Bil8oBSR0W8JH3C_RSYLbTjxKdpxc9yNn6JcZTtolIRZon9xi6WpNGuSyjcIxWu2S0hwpasNOpUlWrG1RxVCB4WD1fsz_pwR236mG36lMxevXTQ_JnfdYNuQwQ4Lc3vn...<snip>...
Ts5VJE_b3IC5eE_6wez0nh61r7foTUZpP7BXMwxR-7Wyfcj6x1v6mIWsFGr1o0p_HSAMNqWPg-aFVnkPLhAkOR6MaNZOfezTva-gxHlu7z_haFvYxcUE1qfNVQ",
Halaman Anda yang menampilkan widget harus menggunakan versi alfa Google Maps JS API. Untuk mengetahui informasi selengkapnya, lihat Memuat Maps JavaScript API.
Anda harus menggunakan kunci API yang diaktifkan untuk Perujukan dengan Google Maps di Vertex AI untuk memuat Google Maps JS API.
Contoh kode ini menunjukkan cara membuat widget menggunakan HTML.
<body>
<gmp-place-contextual id="widget"></gmp-place-contextual>
</body>
Di Javascript Anda, gunakan metode berikut untuk memperbarui token konteks:
function updateWidget(contextToken) {
let widget = document.querySelector('#widget');
widget.contextToken = contextToken;
}
Anda juga dapat membuat widget secara dinamis dengan kode berikut:
async function createWidget(contextToken) {
await google.maps.importLibrary('places');
let widgetContainer = document.querySelector('#wc'); // a div that contains the widget
const placeContextualElement = new
google.maps.places.PlaceContextualElement({ contextToken });
widgetContainer.appendChild(placeContextualElement);
}
Contoh kode HTML ini menunjukkan cara menggunakan opsi konfigurasi untuk beralih
antara dua tata letak yang berbeda (compact
atau vertical
).
<gmp-place-contextual id="widget">
<gmp-place-contextual-list-config layout="compact">
</gmp-place-contextual-list-config>
</gmp-place-contextual>
Contoh kode HTML ini menunjukkan cara menonaktifkan peta.
<gmp-place-contextual id="widget">
<gmp-place-contextual-list-config map-hidden>
</gmp-place-contextual-list-config>
</gmp-place-contextual>
Contoh kode JavaScript ini menunjukkan cara menentukan tata letak compact
dan cara menyembunyikan peta.
const widgetConfig = new google.maps.places.PlaceContextualListConfigElement({
layout: 'compact',
mapHidden: true
});
widget.appendChild(widgetConfig);
Langkah berikutnya
- Untuk mempelajari lebih lanjut cara mendasarkan model Gemini pada data Anda, lihat Mendasarkan dengan data Anda.
- Untuk mempelajari lebih lanjut praktik terbaik AI yang bertanggung jawab dan filter keamanan Vertex AI, lihat Responsible AI.