Grounding dengan Google Maps di Gemini Enterprise Agent Platform

Halaman ini menjelaskan cara Grounding dengan Google Maps dan Gemini Enterprise Agent Platform dapat membantu meningkatkan kualitas aplikasi AI generatif Anda dengan memberikan konteks geospasial.

Ringkasan

Grounding with Google Maps dengan Gemini Enterprise Agent Platform adalah layanan yang menghubungkan model Gemini dengan data geospasial dari Google Maps. Google Maps memiliki akses ke informasi tentang jutaan lokasi, termasuk bisnis, tempat terkenal, dan lokasi 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 Grounding with Google Maps, Google Penelusuran, dan perujukan serentak dengan sumber data Anda.

Penggunaan Grounding with Google Maps

Anda dapat menggunakan Grounding with Google Maps untuk berbagai aplikasi, seperti:

  • Asisten percakapan yang dapat menjawab pertanyaan tentang tempat-tempat terdekat, seperti "Di mana tempat terdekat untuk mendapatkan espresso Italia?"
  • Deskripsi yang dipersonalisasi dan insight komunitas, seperti "Bisakah Anda memberi tahu saya lebih banyak tentang restoran yang cocok untuk keluarga yang dapat dijangkau dengan berjalan kaki?"
  • Ringkasan area di sekitar lokasi tertentu, seperti Stasiun Pengisian Kendaraan Listrik Umum atau hotel.

Hal ini dapat bermanfaat untuk kasus penggunaan di aplikasi real estat, perjalanan, mobilitas, dan media sosial.

Model yang didukung

Bagian ini mencantumkan model yang mendukung Grounding with Google Maps.

Klik untuk meluaskan model yang didukung

Untuk mengetahui informasi selengkapnya tentang model Gemini, lihat Model Gemini.

Menggunakan Grounding with Google Maps untuk melakukan grounding pada respons model Anda

Contoh kode ini menunjukkan cara menggunakan Grounding with Google Maps untuk melakukan grounding respons model Anda.

Hasil penelusuran dapat disesuaikan untuk lokasi geografis tertentu menggunakan koordinat lintang dan bujur.

Konsol

Untuk menggunakan Grounding with Google Maps dengan Gemini Enterprise Agent Platform, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Agent Studio.

    Buka Agent Studio

  2. Di panel samping, di bagian Model settings, buka bagian Grounding, lalu klik ikon edit untuk Google Penelusuran, Google Maps. Panel konfigurasi akan muncul.

  3. Aktifkan tombol Google Maps.

  4. Klik Terapkan.

  5. 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 Google 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_ENTERPRISE=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())
        ],
        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, lintang 37.7749 mewakili San Francisco. Anda dapat memperoleh koordinat lintang dan bujur menggunakan layanan seperti Google Maps atau alat geocoding lainnya.
  • LONGITUDE: Garis bujur lokasi. Misalnya, garis bujur -122.4194 merepresentasikan San Francisco.
  • GROUNDING_TYPES: Jenis grounding Google Maps yang akan diaktifkan. Saat ini mendukung places dan routing.
    • places: Menelusuri informasi tempat, termasuk tempat usaha, lokasi menarik terkenal, dan lokasi geografis.
    • routing: Menemukan rute dan menelusuri di sepanjang rute.
    Jika tidak ditentukan, nilai defaultnya hanya places.

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": {
      "groundingTypes": {
        "places": {},
        "routing": {}
      }
    }
  }],
  "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
            ]
          },
        ],
      }
    }
  ],
  ...
}

Properti tempat

Bagian ini mencantumkan properti tempat yang digunakan untuk mendeskripsikan lokasi dan digunakan oleh Grounding with Google Maps untuk menghasilkan respons. Properti ini digunakan untuk menentukan jenis pertanyaan yang dapat dijawab oleh Grounding with Google Maps.

Contoh properti tempat

Daftar ini memberikan contoh properti tentang tempat yang diurutkan menurut abjad yang dapat digunakan oleh model Anda untuk menghasilkan respons:

  • Alamat
  • Tren tingkat kesibukan
  • Ambil di luar toko
  • Kartu debit
  • Jarak
  • Info Stasiun Pengisian Kendaraan Listrik Umum (jenis konektor, kecepatan pengisian daya, dan ketersediaan)
  • Tempat parkir gratis
  • Harga BBM dan jenis BBM yang tersedia
  • Cocok untuk anak-anak
  • Musik live
  • Saran menu
  • Jam buka
  • Opsi pembayaran (seperti tunai atau kartu kredit)
  • Boleh bawa hewan peliharaan
  • Meninjau insight
  • 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. Grounding with 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 ratingnya?

    Jawaban atas pertanyaan-pertanyaan ini akan membantu Anda menentukan apakah restoran cocok untuk keluarga dan apakah restoran menawarkan layanan yang nyaman.

  • Jelajahi hidangan unggulan dan hidangan khas: Anda dapat bertanya, Apa hidangan pasta yang paling direkomendasikan dalam menu di "The Italian Place"? Apakah mereka menyediakan hidangan utama vegetarian, dan apa kata pengulas tentang saus marinara mereka?

    Jawaban atas pertanyaan ini menggunakan Sorotan menu, dan Insight ulasan untuk membantu Anda menjelajahi penawaran kuliner tertentu dan favorit komunitas.

  • Memeriksa aksesibilitas untuk teman: Anda dapat bertanya, Saya butuh restoran yang memiliki pintu masuk khusus pengguna kursi roda.

    Respons terhadap perintah ini dapat membantu Anda menentukan apakah lokasi tersebut memenuhi kebutuhan aksesibilitas tertentu.

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

  • Merencanakan pengisian daya EV dan fasilitas hotel untuk perjalanan darat: Anda mungkin bertanya, Saya menginap di "Overnight Motel". Apakah mereka memiliki Stasiun Pengisian Kendaraan Listrik Umum (SPKLU) di lokasi, jenis konektor apa yang didukung, dan seberapa padat area parkir mereka pada Jumat malam?

    Jawaban atas pertanyaan ini menggabungkan info Stasiun Pengisian Kendaraan Listrik Umum dan Tren tingkat kesibukan untuk membantu Anda merencanakan pengisian daya kendaraan dan mengevaluasi tingkat keramaian selama Anda menginap.

  • Membandingkan harga bensin dan bahan bakar khusus di sekitar: Anda dapat bertanya, SPBU mana di dekat Mountain View, CA yang menjual solar atau hidrogen, dan bagaimana perbandingan harga saat ini?

    Jawaban atas pertanyaan ini memanfaatkan Harga bensin dan jenis bahan bakar yang tersedia untuk membantu Anda menemukan bahan bakar khusus dan tempat pengisian bahan bakar yang hemat biaya.

  • Sintesis suasana kerja dari ulasan: Anda dapat bertanya, Apa yang dikatakan ringkasan ulasan pelanggan tentang tingkat kebisingan, kenyamanan tempat duduk, dan keandalan Wi-Fi di "Breakfast Cafe" untuk bekerja jarak jauh?

    Respons terhadap perintah ini memanfaatkan Insight ulasan untuk menilai kesesuaian sebuah kafe untuk bekerja atau belajar berdasarkan konsensus komunitas.

Informasi dalam Hasil yang Di-grounding Google Maps mungkin berbeda dengan kondisi sebenarnya jalan atau tempat.

Memahami respons Anda

Sumber Google Maps ditampilkan di groundingMetadata dalam groundingChunks. Sumber ditampilkan untuk tempat, yang digunakan untuk membantu menghasilkan Hasil yang Di-grounding Google Maps. Kolom uri dapat ditautkan ke ulasan pendukung atau langsung ke kartu tempat di Google Maps.

Contoh kode ini menunjukkan sumber tempat dalam respons:

"groundingChunks": [
  {
    "maps": {
      "uri": "{Link to place sheet or review on Maps}",
      "title": "{Name of Maps Place}",
      "placeId": "{Place ID}"
    }
  }
],

Pemilihan Rute - Menemukan Rute

Grounding with Google Maps mendukung kapabilitas Cari Rute. Fitur ini memungkinkan agen AI Anda memahami pergerakan fisik, perkiraan perjalanan real-time, dan hubungan spasial antar-lokasi. Dengan kemampuan Temukan Rute, model Anda dapat memberikan rute yang dioptimalkan performanya dan waktu perjalanan yang akurat yang memperhitungkan kondisi real-time. Integrasi ini memungkinkan Grounding with Google Maps memfilter tempat berdasarkan waktu perjalanan, menawarkan rute point-to-point yang akurat, dan menghitung perkiraan waktu perjalanan untuk moda transportasi tertentu.

Kemampuan

Find Directions menghitung jarak dan durasi perjalanan yang tepat antara tempat asal dan tujuan.

Temukan Rute mendukung hal berikut:

  • Moda transportasi: Pemilihan rute untuk mengemudi, berjalan kaki, bersepeda, transportasi umum, dan kendaraan bermotor roda dua (tidak semua moda 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 oleh fitur Temukan Rute:

  • 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?"

Mengaktifkan Temukan Rute

Di REST API dan SDK, Grounding with Google Maps secara default menggunakan data Places hanya jika grounding_types tidak disertakan. Untuk mengaktifkan kemampuan petunjuk arah, Anda harus mengonfigurasi routing secara eksplisit di grounding_types dalam konfigurasi permintaan Anda. Jika ingin menggunakan alat Places dan Routing, Anda harus menentukan places dan routing di grounding_types.

Memahami respons

Saat perintah memicu kemampuan Cari Rute, 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 seconds".

  • 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: "How do I get to Carmine's restaurant from the Hilton Hotel (1335 6th Ave in NYC) where I'm staying?" (Bagaimana cara menuju restoran Carmine dari Hotel Hilton (1335 6th Ave di NYC) tempat saya menginap?)

Untuk pergi ke restoran Carmine's dari Hilton Hotel di 1335 6th Ave di NYC, Anda harus menuju ke lokasi Carmine's - Time Square di 200 W 44th St, New York, NY 10036, USA.

Berikut rute jalan kakinya:

  1. Mulai di Hilton Hotel: Keluar dari Hilton Hotel di 1335 6th Ave.

  2. Berjalan ke Selatan di 6th Avenue: Berjalan ke selatan di 6th Avenue (Avenue of the Americas) menuju W 44th Street.

  3. Belok Kanan ke W 44th Street: Belok kanan ke W 44th Street.

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

Jarak jalan kaki ini sekitar 0,5 mil dan memerlukan waktu sekitar 10-15 menit.

Berikut adalah contoh respons untuk perintah: "Berapa lama waktu yang dibutuhkan untuk menggunakan 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 (LRT): Trem dari Westlake, yang berada di dekat Pike Place Market, ke Capitol Hill membutuhkan waktu sekitar 3 menit. Termasuk transfer, total waktu perjalanan sekitar 9 menit, dengan trem berangkat 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. Atau, bus Jalur 49 memerlukan waktu sekitar 16 menit.

Pemilihan rute - Menelusuri Sepanjang Rute

Penelusuran di Sepanjang Rute memungkinkan agen AI Anda menemukan tempat menarik yang relevan secara geografis dan nyaman untuk perjalanan yang direncanakan pengguna. Dengan berlandaskan respons pada mesin rute dan mesin telusur spasial Google Maps, model Anda dapat memberikan rekomendasi yang meminimalkan rute memutar dan memahami alur logistik perjalanan darat atau perjalanan harian.

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 "Mengemudi" yang didukung.

Contoh berikut mengilustrasikan jenis pertanyaan yang dapat ditangani oleh alat Telusuri di Sepanjang Rute.

  • Penelusuran rute dasar: "Temukan SPBU di sepanjang rute 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 bintang minimal 4 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."

Mengaktifkan Penelusuran di Sepanjang Rute

Penelusuran Sepanjang Rute memerlukan kemampuan Places dan Pemilihan Rute untuk menemukan tempat yang terletak di sepanjang rute perjalanan. Di REST API dan SDK, Anda harus mengonfigurasi places dan routing secara eksplisit di grounding_types dalam konfigurasi permintaan Anda.

Memahami respons

Saat perintah memicu alat Search Along Route, model akan menghasilkan jawaban natural language yang didukung oleh metadata terstruktur yang menggabungkan data Tempat dan Perutean. Hal ini memastikan lokasi yang disarankan benar-benar sesuai dengan rute 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 rute dari 1800 Amphibious Blvd. Mountain View, CA 94045 ke 456 Sunny St, Sunnyvale, CA:

  • Example Gas station - Terletak di 123 Example Rd, Sunnyvale, CA 94045. SPBU ini memiliki rating 3,5 bintang dari 122 ulasan dan menjual hidrogen, propana, dan bensin, serta menyediakan layanan cuci mobil. Tempat ini buka hingga pukul 21.50 malam ini dan memiliki toilet.
  • SPBU fiktif - Terletak di 456 Fictional Ave, Sunnyvale, CA 94045. SPBU ini memiliki rating 3,6 bintang dari 52 ulasan dan menawarkan minimarket serta pencucian mobil. SPBU ini buka 24 jam dan memiliki toilet.
  • SPBU Umum - Terletak di 789 W Generic St, Sunnyvale, CA 94045. Ratingnya 3,6 bintang dari 35 ulasan. Stasiun 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-perjalanan]:

Berikut beberapa opsi pengisi daya kendaraan listrik untuk perjalanan darat Anda dari San Francisco ke Los Angeles, dengan pemberhentian di San Luis Obispo.

Antara San Francisco dan San Luis Obispo:

  • Contoh Pengisi Daya: 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:

  • Pengisi Daya Contoh: Terletak di 123 Example Rd, San Luis Obispo, CA 93123, SPKLU ini memiliki rating 4,3.
  • Fictional EV Station: Stasiun 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 Anda menyenangkan.

Persyaratan penggunaan layanan

Bagian ini menjelaskan persyaratan penggunaan layanan untuk Grounding with Google Maps.

Memberi tahu pengguna tentang penggunaan sumber Google Maps

Dengan setiap Hasil yang Di-grounding Google Maps, Anda akan menerima sumber di groundingChunks yang mendukung setiap respons. Metadata berikut juga ditampilkan:

  • URI sumber
  • title
  • ID

Saat menyajikan hasil dari Grounding with Google Maps dengan Gemini Enterprise Agent Platform, 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 Di-grounding 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. Data ini harus mematuhi persyaratan sumber dan tunduk pada batas penyimpanan dan caching data yang berlaku.

Pengungkapan sumber secara aktif: Pengguna akhir harus mengetahui secara wajar peran Google Maps dalam pengalaman mereka dan cara menemukan sumber terperinci pada saat interaksi.

Pengungkapan sumber secara aktif 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 Grounding with Google Maps digunakan.

  • Pengumuman suara: Membaca pengungkapan aktif kepada pengguna. Hal ini harus terjadi selama Interaksi Pertama yang didukung oleh Grounding with Google Maps dan berulang setidaknya setiap 6 bulan.

Contoh pengungkapan: "Konten buatan AI dapat menyertakan 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 ke UI pendamping untuk mengakses informasi sumber tertentu.

Untuk setiap sumber di groundingChunks, pratinjau link harus dibuat sesuai dengan persyaratan berikut:

  • Berikan atribusi setiap sumber ke Google Maps dengan mengikuti pedoman atribusi teks Google Maps.
  • Menampilkan judul sumber yang diberikan dalam respons.
  • Tautkan ke sumber menggunakan uri dari respons.

Gambar ini menunjukkan persyaratan minimum untuk menampilkan sumber dan link Google Maps.

Perintah dengan respons yang menampilkan sumber

Anda dapat menciutkan tampilan sumber.

Perintah dengan respons dan sumber yang diciutkan

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 ubah kapitalisasi Google Maps.
    • Jangan gabungkan Google Maps ke dalam beberapa baris.
    • Jangan lokalkan Google Maps ke bahasa lain.
    • Cegah 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. Pemuatan 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 mudah 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;
}

ID tempat dan ID ulasan

Data Google Maps mencakup ID tempat dan ID ulasan. Anda dapat meng-cache, menyimpan, dan mengekspor data respons berikut:

  • placeId
  • reviewId

Pembatasan terhadap penyimpanan cache dalam Persyaratan Grounding with Google Maps tidak berlaku.

Wilayah Terlarang

Grounding with Google Maps memiliki batasan untuk konten dan aktivitas tertentu guna mempertahankan platform yang aman dan andal. Pelanggan tidak akan mendistribusikan atau memasarkan Aplikasi Pelanggan yang menawarkan Grounding with Google Maps di Wilayah Terlarang. Untuk informasi selengkapnya, lihat Wilayah yang Dilarang Google Maps Platform. Daftar Wilayah Terlarang dapat diperbarui dari waktu ke waktu.

Penagihan

Grounding with Google Maps mengenakan biaya untuk setiap kueri Google Maps (lihat Harga).

Permintaan yang dikirimkan pelanggan ke Gemini dapat menghasilkan satu atau beberapa kueri ke Google Maps. Tabel berikut menunjukkan beberapa contoh:

Contoh perintah Potensi jumlah kueri Google Maps Contoh pembuatan kueri
Restoran sushi di dekat Hilton Hotel (1335 6th Ave di NYC). 3 kueri penelusuran Place Search (kueri Google Maps), dengan asumsi perintah ini menghasilkan 3 kueri fanout. 3 kueri Place Search fanout:
- Sushi terbaik di dekat Hilton Midtown Manhattan
- Restoran sushi di dekat 1335 6th Ave New York
- Restoran Jepang di dekat 1335 6th Ave New York
Bagaimana cara menuju 200 W 44th St, New York dari Hilton Hotel, 1335 6th Ave. 1 Kueri Cari Rute (kueri Google Maps) 1 Kueri Temukan Rute:
- Rute dari Hilton Hotel, 1335 6th Ave, New York, NY ke 200 W 44th St, New York, NY 10036
Jarak dari Hilton Hotel (1335 6th Ave di NYC) ke bandara. 4 kueri Google Maps (1 kueri Penelusuran Tempat + 3 kueri Temukan Rute), dengan asumsi penelusuran tempat menampilkan 3 bandara. 1 fanout kueri penelusuran Place Search:
- Bandara di dekat New York City

3 kueri penelusuran Find Directions:
- Rute dari 1335 6th Ave, New York, NY 10019, USA ke John F. Kennedy International Airport, Queens, NY 11430, USA
- Rute dari 1335 6th Ave, New York, NY 10019, USA ke Newark Liberty International Airport, Newark, NJ 07114, USA
- Rute dari 1335 6th Ave, New York, NY 10019, USA ke LaGuardia
Temukan SPBU di sepanjang perjalanan dari 1800 Amphibious Blvd. Mountain View, CA 94045, ke 456 Sunny St, Sunnyvale CA. 1 Kueri Penelusuran di Sepanjang Rute (kueri Google Maps) 1 Kueri Penelusuran di Sepanjang Rute:
- SPBU dari 1800 Amphibious Blvd. Mountain View, CA 94045, ke 456 Sunny St, Sunnyvale CA

Langkah berikutnya

  • Untuk mempelajari lebih lanjut cara menyematkan model Gemini ke data Anda, lihat Penyematan dengan data Anda.
  • Untuk mempelajari lebih lanjut praktik terbaik responsible AI dan filter keamanan Gemini Enterprise Agent Platform, lihat Responsible AI.