Kebijakan dan atribusi untuk Places API

Dokumen ini mencantumkan persyaratan yang spesifik untuk semua aplikasi yang dikembangkan dengan Places API (Baru), termasuk layanan Autocomplete (Baru) yang merupakan bagian dari API tersebut. Informasi umum lainnya untuk developer Google Maps dapat ditemukan di Persyaratan Layanan Google Maps Platform.

Kebijakan

Bagian ini menjelaskan kebijakan yang relevan dengan Places API. Kebijakan memberikan panduan dan persyaratan penerapan praktis untuk membantu Anda menggunakan Layanan dengan benar dan sesuai dengan ekspektasi Google Maps Platform.

Pengecualian dari batasan penyimpanan ke dalam cache

Perhatikan bahwa ID tempat, yang digunakan untuk mengidentifikasi tempat secara unik, dikecualikan dari pembatasan penyimpanan dalam cache. Karena itu Anda bisa menyimpan nilai ID tempat secara tak terbatas. ID tempat ditampilkan di kolom place_id dalam respons API. Pelajari cara menyimpan, memperbarui, dan mengelola ID tempat di panduan ID Tempat.

Negara dan wilayah Wilayah Ekonomi Eropa

Produk ini memiliki Persyaratan Layanan yang berbeda untuk pelanggan dengan alamat penagihan di Wilayah Ekonomi Eropa (EEA), dan mungkin juga memiliki fungsi yang berbeda. Sebelum membangun dengan Google Maps Platform, tinjau persyaratan dan informasi khusus EEA berikut:

Jika alamat penagihan Anda tidak berada di EEA, persyaratan layanan berikut berlaku untuk Anda:

Persyaratan atribusi Google Maps

Bagian ini memberikan persyaratan dan pedoman atribusi untuk menampilkan Google Maps dan Konten melalui aplikasi Anda.

Menampilkan atribusi Google Maps

Anda harus mengikuti persyaratan atribusi Google Maps saat menampilkan Konten dari Google Maps Platform API di aplikasi atau situs Anda. Anda tidak perlu menambahkan atribusi tambahan jika Konten ditampilkan di Google Maps yang sudah menampilkan atribusi.

Mencantumkan atribusi Google Maps

Untuk atribusi Google Maps yang sudah disediakan oleh Google Maps Platform di antarmuka pengguna, seperti di Places UI Kit:

  • Jangan menghapus atribusi yang disertakan, di mana pun atribusi tersebut ditampilkan. Jangan mengubah, menyembunyikan, atau mengaburkan atribusi dan pastikan atribusi terlihat jelas di latar belakang.
  • Selalu bedakan Konten Google Maps Platform secara visual dari konten lain menggunakan petunjuk UI seperti batas, warna latar belakang, bayangan, atau ruang kosong yang memadai.
  • Saat melakukan modifikasi visual, Anda harus mematuhi semua persyaratan atribusi Google Maps.

Atribusi harus menggunakan logo Google Maps jika memungkinkan. Jika ruang terbatas, teks Google Maps dapat digunakan. Pengguna akhir harus selalu mengetahui dengan jelas konten mana yang disediakan oleh Google Maps.

Kiri: Atribusi logo Google Maps, Kanan: Atribusi teks Google Maps
Kiri: Contoh atribusi logo Google Maps, Kanan: Contoh atribusi teks Google Maps

Atribusi logo

Ikuti persyaratan berikut untuk menggunakan logo Google Maps di aplikasi atau situs Anda.
Variasi yang dapat diterima untuk atribusi logo Google Maps
Contoh variasi yang dapat diterima untuk atribusi logo Google Maps

Mendownload logo Google Maps

Gunakan file logo Google Maps resmi. Download logo di bawah, dan ikuti panduan di bagian ini.

Download aset atribusi Google Maps

Saat menggunakan logo Google Maps, ikuti panduan berikut.

  • Jangan mengubah logo dengan cara apa pun.
  • Pertahankan rasio aspek logo untuk mencegah distorsi.
  • Gunakan logo bergaris pada latar belakang yang ramai, seperti peta atau gambar.
  • Gunakan logo tanpa garis luar pada latar belakang polos, seperti warna solid atau gradien halus.

Spesifikasi ukuran logo

Ikuti spesifikasi ukuran berikut untuk logo Google Maps:
  • Tinggi logo minimum: 16 dp
  • Tinggi logo maksimum: 19 dp
  • Ruang kosong minimum logo: 10 dp di kiri, kanan, dan atas, 5 dp di bawah

Untuk mempelajari dp, lihat Kepadatan piksel di situs Desain Material.

Logo Google Maps yang menunjukkan ruang kosong minimum dan rentang ukuran yang dapat diterima
Contoh logo Google Maps yang menunjukkan ruang kosong minimum dan rentang ukuran yang dapat diterima

Aksesibilitas logo

Ikuti persyaratan aksesibilitas berikut untuk logo Google Maps:
Variasi yang tidak dapat diterima dan masalah aksesibilitas untuk atribusi logo Google Maps
Contoh variasi yang tidak dapat diterima dan masalah aksesibilitas untuk atribusi logo Google Maps

Atribusi teks

Jika ukuran antarmuka Anda tidak mendukung penggunaan logo Google Maps, Anda dapat mengeja Google Maps dalam teks. Ikuti pedoman berikut:

Variasi yang dapat diterima dari atribusi teks Google Maps
Contoh variasi atribusi teks Google Maps yang dapat diterima
  • Jangan mengubah teks Google Maps dengan cara apa pun:
    • Jangan mengubah kapitalisasi Google Maps
    • Jangan memisahkan Google Maps ke dalam beberapa baris
    • Jangan melokalkan Google Maps ke bahasa lain.
    • Mencegah browser menerjemahkan Google Maps dengan menggunakan atribut HTML translate="no".
Variasi atribusi teks Google Maps yang tidak dapat diterima
Contoh variasi atribusi teks Google Maps yang tidak dapat diterima
  • Gaya teks Google Maps seperti yang dijelaskan dalam tabel berikut:

    Persyaratan gaya teks Google Maps
    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 Unit ukuran font di situs Desain Material.
    Spasi huruf Normal

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

Persyaratan visual

Ikuti persyaratan berikut untuk tampilan visual atribusi Google Maps.
  • Tempatkan atribusi di dekat bagian atas atau bawah konten, dan dalam penampung visual yang sama. Untuk satu baris konten, atribusi dapat diposisikan di kanan atau kiri.

  • Bedakan Konten Google Maps Platform secara visual dari konten lain menggunakan petunjuk UI seperti batas, warna latar belakang, bayangan, atau ruang kosong yang memadai.

  • Jangan salah merepresentasikan Google Maps dengan mengatribusikannya dengan konten non-Google Maps Platform.
  • Pastikan atribusi selalu terlihat dan dapat dibaca. Jangan pernah menghapus, menyembunyikan, mengaburkan, atau mengubahnya.

Gambar berikut menunjukkan contoh persyaratan visual ini.

Contoh atribusi Google Maps yang diposisikan di atas, di bawah, dan di samping konten
Contoh atribusi Google Maps yang diposisikan di bagian atas, bawah, dan samping konten

Contoh dua pendekatan untuk membedakan Konten Google Maps (rating tempat) dari konten lainnya
Contoh dua pendekatan untuk membedakan Konten Google Maps (rating tempat) dari konten lain

Jangan menyamarkan atribusi Google Maps atau mencampurnya dengan konten dari sumber lain
Jangan menutupi atribusi Google Maps atau mencampurnya dengan konten dari sumber lain

Penyedia data pihak-ketiga

Beberapa data dan gambar di produk pemetaan kami berasal dari penyedia selain Google. Untuk beberapa produk, seperti Map Tiles API, kami dapat memberikan atribusi yang diperlukan kepada Anda untuk penyedia data pihak ketiga. Jika kami melakukannya, teks atribusi Anda harus berisi nama "Google Maps" dan penyedia data yang relevan, seperti "Data peta: Google, Maxar Technologies". Jika Google memberikan atribusi pihak ketiga, hanya menyertakan "Google Maps" atau logo Google bukanlah atribusi yang tepat.

Persyaratan Places API tambahan

Persyaratan berikut khusus untuk Places API.

Pelengkapan otomatis untuk alamat pengguna akhir

Jika pengguna akhir menggunakan fungsi Pelengkapan Otomatis dalam Aplikasi Pelanggan Anda untuk mengetik alamat jalan dan alamat jalan tersebut akan diberikan sepenuhnya dan secara akurat oleh pengguna akhir tersebut tanpa Pelengkapan Otomatis, alamat yang dipilih pengguna akhir tersebut tidak tunduk pada batasan Konten Google Maps dalam Perjanjian Platform Google Maps Anda. Pengecualian ini hanya berlaku untuk alamat jalan yang dipilih oleh pengguna akhir dan semata-mata untuk transaksi spesifik pengguna akhir tersebut; pengecualian ini tidak berlaku untuk daftar alamat yang disarankan yang disediakan oleh fungsi Pelengkapan Otomatis atau untuk Konten Google Maps lainnya. Pengecualian ini tidak berlaku untuk fungsi penelusuran alamat atau POI yang ditawarkan oleh Layanan Google Maps Platform lainnya.

Melengkapi otomatis alamat pengguna akhir

Daftar alamat di sebelah kiri masih tunduk pada pembatasan Konten Google Maps. Setelah pengguna akhir memilih alamat yang diinginkan, alamat tersebut tidak tunduk pada batasan Konten Google Maps hanya untuk tujuan transaksi yang berlaku bagi pengguna akhir tersebut.

Foto dan ulasan

Mengatribusikan semua konten kepada penulis konten

Anda harus selalu mencantumkan atribusi penulis saat menampilkan foto atau ulasan. Setiap foto dan ulasan mencakup atribusi penulis (gambar avatar, nama, dan link profil penulis).

Persyaratan visual untuk atribusi penulis:

  • Atribusikan penulis menggunakan semua resource yang tersedia (avatar, nama, dan link profil) jika ruang memungkinkan.
  • Untuk ulasan, jika ruang terbatas, persyaratan minimum adalah menampilkan avatar penulis.
  • Untuk foto, jika ruang terbatas (seperti dalam galeri atau untuk thumbnail), atribusi penulis dapat dihilangkan, asalkan pengguna dapat mengakses versi gambar yang lebih besar yang menyertakan atribusi penulis lengkap.
  • Posisikan atribusi penulis agar jelas terkait dengan foto atau ulasan penulis.
Atribusi penulis ditampilkan di sudut kiri atas foto dan ulasan
Contoh atribusi penulis yang ditampilkan di sudut kiri atas foto dan ulasan

Memberikan akses langsung ke konten sumber di Google Maps

Untuk setiap foto dan ulasan, pengguna akhir harus selalu memiliki akses untuk melihat foto sumber individual atau ulasan di Google Maps menggunakan googleMapsUri yang disediakan.

Menu vertikal dengan link untuk melihat foto atau ulasan sumber di Google Maps
Contoh menu vertikal dengan link untuk melihat foto sumber atau ulasan di Google Maps

Menampilkan tanggal publikasi relatif (misalnya, "2 hari yang lalu") untuk foto dan ulasan menggunakan relativePublishTimeDescription yang diberikan akan meningkatkan kepercayaan pengguna terhadap konten.

Foto dan ulasan yang disediakan melalui Places API tunduk pada kebijakan produk dan konten Google di mana pun Anda berada. Anda dan pengguna akhir Anda dapat melaporkan konten yang ingin Anda hapus dari layanan Google berdasarkan kebijakan Google atau hukum yang berlaku menggunakan flagContentUri untuk setiap foto dan ulasan. Atau, konten dapat dilaporkan dengan mengikuti link langsung ke konten di Google Maps, tempat pelaporan masalah juga tersedia.

Ulasan

Menjelaskan cara ulasan diurutkan dan difilter

Sertakan pemberitahuan yang jelas yang menjelaskan cara ulasan diurutkan dan difilter, termasuk kriteria penelusuran yang diterapkan. Secara default, ulasan diurutkan berdasarkan relevansi.

Pemberitahuan yang menjelaskan cara pengurutan ulasan
Contoh pemberitahuan yang menjelaskan cara ulasan diurutkan

Menampilkan bulan dan tahun saat pengulas mengunjungi tempat di Prancis

Saat menampilkan ulasan tempat di Prancis dan wilayah Prancis, Places API menampilkan visitDate (bulan dan tahun saat penulis mengunjungi tempat tersebut), yang harus ditampilkan bersama konten.

Tanggal kunjungan ditampilkan di bawah ulasan pengguna
Contoh tanggal kunjungan yang ditampilkan di bawah ulasan pengguna

Membuat pengguna akhir mengetahui kapan ulasan telah diterjemahkan dari bahasa aslinya. Anda dapat mengizinkan pengguna akhir melihat teks asli yang tidak diterjemahkan originalText. Atau, mereka dapat membuka link langsung ke konten di Google Maps tempat teks asli yang tidak diterjemahkan tersedia.

Pemberitahuan terjemahan ditampilkan di bawah ulasan pengguna
Contoh pemberitahuan terjemahan yang ditampilkan di bawah ulasan pengguna

Ulasan dan rating rata-rata

Ulasan tidak diverifikasi oleh Google, tetapi Google akan memeriksa dan menghapus konten palsu jika konten tersebut teridentifikasi. Memberi tahu pengguna akhir tentang kebijakan ulasan Google saat menampilkan ulasan dan rating rata-rata. Pelajari lebih lanjut kebijakan konten buatan pengguna Google Maps.

Contoh pemberitahuan yang menjelaskan kebijakan ulasan Google
Contoh pemberitahuan yang menjelaskan kebijakan ulasan Google

Ringkasan yang didukung AI

Saat Anda menampilkan ringkasan yang didukung AI di aplikasi Anda — termasuk ringkasan tempat, area, dan ulasan — Anda harus melakukan hal berikut:

  • Tampilkan atribusi, link pelaporan, dan link referensi yang diperlukan seperti yang ditentukan di bawah.
  • Pengguna akhir harus dapat membaca teks ringkasan lengkap sebagaimana disediakan oleh Google Maps.

Menampilkan teks pengungkapan ringkasan yang didukung AI

Saat menampilkan ringkasan yang didukung AI dalam jenis apa pun, selalu sertakan teks pengungkapan yang dilokalkan (disediakan di kolom disclosureText pada isi respons) tepat di bawah ringkasan. Jangan pernah mengubah atau menambahkan teks pengungkapan yang disediakan oleh API.

Pengungkapan untuk semua jenis ringkasan yang didukung AI
Teks pengungkapan ditampilkan dengan benar di bawah setiap tiga jenis ringkasan yang didukung AI

Persyaratan tambahan ringkasan tempat dan area

Ringkasan tempat dan area yang ditampilkan di aplikasi Anda harus disertai dengan teks dan link wajib berikut:

Teks Persyaratan
Tentang ringkasan ini Gunakan link berikut untuk mengetahui "Cara Google mendapatkan dan menggunakan informasi di listingan lokal": https://support.google.com/local-listings/answer/9851099.
Melaporkan ringkasan

Gunakan link yang ada di kolom flagContentUri respons untuk mengaktifkan pelaporan masalah ke Google terkait konten ringkasan.

Catatan: Ringkasan yang didukung AI yang disediakan melalui Places API (Baru) tunduk pada kebijakan produk dan konten Google di mana pun Anda berada. Anda diwajibkan untuk memberi tahu pengguna akhir Anda bahwa jika mereka ingin melaporkan konten yang harus dihapus dari layanan Google berdasarkan hukum yang berlaku, mereka harus melaporkannya menggunakan URL laporkan konten yang disediakan (flagContentUri).

Pengungkapan untuk ringkasan tempat dan area
Ringkasan area yang didukung AI ditampilkan dengan link terkait yang diperlukan dan tersedia bagi pengguna akhir menggunakan menu tambahan

Persyaratan ringkasan ulasan

Ringkasan ulasan yang ditampilkan di aplikasi Anda harus disertai dengan judul yang berisi teks "Ringkasan ulasan". Selain itu, Anda harus menggunakan teks dan link wajib berikut:

Teks Persyaratan
Tentang ringkasan ini Gunakan link berikut untuk melihat "Cara Google mendapatkan dan menggunakan informasi di listingan lokal": https://support.google.com/local-listings/answer/9851099
Melaporkan ringkasan

Gunakan link yang ada di kolom flagContentUri dalam respons.

Catatan: Ringkasan yang didukung AI yang disediakan melalui Places API (Baru) tunduk pada kebijakan produk dan konten Google di mana pun Anda berada. Anda diwajibkan untuk memberi tahu pengguna akhir Anda bahwa jika mereka ingin melaporkan konten yang harus dihapus dari layanan Google berdasarkan hukum yang berlaku, mereka harus melaporkannya menggunakan URL laporkan konten yang disediakan (flagContentUri).

Lihat ulasan Gunakan link yang ada di kolom reviewSummary.reviewsUri dalam respons.
Pengungkapan untuk ringkasan ulasan
Ringkasan ulasan yang didukung AI ditampilkan dengan link terkait yang diperlukan dan tersedia bagi pengguna akhir menggunakan menu tambahan

Panduan tampilan untuk kasus penggunaan otomotif

Untuk keselamatan pengemudi, Google merekomendasikan merender ringkasan yang didukung AI dalam mode parkir untuk pengalaman otomotif. Jika merender ringkasan dalam mode mengemudi, informasi di layar harus jelas dan ringkas untuk memastikan perhatian pengemudi kembali dengan cepat ke jalan:

  • Tidak lebih dari 3 baris
  • Maksimal 120 karakter atau 24 kata
  • Ukuran depan minimum 24 dp

Khususnya dalam konteks otomotif, developer bertanggung jawab untuk merender ringkasan yang didukung AI dengan cara yang aman dan mematuhi semua hukum dan peraturan setempat.

Hasil penelusuran tempat

Dalam satu interaksi pengguna, pengguna akhir harus mengetahui faktor utama dan pembobotan faktor utama yang menentukan peringkat hasil penelusuran.

Saat menggunakan peringkat Google yang tidak dimodifikasi, Anda dapat menampilkan teks penjelasan berikut:

"Saat menelusuri bisnis atau tempat di dekat suatu lokasi, Google Maps akan menampilkan hasil lokal. Beberapa faktor, terutama relevansi, jarak, dan keterlihatan, digabungkan untuk membantu menemukan hasil penelusuran terbaik. Pelajari lebih lanjut."

Pengungkapan untuk hasil penelusuran tempat
Dialog yang menjelaskan cara Google menentukan peringkat hasil penelusuran

Kepatuhan terhadap hukum yang berlaku

Anda diwajibkan untuk mematuhi semua hukum yang berlaku setiap saat. Perhatikan bahwa praktik yang diberi label (direkomendasikan) dalam kebijakan ini mungkin masih diwajibkan oleh hukum. Selain itu, mengikuti semua persyaratan yang dinyatakan dan praktik yang direkomendasikan tidak menjamin kepatuhan hukum penuh di semua wilayah hukum. Jika ada pertanyaan tentang status kepatuhan Anda, Anda harus meminta panduan dari penasihat hukum Anda.