Kebijakan dan atribusi untuk Geocoding API

Dokumen ini mencantumkan persyaratan untuk aplikasi yang dikembangkan dengan Geocoding API. Perhatikan bahwa penggunaan Geocoding API diatur oleh Perjanjian Anda dengan Google.

Kebijakan

Bagian ini menjelaskan kebijakan yang relevan dengan Geocoding 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 caching

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.

Pemfilteran dan pengurutan ulang sisi klien

Anda dapat melakukan pemfilteran sisi klien pada daftar hasil tingkat teratas, seperti menghapus hasil alamat yang tidak cocok dengan kriteria negara atau kode pos tertentu. Anda juga dapat memfilter atau mengurutkan ulang subdaftar yang terdapat dalam satu hasil, seperti memprioritaskan titik navigasi tertentu, asalkan kriteria pemfilteran atau pengurutan ulang tidak menyesatkan pengguna akhir. Anda harus memastikan bahwa perubahan ini tidak memberikan representasi yang keliru atas data asli yang ditampilkan oleh API.

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 panduan 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 API Google Maps Platform di aplikasi atau situs Anda. Anda tidak perlu menambahkan atribusi tambahan jika Konten ditampilkan di Google Maps yang atribusinya sudah terlihat.

Atribusi Google Maps yang disertakan

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 spasi kosong yang memadai.
  • Saat melakukan modifikasi visual, Anda harus mematuhi semua persyaratan atribusi Google Maps.

Atribusi harus berupa logo Google Maps jika memungkinkan. Jika ruang terbatas, teks Google Maps dapat diterima. Pengguna akhir harus selalu dapat 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

Download logo Google Maps

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

Mendownload 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 tepi pada latar belakang yang ramai, seperti peta atau gambar.
  • Gunakan logo tanpa garis batas 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 logo minimum: 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 menampilkan ruang kosong minimum dan rentang ukuran yang dapat diterima
Contoh logo Google Maps yang menampilkan 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 atribusi teks Google Maps yang dapat diterima
Contoh variasi atribusi teks Google Maps yang dapat diterima
  • Jangan ubah teks Google Maps dengan cara apa pun:
    • Jangan ubah kapitalisasi Google Maps
    • Jangan membungkus Google Maps menjadi beberapa baris
    • Jangan lokalkan Google Maps ke bahasa lain.
    • Cegah 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

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

    Persyaratan gaya teks Google Maps
    Properti Gaya
    Jenis font Roboto. Pemuatan font bersifat opsional.
    Jenis font pengganti Font isi sans serif apa pun 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) terhadap latar belakang.
    Ukuran font Ukuran font minimum: 12sp
    Ukuran font maksimum: 16sp
    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 perlakuan visual atribusi Google Maps.

  • Posisikan 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 memberikan pernyataan tidak benar tentang Google Maps dengan mengatribusikannya ke konten non-Google Maps Platform.
  • Pastikan atribusi selalu terlihat dan terbaca. 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, di bagian bawah, dan di 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 lainnya

Jangan mengaburkan atribusi Google Maps atau mencampurnya dengan konten dari sumber lain
Jangan mengaburkan 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 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, menyertakan "Google Maps" atau logo Google saja bukanlah bentuk atribusi yang benar.

Ringkasan yang didukung AI (Destinasi)

Saat menampilkan ringkasan yang didukung AI yang ditampilkan oleh metode SearchDestinations di aplikasi, Anda harus melakukan hal-hal berikut:

  • Tampilkan atribusi, link pelaporan, dan link perujuk yang diperlukan seperti yang ditentukan di bagian ini.
  • Pastikan pengguna akhir dapat membaca teks ringkasan lengkap seperti yang disediakan oleh Google Maps Platform.

Menampilkan teks pengungkapan ringkasan yang didukung AI

Saat menampilkan ringkasan yang didukung AI, selalu sertakan teks pengungkapan yang dilokalkan yang disediakan di kolom respons disclosureText tepat di bawah ringkasan. Jangan pernah mengubah atau menambah teks pengungkapan yang disediakan oleh API.

Ringkasan yang didukung AI dengan teks pengungkapan
Gambar 1: Teks pengungkapan ditampilkan dengan benar di bawah ringkasan yang didukung AI.

Persyaratan ringkasan kedatangan

Ringkasan kedatangan yang ditampilkan di aplikasi Anda harus disertai dengan teks berikut dan link yang diperlukan:

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

Gunakan link yang terdapat dalam kolom flagContentUrl pada respons yang memungkinkan Anda melaporkan masalah kepada Google terkait konten ringkasan.

Catatan: Ringkasan yang didukung AI yang disediakan melalui Geocoding API tunduk pada kebijakan produk dan konten Google di mana pun Anda berada. Anda harus memberi tahu pengguna akhir bahwa jika mereka ingin melaporkan konten yang harus dihapus dari layanan Google berdasarkan hukum yang berlaku, mereka harus melaporkannya menggunakan URL konten yang ditandai yang disediakan, flagContentUrl.
Ringkasan yang didukung AI dengan link yang diperlukan
Gambar 2: Ringkasan yang didukung AI ditampilkan dengan link terkait yang diperlukan dan disediakan untuk pengguna akhir menggunakan menu tambahan.

Panduan tampilan untuk kasus penggunaan otomotif

Demi keselamatan pengemudi, Google merekomendasikan untuk 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 bahwa perhatian pengemudi cepat kembali ke jalan:

  • Tidak lebih dari 3 baris
  • 120 karakter atau 24 kata atau kurang
  • Ukuran font 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.