Halaman ini menjelaskan bagaimana Perujukan dengan Google Maps dan Vertex AI dapat membantu meningkatkan kualitas aplikasi AI generatif Anda dengan memberikan konteks geospasial.
Ringkasan
Penyesuaian dengan Google Maps menggunakan Vertex AI adalah layanan yang menghubungkan model Gemini dengan data geospasial dari Google Maps. Google Maps memiliki akses ke informasi tentang jutaan lokasi, termasuk bisnis, landmark, dan tempat menarik. Data ini memberi Anda akses ke informasi tentang lebih dari 250 juta tempat yang dapat digunakan untuk mendasari respons model Anda, sehingga memungkinkan aplikasi dan agen AI Anda memberikan data lokal dan konteks geospasial.
Anda juga dapat mengaktifkan perujukan serentak dengan Google Maps, Google Penelusuran, dan perujukan dengan sumber data Anda.
Penggunaan Grounding dengan Google Maps
Anda dapat menggunakan Grounding dengan Google Maps untuk berbagai aplikasi, seperti:
- Asisten percakapan yang dapat menjawab pertanyaan tentang tempat terdekat, seperti "Di mana tempat terdekat untuk mendapatkan espresso Italia?"
- Deskripsi yang dipersonalisasi dan insight komunitas, seperti"Bisakah Anda memberi tahu saya lebih lanjut tentang restoran ramah keluarga yang berada dalam jarak yang dapat ditempuh dengan berjalan kaki?"
- Ringkasan area di sekitar lokasi tertentu, seperti SPKLU atau hotel.
Hal ini dapat bermanfaat untuk kasus penggunaan di aplikasi real estate, perjalanan, mobilitas, dan media sosial.
Model yang didukung
Bagian ini mencantumkan model yang mendukung Perujukan dengan Google Maps.
Gemini 3 Pro dan Gemini 3 Pro Image dibatasi hingga 5.000 kueri penelusuran per hari.
Untuk mengetahui informasi selengkapnya tentang model Gemini, lihat Model Gemini.
Menggunakan Perujukan dengan Google Maps untuk merujuk respons model Anda
Contoh kode ini menunjukkan cara menggunakan Grounding with Google Maps untuk mendasari respons model Anda.
Hasil penelusuran dapat disesuaikan untuk lokasi geografis tertentu menggunakan koordinat lintang dan bujur. Untuk mengetahui informasi selengkapnya, lihat API Perujukan.
Konsol
Untuk menggunakan Perujukan dengan Google Maps dan Vertex AI, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Vertex AI Studio.
Di bagian Tools, klik Grounding: Google. Panel konfigurasi akan muncul.
Untuk menggunakan Google Maps, klik tombol Google Maps.
Klik Terapkan.
Masukkan perintah Anda di kolom, lalu klik Kirim. Respons cepat Anda dasar untuk Google Maps.
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
from google import genai
from google.genai.types import (
GenerateContentConfig,
GoogleMaps,
HttpOptions,
Tool,
)
client = genai.Client(http_options=HttpOptions(api_version="v1"))
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="Where can I get the best espresso near me?",
config=GenerateContentConfig(
tools=[
# Use Google Maps Tool
Tool(google_maps=GoogleMaps(
enable_widget=False # Optional: return Maps widget token
))
],
tool_config=types.ToolConfig(
retrieval_config = types.RetrievalConfig(
lat_lng = types.LatLng( # Pass geo coordinates for location-aware grounding
latitude=40.7128,
longitude=-74.006
),
language_code = "en_US", # Optional: localize Maps results
),
),
),
)
print(response.text)
# Example response:
# 'Here are some of the top-rated places to get espresso near you: ...'
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- LOCATION: Region untuk memproses permintaan. Untuk menggunakan endpoint global, kecualikan lokasi dari nama endpoint dan konfigurasi lokasi resource ke global.
- PROJECT_ID: Project ID Anda.
- MODEL_ID: ID model multimodal.
- PROMPT: Perintah yang akan dikirim ke model.
- LATITUDE: Garis lintang lokasi. Misalnya, garis lintang
37.7749mewakili San Francisco. Anda dapat memperoleh koordinat lintang dan bujur menggunakan layanan seperti Google Maps atau alat geocoding lainnya. - LONGITUDE: Bujur lokasi. Misalnya, bujur
-122.4194mewakili San Francisco. - ENABLE_WIDGET: Apakah akan menampilkan token dan mengaktifkan widget Google Maps (defaultnya adalah
false).
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": "PROMPT"
}]
}],
"tools": [{
"googleMaps": {
"enableWidget": "ENABLE_WIDGET"
}
}],
"toolConfig": {
"retrievalConfig": {
"latLng": {
"latitude": LATITUDE,
"longitude": LONGITUDE
},
"languageCode": "en_US"
}
},
"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": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout. It has a rating of 4.2 stars based on 411 reviews."
}
]
},
"finishReason": "STOP",
"groundingMetadata": {
"groundingChunks": [
{
"maps": {
"uri": "https://maps.google.com/?cid=9001322937822692826",
"title": "The Italian Place",
"placeId": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w"
}
},
{
"maps": {
"uri": "https://maps.google.com/?cid=9001322937822692826",
"title": "Hank's Pasta Bar",
"placeId": "places/MMVtPzn9FGcevML89",
"placeAnswerSources": {
"reviewSnippets": [
{
"id": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w",
"title": "Google Maps Review",
"uri": "https://maps.google.com/?cid=9001322937822692826"
},
]
}
}
},
...
],
"groundingSupports": [
{
"segment": {
"endIndex": 79,
"text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout."
},
"groundingChunkIndices": [
0
]
},
],
"googleMapsWidgetContextToken": "widgetcontent/..."
}
}
],
...
}
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 dapat digunakan oleh model Anda untuk menghasilkan respons.
- Alamat
- Pengambilan di tepi jalan
- Kartu debit
- Jarak
- Tempat parkir gratis
- Musik live
- Menu untuk anak-anak
- Jam buka
- Opsi pembayaran (seperti tunai atau kartu kredit)
- Jawaban terkait tempat
- Boleh bawa hewan peliharaan
- Menyajikan bir
- Menyajikan makanan vegetarian
- Dapat diakses pengguna kursi roda
- Wi-Fi
Jawaban tempat adalah respons dari Perujukan dengan Google Maps berdasarkan informasi yang berasal dari ulasan pengguna.
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 tersebut cocok untuk keluarga dan apakah restoran tersebut menawarkan layanan yang nyaman.
Memeriksa aksesibilitas untuk teman: Anda dapat bertanya, Saya butuh 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 akan 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 harga mereka, dan apakah mereka menerima kartu kredit?
Jawaban atas pertanyaan ini membantu Anda menilai kesesuaian kafe untuk pertemuan bisnis berdasarkan fasilitas, penawaran, dan opsi pembayaran.
Informasi dalam Hasil Terperinci Google Maps mungkin berbeda dengan kondisi jalan yang sebenarnya.
Memahami respons Anda
Sumber Google Maps ditampilkan di groundingMetadata dalam
groundingChunks. Sumber ditampilkan untuk tempat dan ulasan pengguna,
yang telah digunakan untuk membantu membuat Hasil Berbasis Fakta Google Maps.
Contoh kode ini menunjukkan sumber tempat dan sumber jawaban tempat dalam respons:
"groundingChunks": [
{
"maps": {
"uri": "{Link to Maps Content}",
"title": "{Name of Maps Place}",
"placeId": "{Place ID}",
"placeAnswerSources": {
"reviewSnippets" : [
{
"reviewId": "{Review ID}",
"googleMapsUri": "{Link to Maps Content}",
"title": "{Title of review}"
}
]
}
},
}
],
Pemilihan rute
Grounding dengan Google Maps mendukung kemampuan Perutean. Fitur ini memungkinkan agen AI Anda memahami pergerakan fisik, perkiraan perjalanan real-time, dan hubungan spasial antar-lokasi. Dengan men-grounding respons di mesin perutean Google Maps, model Anda dapat memberikan petunjuk yang dioptimalkan untuk performa dan waktu perjalanan yang akurat yang memperhitungkan kondisi real-time. Integrasi ini memungkinkan Perujukan dengan Google Maps untuk memfilter tempat berdasarkan waktu tempuh, menawarkan petunjuk arah point-to-point yang akurat, dan menghitung perkiraan waktu perjalanan untuk moda transportasi tertentu.
Kemampuan perutean tersedia sebagai Pratinjau Terbatas. Untuk mengakses fitur ini bagi project Anda, hubungi tim akun Anda untuk meminta penambahan ke daftar yang diizinkan. Google Cloud Atau, Anda dapat mengirimkan formulir partisipasi agar dipertimbangkan. Google menerima minat dari sekelompok kecil partner untuk menguji coba alat Perutean dengan Pengaitan Google Maps.
Kemampuan
Alat Perutean menghitung jarak dan durasi perjalanan yang akurat antara tempat asal dan tujuan.
Alat Perutean mendukung hal berikut:
Mode transportasi: Pemilihan rute untuk mengemudi, berjalan kaki, bersepeda, transportasi umum, dan kendaraan bermotor roda dua (tidak semua mode perjalanan tersedia di semua negara)
Beberapa titik jalan: Hingga 13 perhentian perantara antara asal dan tujuan
Lalu lintas real-time: Memperhitungkan kondisi lalu lintas saat ini untuk memberikan waktu perjalanan "live" yang akurat, bukan rata-rata statis
Berikut adalah contoh jenis pertanyaan yang didukung alat Perutean:
Kedekatan berdasarkan waktu perjalanan: "Apa saja restoran Amerika yang berjarak 10 menit berjalan kaki dari Hilton Hotel di 1335 6th Ave di NYC?"
Estimasi perjalanan: "Berapa lama waktu yang diperlukan untuk naik transportasi umum dari Pike Place Market ke Capitol Hill di Seattle?"
Memahami respons
Saat perintah memicu alat Perutean, model akan menghasilkan jawaban bahasa alami yang didukung oleh metadata terstruktur. Hal ini memungkinkan Anda menampilkan informasi perjalanan yang akurat kepada pengguna.
Data berikut ditampilkan dalam respons payload:
Durasi: Waktu yang diperlukan untuk melakukan perjalanan antar-lokasi, dengan memperhitungkan lalu lintas jika diminta. Misalnya, "500 detik".
Jarak: Jarak fisik rute. Misalnya, "1,9 km".
Polyline: String teks yang dienkode yang memungkinkan Anda merender jalur rute tertentu secara visual di peta.
Berikut adalah contoh respons untuk perintah: "Bagaimana cara menuju restoran Carmine dari Hotel Hilton (1335 6th Ave di NYC) tempat saya menginap?"
Untuk menuju restoran Carmine dari Hilton Hotel di 1335 6th Ave di NYC, Anda harus menuju lokasi Carmine - Time Square di 200 W 44th St, New York, NY 10036, USA.
Berikut rute jalan kaki:
Mulai di Hilton Hotel: Keluar dari Hilton Hotel di 1335 6th Ave.
Berjalan ke Selatan di 6th Avenue: Berjalan ke selatan di 6th Avenue (Avenue of the Americas) menuju W 44th Street.
Belok Kanan ke W 44th Street: Belok kanan ke W 44th Street.
Carmine's ada di sebelah kiri Anda: Berjalanlah di W 44th Street, dan Carmine's akan berada di sebelah kiri Anda di 200 W 44th St.
Jalan kaki ini berjarak sekitar 0,8 km dan akan memakan waktu sekitar 10-15 menit.
Berikut adalah contoh respons untuk perintah: "Berapa lama waktu yang dibutuhkan untuk naik transportasi umum dari Pikes Place Market ke Capitol Hill di Seattle?"
Untuk pergi dari Pike Place Market ke Capitol Hill di Seattle menggunakan transportasi umum, Anda memiliki beberapa opsi:
Trem (Kereta Ringan): Trem dari Westlake, yang dekat dengan Pike Place Market, ke Capitol Hill membutuhkan waktu sekitar 3 menit. Termasuk transfer, total waktu perjalanan sekitar 9 menit, dengan keberangkatan trem setiap 10 menit.
Bus: Bus King County Metro langsung dari Pike St & 4th Ave (dekat Pike Place Market) ke Capitol Hill membutuhkan waktu sekitar 11 menit, dengan keberangkatan setiap 20 menit. Sebagai alternatif, bus Line 49 memerlukan waktu sekitar 16 menit.
Telusuri Sepanjang Rute
Penelusuran di Sepanjang Rute memungkinkan agen AI Anda menemukan lokasi menarik yang relevan secara geografis dan nyaman untuk perjalanan yang direncanakan pengguna. Dengan mendasarkan respons pada mesin perutean dan penelusuran spasial Google Maps, model Anda dapat memberikan rekomendasi yang meminimalkan perjalanan memutar dan memahami alur logistik perjalanan darat atau perjalanan ke tempat kerja.
Kemampuan Penelusuran di Sepanjang Rute tersedia sebagai Pratinjau Terbatas. Untuk mengakses fitur ini untuk project Anda, hubungi tim akun Anda untuk meminta penambahan ke daftar yang diizinkan. Google Cloud Atau, Anda juga dapat mengirimkan formulir ini agar dipertimbangkan untuk berpartisipasi. Perhatikan bahwa saat ini kami hanya menerima minat dari sekelompok kecil partner untuk menguji coba alat Perujukan dengan Google Maps Search Along Route.
Kemampuan
Penelusuran di Sepanjang Rute memungkinkan aplikasi Anda mengidentifikasi bisnis, fasilitas, atau tempat menarik tertentu yang terletak langsung di sepanjang jalur yang dibuat antara asal dan tujuan. Hanya mode perjalanan "Drive" yang didukung dalam Pratinjau.
Contoh berikut menggambarkan jenis pertanyaan yang dapat ditangani oleh alat Penelusuran di Sepanjang Rute.
- Penelusuran rute dasar: "Temukan SPBU dalam perjalanan dari 1800 Amphibious Blvd. Mountain View, CA 94045, ke 456 Sunny St, Sunnyvale CA." (Biasanya, alamat asal dan tujuan berasal dari histori chat.)
- Penelusuran berdasarkan Properti Tempat: "Apakah ada toko roti dengan rating minimal 4 bintang di antara San Francisco dan 1800 Amphibious Blvd. Mountain View, CA 94045?"
- Penelusuran rute multi-tujuan: "Saya akan melakukan perjalanan darat dari San Francisco ke San Luis Obispo, lalu ke Los Angeles. Sarankan tiga opsi pengisi daya EV antara San Francisco dan San Luis Obispo, lalu antara San Luis Obispo dan Los Angeles."
Memahami respons
Saat perintah memicu alat Penelusuran di Sepanjang Rute, model akan menghasilkan jawaban dalam bahasa alami yang didukung oleh metadata terstruktur yang menggabungkan data Tempat dan Perutean. Hal ini memastikan lokasi yang disarankan benar-benar nyaman
untuk jalur perjalanan fisik. groundingMetadata akan berisi
groundingChunks untuk tempat yang ditampilkan dan rute yang ditelusuri.
Contoh Perintah [Penelusuran rute dasar]:
Temukan SPBU di sepanjang perjalanan dari 1800 Amphibious Blvd. Mountain View, CA 94045, ke 456 Sunny St, Sunnyvale CA.
Contoh Respons [Penelusuran rute dasar]:
Berikut beberapa SPBU dalam perjalanan dari 1800 Amphibious Blvd. Mountain View, CA 94045 ke 456 Sunny St, Sunnyvale, CA:
- Contoh SPBU - Terletak di 123 Example Rd, Sunnyvale, CA 94045. Tempat ini memiliki rating 3,5 bintang dari 122 ulasan dan menjual hidrogen, propana, dan bensin, serta layanan pencucian mobil. Tempat ini buka hingga pukul 21.50 malam ini dan memiliki toilet.
- SPBU fiktif - Terletak di 456 Fictional Ave, Sunnyvale, CA 94045. Tempat ini memiliki rating 3,6 bintang dari 52 ulasan dan menawarkan toko swalayan dan tempat cuci mobil. SPBU ini buka 24 jam dan memiliki toilet.
- SPBU Umum - Terletak di 789 W Generic St, Sunnyvale, CA 94045. Tempat ini memiliki rating 3,6 bintang dari 35 ulasan. SPBU ini buka 24 jam dan memiliki toilet.
Contoh Perintah [Penelusuran rute multi-tujuan]:
Saya akan melakukan perjalanan darat dari San Francisco ke San Luis Obispo, lalu ke Los Angeles. Sarankan tiga opsi pengisi daya EV antara San Francisco dan San Luis Obispo, lalu antara San Luis Obispo dan Los Angeles.
Contoh Respons [Penelusuran rute multi-tujuan]:
Berikut beberapa opsi pengisi daya EV untuk perjalanan darat Anda dari San Francisco ke Los Angeles, dengan persinggahan di San Luis Obispo.
Antara San Francisco dan San Luis Obispo:
- Pengisi Daya Contoh: Terletak di 123 Example Blvd, Campbell, CA 95008, stasiun ini memiliki rating 4,5.
- Stasiun SPKLU Fiktif: Anda dapat menemukan stasiun ini di 456 Fictional Rd, Gilroy, CA 95008, dengan rating 4,4.
- Stasiun Pengisian Umum: Stasiun ini berada di 789 Generic St, Salinas, CA 95008, dan memiliki rating 3,5.
Antara San Luis Obispo dan Los Angeles:
- Contoh Pengisi Daya: Terletak di 123 Example Rd, San Luis Obispo, CA 93123, stasiun ini memiliki rating 4,3.
- SPKLU Fiktif: SPKLU ini dapat ditemukan di 456 Fictional Ave, Santa Barbara, CA 93123, dengan rating 3,9.
- Stasiun Pengisian Daya Umum: Anda dapat menemukan stasiun ini di 789 Generic St, Glendale, CA 93123, dengan rating 3,0.
Semoga perjalanan darat Anda menyenangkan!
Persyaratan penggunaan layanan
Bagian ini menjelaskan persyaratan penggunaan layanan untuk Perujukan dengan Google Maps.
Memberi tahu pengguna tentang penggunaan sumber Google Maps
Untuk setiap Hasil yang Sesuai dengan Kenyataan di Google Maps, Anda akan menerima sumber di
groundingChunks yang mendukung setiap respons. Metadata berikut juga ditampilkan:
- URI sumber
- title
- ID
Saat menyajikan hasil dari Perujukan dengan Google Maps menggunakan Vertex AI, Anda harus menentukan sumber Google Maps terkait, dan memberi tahu pengguna Anda tentang hal berikut:
- Sumber Google Maps harus segera mengikuti konten yang dihasilkan yang didukung oleh sumber tersebut. Konten yang dihasilkan ini juga disebut sebagai Hasil yang Sesuai dengan Lokasi di Google Maps.
- Sumber Google Maps harus dapat dilihat dalam satu interaksi pengguna.
Untuk antarmuka yang mengutamakan suara
Sumber: Sumber Google Maps harus ditampilkan di UI pendamping yang menampilkan catatan historis kata demi kata dari percakapan suara AI. Catatan ini harus mematuhi persyaratan sumber dan tunduk pada batas penyimpanan dan penampungan data yang berlaku.
Pengungkapan sumber secara aktif: Pengguna akhir harus diberi tahu secara wajar tentang peran Google Maps dalam pengalaman mereka dan cara menemukan sumber mendetail pada saat interaksi.
Pengungkapan aktif sumber harus menyampaikan poin-poin berikut:
Konten buatan AI dapat menyertakan informasi dari Google Maps.
Sumber mendetail tersedia di UI pendamping.
Anda harus menyampaikan pengungkapan aktif sumber menggunakan setidaknya satu metode berikut.
Tampilan visual: Untuk interaksi suara yang terjadi di perangkat dengan layar, tampilkan pengungkapan aktif di layar setiap kali Penjajaran dengan Google Maps digunakan.
Pengumuman suara: Membacakan pengungkapan aktif kepada pengguna. Hal ini harus terjadi selama interaksi pertama yang didukung oleh Perujukan dengan Google Maps dan berulang setidaknya setiap 6 bulan.
Contoh pengungkapan: "Konten buatan AI dapat mencakup informasi dari Google Maps. Anda dapat menemukan sumber mendetail di aplikasi pendamping."
Pengungkapan persisten: Penjelasan bahwa konten Google Maps dapat digunakan dalam konten buatan AI harus dapat diakses secara persisten oleh pengguna akhir (misalnya, di menu setelan suara atau pengungkapan interaksi suara).
Pertanyaan pengguna: Asisten suara Anda harus menjawab pertanyaan pengguna akhir secara akurat mengenai sumber konten, termasuk saat konten buatan AI menyertakan informasi dari Google Maps. Jika Google Maps adalah sumbernya, arahkan pengguna akhir langsung ke UI pendamping untuk mengakses informasi sumber tertentu.
Menampilkan sumber Google Maps dengan link Google Maps
Untuk setiap sumber di groundingChunks dan di
grounding_chunks.maps.placeAnswerSources.reviewSnippets, pratinjau link harus
dibuat dengan mengikuti persyaratan berikut:
- Berikan atribusi setiap sumber ke Google Maps dengan mengikuti panduan atribusi teks Google Maps.
- Menampilkan judul sumber yang diberikan dalam respons.
- Tautkan ke sumber menggunakan
uriataugoogleMapsUridari respons.
Gambar ini menunjukkan persyaratan minimum untuk menampilkan sumber dan link Google Maps.
Anda dapat menciutkan tampilan sumber.
Opsional: Tingkatkan kualitas pratinjau link dengan konten tambahan, seperti:
- Favicon Google Maps disisipkan sebelum atribusi teks Google Maps.
- Foto dari URL sumber (
og:image).
Untuk mengetahui informasi selengkapnya tentang beberapa penyedia data Google Maps kami dan persyaratan lisensi mereka, lihat pemberitahuan hukum Google Maps dan Google Earth.
Panduan atribusi teks Google Maps
Saat Anda mengatribusikan sumber ke Google Maps dalam teks, ikuti panduan berikut:
- Jangan ubah teks Google Maps dengan cara apa pun:
- Jangan mengubah kapitalisasi Google Maps.
- Jangan pindahkan Google Maps ke beberapa baris.
- Jangan melokalkan Google Maps ke bahasa lain.
- Mencegah browser menerjemahkan Google Maps dengan menggunakan atribut HTML
translate="no".
- Gaya teks Google Maps seperti yang dijelaskan dalam tabel berikut:
| Properti | Gaya |
|---|---|
| Jenis font | Roboto. Memuat font bersifat opsional. |
| Jenis font pengganti | Font isi sans serif yang sudah digunakan dalam produk Anda atau "Sans-Serif" untuk memanggil font sistem default |
| Gaya font | Normal |
| Ketebalan font | 400 |
| Warna font | Putih, hitam (#1F1F1F), atau abu-abu (#5E5E5E). Pertahankan kontras yang dapat diakses (4,5:1) dengan latar belakang. |
| Ukuran font | Ukuran font minimum: 12 sp Ukuran font maksimum: 16 sp Untuk mempelajari sp, lihat Satuan ukuran font di situs Desain Material. |
| Penentuan spasi huruf | Normal |
Contoh CSS
CSS berikut merender Google Maps dengan gaya dan warna tipografi yang sesuai di latar belakang putih atau terang.
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}
Token konteks, ID tempat, dan ID ulasan
Data Google Maps mencakup token konteks, ID tempat, dan ID ulasan. Anda dapat menyimpan dalam cache, menyimpan, dan mengekspor data respons berikut:
googleMapsWidgetContextTokenplaceIdreviewId
Pembatasan terhadap penyimpanan cache dalam Persyaratan Grounding dengan Google Maps tidak berlaku.
Wilayah Terlarang
Penggunaan Google Maps sebagai dasar memiliki batasan untuk konten dan aktivitas tertentu guna mempertahankan platform yang aman dan andal. Pelanggan tidak akan mendistribusikan atau memasarkan Aplikasi Pelanggan yang menawarkan Perujukan dengan Google Maps di Wilayah Terlarang. Untuk mengetahui informasi selengkapnya, lihat artikel Wilayah Terlarang Google Maps Platform. Daftar Wilayah Terlarang dapat diperbarui dari waktu ke waktu.
Opsional: Widget kontekstual Google Maps
Widget kontekstual adalah Penawaran Pra-GA Google Maps yang merupakan penampung visual yang digunakan untuk mendukung atau melengkapi konten Google Maps lainnya. Widget kontekstual Google Maps memungkinkan Anda mengintegrasikan Perujukan dengan Google Maps ke dalam aplikasi untuk menciptakan pengalaman percakapan berbasis chat yang didukung LLM.
Widget kontekstual dirender menggunakan token konteks,
googleMapsWidgetContextToken, yang ditampilkan dalam respons Vertex AI API dan dapat digunakan untuk merender konten visual.
Widget kontekstual memiliki fungsi yang berbeda-beda, bergantung pada skenario Anda:
Fitur ini menampilkan ulasan dan foto pengguna, yang merupakan konten buatan pengguna (UGC), dalam skenario saat perintah Google Maps digunakan untuk pembuatan jawaban.
Fitur ini membantu memperkaya hasil dengan visualisasi dan data peta saat Vertex AI hanya menghasilkan respons teks.
Untuk mengetahui informasi selengkapnya tentang widget kontekstual, lihat widget perujukan Maps.
Merender widget kontekstual Google Maps
Untuk merender dan menggunakan widget kontekstual Google Maps, gunakan Google Maps JavaScript API versi alfa di halaman yang menampilkan widget. Untuk mengetahui informasi selengkapnya, lihat artikel Memuat Maps JavaScript API.
Contoh kode berikut menunjukkan cara menggunakan widget kontekstual:
Buat widget kontekstual.
<body> <gmp-place-contextual id="widget"></gmp-place-contextual> </body>Dalam setiap respons yang didasarkan pada Google Maps, ada
googleMapsWidgetContextTokenyang sesuai yang digunakan untuk merender widget kontekstual dan ditempatkan di dekat respons yang dihasilkan.Untuk memperbarui token konteks, tetapkan
widget.contextToken property."googleMapsWidgetContextToken": "widgetcontent/AcBXPQdpWQWbap9H-OH8sEKmOXxmEKAYvff0tvthhneMQC3VrqWCjpnPBl4-Id98FGiA_S_t8aeAeJj0T6JkWFX56Bil8oBSR0W8JH3C_RSYLbTjxKdpxc9yNn6JcZTtolIRZon9xi6WpNGuSyjcIxWu2S0hwpasNOpUlWrG1RxVCB4WD1fsz_pwR236mG36lMxevXTQ_JnfdYNuQwQ4Lc3vn...<snip>... Ts5VJE_b3IC5eE_6wez0nh61r7foTUZpP7BXMwxR-7Wyfcj6x1v6mIWsFGr1o0p_HSAMNqWPg-aFVnkPLhAkOR6MaNZOfezTva-gxHlu7z_haFvYxcUE1qfNVQ",function updateWidget(contextToken) { let widget = document.querySelector('#widget'); widget.contextToken = contextToken; }Opsional: Tentukan tata letak daftar. Nilai yang valid mencakup berikut ini:
- Tata letak ringkas:
<gmp-place-contextual-list-config layout="compact"> - Tata letak vertikal:
<gmp-place-contextual-list-config layout="vertical">
Contoh kode ini menunjukkan cara mengubah tata letak daftar menjadi tata letak rapat.
<gmp-place-contextual id="widget"> <gmp-place-contextual-list-config layout="compact"> </gmp-place-contextual-list-config> </gmp-place-contextual>- Tata letak ringkas:
Opsional: Ubah mode peta. Nilai yang valid mencakup berikut ini:
- Peta jalan 2D:
map-mode="roadmap" - Peta hybrid 3D:
map-mode="hybrid" - Tidak ada peta:
map-mode="none"
Contoh kode ini menunjukkan cara mengubah mode peta menjadi peta 2D.
<gmp-place-contextual id="widget"> <gmp-place-contextual-list-config map-mode="roadmap"> </gmp-place-contextual-list-config> </gmp-place-contextual>- Peta jalan 2D:
Langkah berikutnya
- Untuk mempelajari lebih lanjut cara menyandarkan model Gemini ke data Anda, lihat Penyandaran dengan data Anda.
- Untuk mempelajari lebih lanjut praktik terbaik AI yang bertanggung jawab dan filter keamanan Vertex AI, lihat Responsible AI.