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:
- Persyaratan Layanan Google Maps Platform EEA
- Persyaratan Khusus Layanan Google Maps Platform untuk EEA
- Pertanyaan umum (FAQ) terkait EEA
- Persyaratan Keselamatan Jalan Google Maps Platform
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.
Logo Google Maps dan atribusi teks
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.
Atribusi logo
Ikuti persyaratan berikut untuk menggunakan logo Google Maps di aplikasi atau situs Anda.Mendownload logo Google Maps
Gunakan file logo Google Maps resmi. Download logo di bawah, dan ikuti panduan di bagian ini.
Download aset atribusi Google MapsSaat 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.
Aksesibilitas logo
Ikuti persyaratan aksesibilitas berikut untuk logo Google Maps:- Pertahankan kontras yang dapat diakses antara logo dan latar belakang.
- Sertakan label aksesibilitas dengan teks Google Maps.
Atribusi teks
Jika ukuran antarmuka Anda tidak mendukung penggunaan logo Google Maps, Anda dapat mengeja Google Maps dalam teks. Ikuti pedoman berikut:
- 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".
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.
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.
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.
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.
Tampilkan tanggal publikasi relatif (direkomendasikan) *
Menampilkan tanggal publikasi relatif (misalnya, "2 hari yang lalu") untuk foto dan ulasan menggunakan
relativePublishTimeDescription yang diberikan akan meningkatkan kepercayaan pengguna terhadap konten.
Mengaktifkan pelaporan konten (direkomendasikan) *
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.
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.
Memberi tahu pengguna akhir saat ulasan telah diterjemahkan (direkomendasikan) *
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.
Ulasan dan rating rata-rata
Memberi tahu pengguna akhir tentang cara Google memverifikasi ulasan (direkomendasikan) *
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.
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.
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 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 ( |
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 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 ( |
| Lihat ulasan | Gunakan link yang ada di kolom reviewSummary.reviewsUri dalam respons. |
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
Jelaskan faktor-faktor yang memengaruhi peringkat hasil penelusuran (direkomendasikan) *
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."
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.