Kebijakan Map Tiles API

Dokumen ini berisi daftar 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 panduan yang diuraikan dalam Perjanjian Anda dengan Google:

  • Persyaratan Penggunaan dan Kebijakan Privasi harus tersedia untuk publik.
  • 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 bahwa Anda menggunakan Google Maps API dan menyertakan Kebijakan Privasi Google melalui penyebutannya.

Tempat yang direkomendasikan untuk menyediakan Persyaratan Penggunaan dan Kebijakan Privasi 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 dalam menu setelan aplikasi.

Aplikasi web

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

Pengambilan data, penyimpanan 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 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 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 cache. ID tempat ditampilkan di kolom `place_id` dalam respons Map Tiles API. Pelajari cara menyimpan, memuat ulang, dan mengelola ID tempat di panduan ID Tempat.

Saat menggunakan Map Tiles API untuk menampilkan Google Maps, Anda juga harus menampilkan logo Google pada 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 bawah peta. Untuk info selengkapnya, lihat Panduan Brand Resource Center kami.

Untuk pengalaman peta 3D yang lebih sinematik, yaitu jika persyaratan desain UX pengalaman Anda tidak dapat mengakomodasi panduan penempatan ini dengan jelas, Anda tetap harus menampilkan logo Google dengan jelas di awal atau akhir atau kedua ujung pengalaman, sehingga kepengarangan peta dapat dipahami oleh audiens Anda. Anda tetap harus mematuhi cara menampilkan atribusi data pihak ketiga seperti yang dijelaskan di bawah selama durasi pengalaman sinematik. Lihat Menampilkan atribusi logo dan 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 inline (misalnya, "Peta ini dari [Google_logo]").

Tetap dekatkan atribusi. Jika menggunakan screenshot gambar Google di luar sematan langsung, sertakan atribusi standar seperti yang muncul dalam gambar. Jika perlu, Anda dapat menyesuaikan gaya dan penempatan teks atribusi, selama teks tersebut berada dalam jarak yang 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, atau footer situs.

Sertakan penyedia data pihak ketiga. Sebagian data dan gambar di produk pemetaan kami berasal dari penyedia selain Google. Jika menggunakan gambar tersebut, teks atribusi 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 tidak memungkinkan tampilan atribusi, hubungi tim penjualan Google untuk mendiskusikan 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 membuat logo Google menjadi tumpang-tindih atau mengaburkan logo Google dengan logo lain, seperti logo perender. Pertahankan jarak buffer yang wajar antara logo Google dan logo pihak ketiga, agar muncul sebagai logo independen. Tidak ada logo yang boleh tumpang-tindih atau mengaburkan atribusi data yang diberikan 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 permintaan informasi metadata atau area pandang yang sesuai. Anda harus menampilkan informasi ini, secara lengkap seperti yang disediakan di lokasi yang sesuai, biasanya di pojok kanan bawah kumpulan kartu yang ditampilkan, atau di tampilan perender 3D. Perhatikan bahwa string atribusi adalah variabel, bergantung pada data peta yang diminta oleh area tampilan perender.

Jika tidak mungkin untuk menampilkan atribusi data secara penuh karena batasan ukuran area tampilan, sebaiknya tambahkan elemen UI yang dapat diklik atau yang memiliki label "Sumber data", yang akan terbuka di dalam jendela peta untuk memberikan informasi atribusi. Selalu upayakan untuk mempertahankan praktik kartografi yang baik.

Footer yang berisi atribusi penyedia data dan logo Google.

Menampilkan atribusi data pihak ketiga

Saat Anda menggunakan Map Tiles API untuk menampilkan data Google Maps sebagai peta dasar dan overlay data geospasial pihak ketiga (non-Google), Anda mungkin diharuskan 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 dikaitkan dengan peta dasar dan satu sama lain.

Menampilkan atribusi data dan logo dalam visualisasi campuran

Jika menggunakan data Google Maps sebagai peta dasar saat menempatkan data peta milik Anda sendiri, Anda harus memastikan 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 bisa bingung mengenai komponen adegan mana yang berasal dari data Google Maps. Dalam kasus tersebut, Anda harus menyatakan dengan jelas di string atribusi UI atau alur penggunaan 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 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 dengan tunduk pada persyaratan Perjanjian dan berikut ini:
    • Video promosi tidak boleh menyertakan gambar Street View.
    • Video promosi tidak boleh berdurasi lebih dari 30 detik.
    • Video promosi harus membahas 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:

Kartu 2D

Peta jalan, Petak Satelit dan Medan

Informasi hak cipta dan atribusi tersedia dari respons informasi area tampilan, seperti 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 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.

Photorealistic 3D Tiles

Untuk Kartu 3D Fotorealistik, data atribusi ditampilkan di setiap permintaan kartu. 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 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 untuk Unreal sebagai perender, maka untuk menampilkan atribusi, Anda harus mengaktifkan kolom Show Credits On Screen pada World Outliner.

Cara mengaktifkan atribusi untuk Cesium untuk Unreal

Cesium untuk Unity

Jika menggunakan Cesium untuk Unity sebagai perender, Anda harus mengaktifkan kolom Tampilkan Kredit di Layar untuk menampilkan atribusi di konsol Inspector.

Cara mengaktifkan atribusi untuk Cesium untuk 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 huruf "G" di Google.

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

Kejelasan

Baris nama harus selalu jelas, dapat dibaca, dan muncul 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 pada latar belakang putih atau terang yang menggunakan rentang tint maksimum 0%–40% 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 pada 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;