Kebijakan Map Tiles API

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

Menyediakan ketentuan penggunaan dan kebijakan privasi

Jika mengembangkan aplikasi Map Tiles API, Anda harus menyediakan Persyaratan Penggunaan dan Kebijakan Privasi bersama aplikasi Anda yang memenuhi pedoman yang diuraikan dalam Perjanjian dengan Google:

  • Persyaratan Penggunaan dan Kebijakan Privasi harus tersedia secara publik.
  • Anda harus secara eksplisit menyatakan dalam Persyaratan Penggunaan aplikasi bahwa pengguna akan terikat dengan Persyaratan Layanan Google dengan menggunakan aplikasi Anda.
  • Anda harus memberi tahu pengguna dalam Kebijakan Privasi bahwa Anda menggunakan Google Maps API dan menyertakan Kebijakan Privasi Google melalui penyebutannya.

Tempat yang disarankan untuk menyediakan Persyaratan Penggunaan dan Kebijakan Privasi Anda bergantung pada platform aplikasi Anda.

Aplikasi seluler

Jika mengembangkan aplikasi seluler, sebaiknya Anda menyediakan link ke Persyaratan Penggunaan dan Kebijakan Privasi pada halaman download aplikasi Anda di app store yang relevan dan di menu setelan aplikasi.

Aplikasi web

Jika mengembangkan aplikasi web, sebaiknya sediakan link ke Persyaratan Penggunaan dan Kebijakan Privasi di footer situs Anda.

Pengambilan data di awal, dalam cache, atau penyimpanan konten

Aplikasi yang menggunakan Map Tiles API terikat oleh persyaratan Perjanjian Anda dengan Google. Tunduk pada persyaratan Perjanjian, Anda tidak boleh mengambil di awal, mengindeks, menyimpan, atau menyimpan Konten apa pun ke dalam cache, kecuali dalam kondisi terbatas yang dinyatakan dalam persyaratan.

Secara khusus, aplikasi harus menggunakan Map Tiles API untuk visualisasi peta. Anda tidak boleh menggunakan Map Tiles API untuk kasus penggunaan non-visualisasi, seperti:

  • Analisis gambar
  • Penafsiran mesin
  • Deteksi/identifikasi objek
  • Ekstraksi atau penjualan kembali geodata
  • Penggunaan offline, termasuk untuk salah satu hal di atas

Respons Map Tiles API dapat menyertakan header Cache-Control yang harus diterapkan sesuai dengan dokumentasi protokol HTTP. Sebagai contoh, klien Anda harus mematuhi nilai max-age, nilai stale-while-revalidate, perintah must-revalidate, dan perintah private saat diteruskan dalam respons.

Respons Map Tiles API juga dapat menyertakan header ETag yang juga harus diimplementasikan sesuai dengan dokumentasi protokol HTTP saat meminta dengan validasi ulang.

Menampilkan hasil Map Tiles API

Anda dapat menampilkan hasil Map Tiles API di Google Maps, atau tanpa peta. Jika Anda ingin menampilkan hasil Map Tiles API pada peta, hasil ini harus ditampilkan di Google Map. Dilarang menggunakan data Map Tiles API pada peta yang bukan peta Google.

Saat menggunakan Map Tiles API untuk menampilkan Google Maps, Anda juga harus menampilkan logo Google di peta, dan tidak boleh mengubah logo dengan cara apa pun. Anda harus menempatkan logo Google di sudut kiri bawah peta, dan menempatkan informasi atribusi di sudut kanan peta. Untuk info selengkapnya, lihat Panduan Pusat Referensi Brand kami.

Untuk pengalaman peta 3D yang lebih sinematik, yaitu jika persyaratan desain UX pengalaman Anda tidak dapat mengakomodasi panduan penempatan ini dengan mudah, Anda tetap harus menampilkan logo Google dengan jelas di awal atau akhir atau kedua ujung pengalaman, sehingga kepengarangan peta dapat dipahami oleh audiens. Anda tetap harus mematuhi cara menampilkan atribusi data pihak ketiga seperti yang dijelaskan di bawah selama durasi pengalaman sinematik. Lihat Menampilkan logo dan atribusi data dalam visualisasi campuran di bawah untuk panduan selengkapnya.

Contoh peta berikut menampilkan logo Google di kiri bawah peta, dan atribusi di kanan bawah.

File ZIP berikut berisi logo Google dalam ukuran yang tepat untuk aplikasi desktop, Android, dan iOS. Anda tidak boleh mengubah ukuran atau memodifikasi logo-logo ini dengan cara apa pun.

Download: google_logo.zip

Jangan ubah atribusi. Jangan menghapus, mengaburkan, atau memangkas informasi atribusi. Anda tidak dapat menggunakan logo Google secara inline (misalnya, "Peta ini berasal dari [logo_Google]").

Tutup atribusi. Jika menggunakan screenshot gambar Google di luar penyematan langsung, sertakan atribusi standar seperti yang muncul dalam gambar. Jika perlu, Anda dapat menyesuaikan gaya dan penempatan teks atribusi, asalkan teks tersebut berada dalam jarak dekat dengan konten dan dapat dibaca oleh kebanyakan audiens atau pembaca. Anda tidak boleh memindahkan atribusi dari konten, seperti ke bagian akhir buku, kredit file atau acara TV, atau footer situs Anda.

Sertakan penyedia data pihak ketiga. Beberapa data dan gambar di produk pemetaan kami berasal dari penyedia selain Google. Jika menggunakan gambar tersebut, teks atribusi Anda harus menyebutkan nama "Google" dan penyedia data yang relevan, seperti "Data peta: Google, Maxar Technologies". Jika ada penyedia data pihak ketiga yang dikutip bersama gambar, hanya menyertakan "Google" atau logo Google bukanlah atribusi yang tepat.

Jika Anda menggunakan Google Maps Platform di perangkat yang kurang praktis untuk menampilkan atribusi, hubungi tim penjualan Google untuk membahas lisensi yang sesuai dengan kasus penggunaan Anda.

Menampilkan logo Google dengan perender pihak ketiga

Saat menggunakan Map Tiles API untuk menampilkan Google Maps menggunakan perender pihak ketiga, Anda tidak boleh menimpa atau mengaburkan logo Google dengan logo lainnya, seperti logo perender. Pertahankan jarak buffer yang wajar antara logo Google dan logo pihak ketiga, sehingga muncul sebagai logo independen. Tidak ada logo yang dapat tumpang-tindih atau mengaburkan atribusi data yang disediakan oleh respons API.

Gambar hasil render yang menampilkan logo Google dan Cesium

Menampilkan atribusi data Google

Data yang ditampilkan dari Map Tiles API memerlukan tampilan informasi atribusi dan hak cipta dari metadata atau permintaan informasi area pandang yang sesuai. Anda harus menampilkan informasi ini, secara lengkap seperti yang disediakan di lokasi yang sesuai, biasanya di sudut kanan bawah kumpulan kartu yang ditampilkan, atau dalam tampilan perender 3D. Perhatikan bahwa string atribusi bersifat variabel, bergantung pada data peta yang diminta oleh area pandang perender.

Jika tidak memungkinkan untuk menampilkan atribusi data secara penuh karena batasan ukuran area pandang, pertimbangkan untuk menambahkan elemen UI yang dapat diklik atau pengarahan kursor yang berlabel "Sumber data", yang akan terbuka dalam jendela peta untuk memberikan informasi atribusi. Selalu berusaha untuk mempertahankan praktik kartografi yang baik.

Footer yang berisi logo Google dan atribusi penyedia data.

Menampilkan atribusi data pihak ketiga

Saat menggunakan Map Tiles API untuk menampilkan data Google Maps sebagai peta dasar dan menempatkan data geospasial pihak ketiga (non-Google), Anda mungkin diwajibkan untuk menampilkan atribusi dari penyedia data pihak ketiga. Anda tidak boleh tumpang-tindih atau menyamarkan atribusi data Google dengan cara apa pun dengan atribusi data data pihak ketiga. Atribusi data pihak ketiga harus secara jelas dipisahkan dari atribusi data Google. Selain itu, harus jelas bahwa logo Google dan atribusi data Google terkait dengan peta dasar dan satu sama lain.

Menampilkan atribusi logo dan data dalam visualisasi campuran

Jika menggunakan data Google Maps sebagai peta dasar saat menempatkan data peta sendiri, Anda harus memastikan bahwa audiens sepenuhnya memahami bagian mana dari visualisasi peta yang diatribusikan ke Google dan bagian mana yang diatribusikan ke data peta Anda sendiri. Selain itu, ikuti panduan dalam Menampilkan logo Google di atas.

Sebagai contoh, pertimbangkan untuk menggabungkan Ubin 3D Fotorealistik (sebagai pengisi latar belakang) dengan model fotorealistik Anda sendiri (di latar depan). Pengguna mungkin akan bingung mengenai komponen tempat mana yang berasal dari data Google Maps. Dalam kasus tersebut, Anda harus dengan jelas menyatakan dalam string atribusi UI atau alur pengguna bagian mana dari scene yang berasal dari data Google Maps. Anda bertanggung jawab untuk mematuhi persyaratan atribusi pihak ketiga yang mungkin berlaku untuk sumber data yang Anda gunakan dengan data Google Maps.

Overlay geodata dengan Ubin 3D Fotorealistik

Anda dapat menempatkan objek 3D Anda sendiri di Ubin 3D Fotorealistik selama objek 3D tersebut tidak diekstrak, dilacak, atau diperoleh dengan tangan atau mesin dari Ubin 3D Fotorealistik.

Pembuatan video yang menampilkan Map Tiles API

  • Video Promosi: Anda dapat membuat video promosi yang tunduk pada persyaratan Perjanjian dan hal berikut:
    • Video promosi tidak boleh menyertakan gambar Street View.
    • Video promosi tidak boleh berdurasi lebih dari 30 detik.
    • Video promosi harus menjelaskan kemampuan aplikasi Anda.
    • Video promosi harus ditandai dengan jelas, "hanya untuk tujuan promosi" dan harus mematuhi Pedoman Atribusi dalam Kebijakan Map Tiles API.
    • Video promosi tidak boleh dijual secara terpisah atau sebagai bagian dari software, aplikasi, atau pengalaman pengguna.
  • Penghapusan: Anda bertanggung jawab untuk mematuhi semua permintaan penghapusan Video Promosi, termasuk permintaan dari pihak ketiga.

Dapatkan informasi atribusi dan hak cipta dari kolom copyright dalam respons panggilan API berikut, bergantung pada layanan yang Anda gunakan:

Ubin 2D

Ubin peta jalan, Satelit, dan Medan

Informasi hak cipta dan atribusi tersedia dari respons informasi area pandang, seperti ditunjukkan dalam contoh berikut.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    ...
  ]
}

Ubin Street View

Informasi hak cipta dan atribusi tersedia dari respons metadata Street View. Contoh:

{
  "panoId": "Zzl28rqGJgaL2IdkUleP8A",
  "lat": 50.059138596550696,
  "imageHeight": 6656,
  "imageWidth": 13312,
  "tileHeight": 512,
  "tileWidth": 512,
  "copyright": "From the Owner, Photo by: Google",
  …
}

ID panorama, yang digunakan untuk mengidentifikasi panorama Street View secara unik, dikecualikan dari pembatasan penyimpanan cache. Oleh karena itu, Anda dapat menyimpan nilai ID panorama tanpa batas. Nilai ID Panorama ditampilkan di kolom panoId dalam respons Street View Static API.

Ubin 3D Fotorealistik

Untuk Ubin 3D Fotorealistik, data atribusi ditampilkan dalam setiap permintaan ubin. Anda harus menggabungkan, mengurutkan, dan menampilkan dalam satu baris, semua atribusi untuk kartu yang ditampilkan; biasanya di bagian bawah rendering. Misalnya, Anda dapat menemukan atribusi data dalam kartu glTF dengan melihat di bagian asset, copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

CesiumJS

Jika menggunakan CesiumJS sebagai perender, Anda harus mengaktifkan showCreditsOnScreen di HTML rendering untuk menampilkan atribusi.

// Add Photorealistic 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
      url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
      // This property is needed to appropriately display attributions
      // as required.
      showCreditsOnScreen: true,
    }));

Cesium untuk Unreal

Jika Anda menggunakan Cesium for Unreal sebagai perender, untuk menampilkan atribusi, Anda harus mengaktifkan kolom Show Credits On Screen pada World Outliner.

Cara mengaktifkan atribusi untuk Cesium for Unreal

Cesium untuk Unity

Jika Anda menggunakan Cesium for Unity sebagai perender, untuk menampilkan atribusi, Anda harus mengaktifkan kolom Show Credits On Screen di Inspector console.

Cara mengaktifkan atribusi untuk Cesium for Unity

Pedoman gaya untuk atribusi Google

Berikut adalah pedoman gaya untuk atribusi Google dalam CSS dan HTML jika Anda tidak dapat menggunakan logo Google yang dapat didownload.

Ruang kosong

Jumlah ruang kosong di sekitar logo lengkap harus sama dengan atau lebih besar dari tinggi "G" di Google.

Ruang antara salinan atribusi dan logo Google harus setengah lebar "G".

Keterbacaan

Baris nama penulis harus selalu jelas, dapat dibaca, dan ditampilkan dalam variasi warna yang tepat untuk latar belakang tertentu. Selalu pastikan untuk memberikan kontras yang cukup untuk variasi logo yang Anda pilih.

Warna

Gunakan teks Google Material Gray 700 dengan latar belakang putih atau terang yang menggunakan rentang tint maksimum 0%–40% warna hitam.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Pada latar belakang yang lebih gelap, dan di atas fotografi atau pola tidak sibuk, gunakan teks putih untuk baris nama penulis dan atribusi.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Font

Gunakan font Roboto.

Contoh CSS

CSS berikut, jika diterapkan pada teks "Google", akan merender "Google" dengan font, warna, dan spasi yang sesuai dengan latar belakang putih atau terang.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;