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, 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 with 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 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 Perujukan dengan Google Maps.

Klik untuk meluaskan model yang didukung

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

Menggunakan Grounding dengan Google Maps untuk melakukan grounding respons model Anda

Contoh kode ini menunjukkan cara menggunakan Grounding dengan Google Maps untuk mendasari respons model Anda.

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

Konsol

Untuk menggunakan Grounding dengan Google Maps menggunakan 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 Setelan model, buka bagian Perujukan, 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: [ID project](/resource-manager/docs/creating-managing-projects#identifiers) Anda. .
  • MODEL_ID: ID model multimodal.
  • PROMPT: Perintah yang akan dikirim ke model.
  • LATITUDE: Garis lintang lokasi. Misalnya, garis lintang 37.7749 mewakili San Francisco. Anda dapat memperoleh koordinat lintang dan bujur menggunakan layanan seperti Google Maps atau alat geocoding lainnya.
  • LONGITUDE: Bujur lokasi. Misalnya, bujur -122.4194 mewakili San Francisco.
  • GROUNDING_TYPES: Jenis perujukan 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: Temukan petunjuk arah dan lakukan penelusuran 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 Perujukan dengan 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 yang diurutkan berdasarkan abjad tentang tempat yang dapat digunakan oleh model Anda untuk menghasilkan respons.

  • Alamat
  • Ambil di luar toko
  • 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 cocok untuk keluarga dan apakah restoran 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 yang Di-grounding 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 digunakan untuk membantu menghasilkan Hasil yang Di-grounding 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 - Menemukan Rute

Grounding dengan Google Maps mendukung kemampuan Temukan 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 untuk performa dan waktu perjalanan yang akurat yang memperhitungkan kondisi real-time. Integrasi ini memungkinkan Perujukan dengan Google Maps memfilter tempat berdasarkan waktu perjalanan, menawarkan petunjuk arah yang presisi dari titik ke titik, dan menghitung perkiraan waktu perjalanan untuk moda transportasi tertentu.

Kemampuan

Temukan Rute menghitung jarak dan durasi perjalanan yang tepat antara tempat asal dan tujuan.

Temukan Rute 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 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?"

Memahami respons

Saat perintah memicu kemampuan Temukan Rute, model akan menghasilkan jawaban dalam 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's dari Hotel Hilton (1335 6th Ave di NYC) tempat saya menginap?"

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

Berikut rute jalan kaki:

  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.

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.

Pemilihan rute - Menelusuri 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 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 "Mobil" yang didukung.

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 Jakarta dan Jalan Magelang B6, Sleman, Yogyakarta 55111?"
  • 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 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 toko swalayan dan pencucian 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:

  • Contoh Pengisi Daya: Terletak di 123 Example Blvd, Campbell, CA 95008, SPKLU 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 Daya 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.

Selamat melakukan perjalanan darat yang menyenangkan!

Persyaratan penggunaan layanan

Bagian ini menjelaskan persyaratan penggunaan layanan untuk Perujukan dengan 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. Catatan ini harus mematuhi persyaratan pengambilan sumber dan tunduk pada batas penyimpanan dan penampungan data yang berlaku.

Pengungkapan aktif sumber: 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 Pengaitan 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.

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 uri atau googleMapsUri 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 diciutkan

Opsional: Tingkatkan kualitas pratinjau link dengan konten tambahan, seperti:

  • Ikon 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 teks 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;
}

ID tempat dan ID ulasan

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

  • placeId
  • reviewId

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

Wilayah Terlarang

Penggunaan Google Maps untuk memandu orang lain 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 mengetahui informasi selengkapnya, lihat artikel Wilayah Terlarang 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 Place Search (kueri Google Maps), dengan asumsi perintah ini menghasilkan 3 kueri fanout. 3 kueri Penelusuran dengan pola 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 Temukan 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 Place Search + 3 kueri Temukan Rute), dengan asumsi Place Search menampilkan 3 bandara. 1 kueri Place Search fanout:
- Bandara di dekat New York City

3 kueri Temukan Rute:
- 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 mendasarkan model Gemini pada data Anda, lihat Pendasaran dengan data Anda.
  • Untuk mempelajari lebih lanjut praktik terbaik AI yang bertanggung jawab dan filter keamanan Gemini Enterprise Agent Platform, lihat AI yang Bertanggung Jawab.