Panduan atribusi teks alat agen Maps Experience

Halaman ini memberikan persyaratan dan panduan atribusi untuk menampilkan konten alat agentic Maps Experience di aplikasi Anda. Persyaratan ini berlaku untuk semua hasil, termasuk ringkasan dengan insight dari ulasan, hasil rute dan pengalihan, serta data cuaca, kualitas udara, dan serbuk sari.

Memberi tahu pengguna tentang penggunaan sumber Google Maps

Dengan setiap hasil alat agen Maps Experience, Anda akan menerima pesan Attribution yang mendukung respons:

• search_places: places[].attribution
• search_along_route: results[].place.attribution
• compute_routes: routes[].attribution
• lookup_weather: weather.attribution, airQuality.attribution, dan pollen.attribution (atau attribution tingkat teratas untuk permintaan cuaca lama)

Setiap pesan Attribution menampilkan metadata berikut:

• title: Judul spesifik yang akan ditampilkan untuk sumber.
• url: URL yang digunakan untuk mengalihkan pengguna ke Google Maps atau Google Penelusuran untuk melihat materi referensi, jika ada.

Saat menampilkan hasil dari alat agentic Maps Experience, Anda harus menentukan sumber Google Maps terkait dan memenuhi persyaratan berikut:

• Sumber Google Maps harus segera mengikuti konten yang dihasilkan yang didukung oleh sumber tersebut. Konten yang dihasilkan ini juga disebut sebagai hasil alat agentic Maps Experience.
• 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 rekaman historis verbatim dari percakapan suara AI. Data ini harus mengikuti persyaratan sumber dan tunduk pada batas penyimpanan dan caching 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 yang mendetail pada saat interaksi.

Pengungkapan sumber secara aktif harus menyampaikan poin-poin berikut:

• Konten buatan AI mungkin menyertakan informasi dari Google Maps.
• Sumber mendetail tersedia di UI pendamping.

Anda harus menyampaikan pengungkapan sumber secara aktif menggunakan setidaknya satu dari metode berikut:

• Tampilan visual: Untuk interaksi suara yang terjadi di perangkat dengan layar, tampilkan pengungkapan aktif di layar setiap kali alat agen Maps Experience digunakan.
• Pengumuman suara: Membaca pengungkapan aktif kepada pengguna. Pengumuman ini harus dilakukan selama interaksi pertama yang didukung oleh alat agen Maps Experience dan diulang setidaknya setiap enam bulan.

Contoh pengungkapan: "Konten buatan AI mungkin menyertakan informasi dari Google Maps. Anda dapat menemukan sumber mendetail di aplikasi pendamping."

Pengungkapan persisten: Penjelasan bahwa konten Google Maps mungkin digunakan dalam konten buatan AI harus dapat diakses secara persisten oleh pengguna akhir, seperti dalam menu setelan suara atau pengungkapan interaksi suara.

Pertanyaan pengguna: Asisten suara Anda harus menjawab pertanyaan pengguna akhir dengan akurat terkait 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.

Menampilkan sumber Google Maps dengan link Google Maps

Untuk setiap sumber yang diberikan dalam pesan Attribution, buat pratinjau link yang memenuhi persyaratan berikut:

1. Persyaratan umum:

   • Atribusikan setiap sumber ke Google Maps dengan mengikuti panduan atribusi teks Google Maps.
   • Tampilkan judul sumber seperti yang diberikan dalam respons.
   • Tautkan ke sumber menggunakan url yang diberikan dalam respons.

   

2. Peningkatan visual opsional:

   • Sisipkan favicon Google Maps sebelum atribusi teks Google Maps.
   • Sertakan foto dari URL sumber (og:image).

Panduan atribusi teks Google Maps

Saat Anda mengatribusikan sumber ke Google Maps atau Google dalam teks, ikuti panduan berikut:

• Jangan mengubah teks Google Maps atau Google dengan cara apa pun: Jangan mengubah huruf kapital.
• Jangan gabungkan Google Maps ke dalam beberapa baris.
• Jangan melokalkan Google Maps atau Google ke bahasa lain.
• Cegah browser menerjemahkan Google Maps menggunakan atribut HTML translate="no".

Atur gaya teks Google Maps seperti yang dijelaskan dalam tabel berikut:

CSS Contoh

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;
}