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 Anda mengembangkan aplikasi Map Tiles API, Anda harus menyediakan Persyaratan Penggunaan dan Kebijakan Privasi bersama aplikasi Anda yang memenuhi panduan yang dijelaskan dalam Perjanjian Anda dengan Google:

  • Persyaratan Penggunaan dan Kebijakan Privasi harus tersedia untuk umum.
  • Anda harus menyatakan secara eksplisit dalam Persyaratan Penggunaan aplikasi Anda bahwa dengan menggunakan aplikasi Anda, pengguna akan terikat dengan Persyaratan Layanan Google.
  • Anda harus memberi tahu pengguna dalam Kebijakan Privasi Anda bahwa Anda menggunakan Google Maps API dan melalui penyebutan memasukkan Kebijakan Privasi Google.

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

Aplikasi seluler

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

Aplikasi web

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

Melakukan pra-pengambilan, menyimpan dalam cache, atau menyimpan konten

Aplikasi yang menggunakan Map Tiles API terikat dengan ketentuan Perjanjian Anda dengan Google. Tunduk pada ketentuan Perjanjian Anda, Anda tidak boleh melakukan pra-pengambilan, mengindeks, menyimpan dalam cache, atau menyimpan Konten apa pun, kecuali berdasarkan kondisi terbatas yang dinyatakan dalam ketentuan tersebut.

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
  • Interpretasi mesin
  • Deteksi atau 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 diimplementasikan sesuai dengan dokumentasi protokol HTTP . Misalnya, 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 diterapkan sesuai dengan dokumentasi protokol HTTP saat meminta dengan validasi ulang.

Perhatikan bahwa ID tempat, yang digunakan untuk mengidentifikasi tempat secara unik, dikecualikan dari pembatasan penyimpanan dalam cache. ID tempat ditampilkan di kolom place_id sebagai respons Map Tiles API. Pelajari cara menyimpan, memperbarui, dan mengelola ID tempat di panduan ID Tempat.

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

Untuk pengalaman peta 3D yang lebih sinematik, yaitu, jika persyaratan desain UX pengalaman Anda tidak dapat dengan mudah mengakomodasi panduan penempatan ini, Anda tetap harus menampilkan logo Google dengan jelas di awal atau akhir atau kedua ujung pengalaman, sehingga penulis peta dapat dipahami oleh audiens Anda. Anda tetap diwajibkan untuk mematuhi ketentuan terkait tampilan atribusi data pihak ketiga seperti yang dijelaskan di bawah ini 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 mengubah atribusi. Jangan menghapus, mengaburkan, atau memangkas informasi atribusi. Anda tidak boleh menggunakan logo Google secara inline (misalnya, "Peta ini dari [Google_logo]").

Selalu dekatkan posisi atribusi. Jika menggunakan screenshot gambar Google di luar sematan langsung, sertakan atribusi dasar sebagaimana yang muncul di gambar tersebut. Jika perlu, Anda dapat menyesuaikan gaya dan penempatan teks atribusi, selama teks tersebut berada sangat dekat dengan konten dan dapat dibaca oleh kebanyakan pelihat atau pembaca. Anda tidak boleh menjauhkan atribusi dari konten, seperti ke bagian akhir buku Anda, kredit file atau acara Anda, atau footer situs Anda.

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

Jika Anda menggunakan Google Maps Platform di perangkat yang tidak mungkin digunakan untuk menampilkan atribusi, hubungi tim penjualan Google untuk mendiskusikan lisensi yang sesuai untuk 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 tumpang-tindih atau mengaburkan logo Google dengan logo lain, seperti logo perender. Pertahankan jarak buffer yang wajar antara logo Google dan logo pihak ketiga sehingga keduanya muncul sebagai logo independen. Tidak ada logo yang boleh tumpang-tindih atau mengaburkan atribusi data yang diberikan oleh respons API.

Gambar yang dirender menampilkan logo Google dan Cesium

Menampilkan atribusi data Google

Data yang ditampilkan dari Map Tiles API memerlukan tampilan atribusi dan informasi hak cipta dari permintaan metadata atau informasi tampilan yang sesuai. Anda harus menampilkan informasi ini, secara lengkap seperti yang disediakan di lokasi yang sesuai, biasanya 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 sepenuhnya karena batasan ukuran area pandang, pertimbangkan untuk menambahkan elemen UI yang dapat diklik atau diarahkan kursornya yang berlabel "Sumber data", yang akan terbuka dalam jendela peta untuk memberikan informasi atribusi. Selalu berusaha untuk mempertahankan praktik kartografis 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 mengaburkan atribusi data Google dengan cara apa pun dengan atribusi data pihak ketiga. Atribusi data pihak ketiga harus dihapus dengan jelas dari atribusi data Google. Selain itu, harus jelas bahwa logo Google dan atribusi data Google dikaitkan dengan peta dasar dan satu sama lain.

Menampilkan logo dan atribusi data dalam visualisasi campuran

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

Sebagai contoh, pertimbangkan untuk menggabungkan Kartu 3D Fotorealistik (sebagai pengisi latar belakang) dengan model fotorealistik Anda sendiri (di latar depan). Pengguna mungkin bingung terkait komponen scene mana yang berasal dari data Google Maps. Dalam kasus tersebut, Anda harus menyatakan dengan jelas dalam string atribusi UI atau alur penggunaan bagian mana dari tampilan 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 Photorealistic 3D Tiles

Anda dapat menempatkan objek 3D Anda sendiri di Petak 3D Fotorealistik selama objek 3D tersebut tidak diekstrak, dilacak, atau berasal dari tangan atau mesin dari Petak 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.
    • Durasi video promosi tidak boleh lebih dari 30 detik.
    • Video promosi harus tentang 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 kembali 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:

Kartu 2D

Petak Peta Jalan, Satelit, dan Medan

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

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

Street View Tiles

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 dalam cache. Oleh karena itu, Anda dapat menyimpan nilai ID panorama secara tidak terbatas. Nilai ID Panorama ditampilkan di kolom panoId dalam respons Street View Static API.

Photorealistic 3D Tiles

Untuk Petak 3D Fotorealistik, data atribusi ditampilkan dalam setiap permintaan ubin. Anda harus menggabungkan, mengurutkan, dan menampilkan dalam baris, semua atribusi untuk kartu yang ditampilkan; biasanya di sepanjang bagian bawah rendering. Misalnya, Anda dapat menemukan atribusi data di 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, untuk menampilkan atribusi, Anda harus mengaktifkan showCreditsOnScreen di HTML rendering.

// 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 menggunakan Cesium for Unreal sebagai perender, untuk menampilkan atribusi, Anda harus mengaktifkan kolom Show Credits On Screen di World Outliner.

Cara mengaktifkan atribusi untuk Cesium untuk Unreal

Cesium untuk Unity

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

Cara mengaktifkan atribusi untuk Cesium untuk Unity

Panduan gaya untuk atribusi Google

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

Ruang kosong

Ukuran 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 huruf "G".

Keterbacaan

Baris nama penulis harus selalu jelas, dapat dibaca, dan ditampilkan dengan variasi warna terang untuk latar belakang tertentu. Pastikan selalu ada kontras yang memadai untuk variasi logo yang Anda pilih.

Warna

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

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

Di latar belakang yang lebih gelap, dan di pola yang tidak rumit atau fotografi, 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.

CSS Contoh

CSS berikut, saat diterapkan ke teks "Google", akan merender "Google" dengan font, warna dan ruang yang sesuai di 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;