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 Privasi Kebijakan terkait aplikasi Anda yang memenuhi pedoman yang diuraikan 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 oleh ketentuan Perjanjian 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
  • Penafsiran mesin
  • Deteksi/identifikasi objek
  • Ekstraksi atau penjualan kembali data geo
  • Penggunaan offline, termasuk untuk semua hal di atas

Respons Map Tiles API dapat menyertakan header Cache-Control yang seharusnya diterapkan sesuai dengan protokol HTTP dokumentasi kami. 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 menyertakan 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` di Respons Map Tiles API. Pelajari cara menyimpan, memperbarui, dan mengelola ID tempat di panduan ID Tempat.

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

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

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

{i>File<i} {i>zip<i} berikut berisi logo Google dalam ukuran yang tepat untuk 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 Anda menggunakan Map Tiles API untuk menampilkan Google Maps menggunakan perender pihak ketiga, Anda tidak boleh tumpang-tindih atau mengaburkan logo Google dengan logo lainnya, seperti logo perender. Mempertahankan jarak buffer yang wajar di antara logo Google dan logo pihak ketiga sehingga mereka tampak 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 atribusi dan informasi hak cipta dari metadata atau informasi area pandang yang sesuai permintaan. Anda harus menampilkan informasi ini, lengkap seperti yang disediakan dalam yang sesuai, biasanya di sudut kanan bawah dari rangkaian petak, atau dalam tampilan perender 3D. Perhatikan bahwa string atribusi variabel, bergantung pada data peta yang diminta oleh area pandang perender.

Jika atribusi data tidak dapat ditampilkan secara penuh karena ukuran area pandang tambahan, pertimbangkan untuk menambahkan elemen UI yang dapat diklik atau mengarahkan kursor ke atas yang berlabel "Data sumber", yang akan terbuka di dalam jendela peta untuk memberikan informasi atribusi. Selalu upayakan untuk menjaga kartografi yang baik praktik.

Footer yang berisi logo Google dan atribusi penyedia data.

Menampilkan atribusi data pihak ketiga

Saat Anda menggunakan Map Tiles API untuk menampilkan Google Maps data 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 melalui atribusi data data pihak ketiga. Atribusi data pihak ketiga harus secara jelas tidak dikaitkan lagi dengan atribusi data Google. Selain itu, harus jelas bahwa logo Google dan atribusi data Google dikaitkan dengan peta dasar dan dengan satu sama lain.

Menampilkan atribusi data dan logo dalam visualisasi campuran

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

Misalnya, coba gabungkan Ubin 3D Fotorealistik (sebagai pengisi latar belakang) dengan model fotorealistik sendiri (di latar depan). Pengguna bisa bingung mengenai komponen adegan mana yang berasal dari data Google Maps. Di beberapa saat ini, Anda harus menyatakannya dengan jelas dalam string atribusi UI atau alur penggunaan bagian adegan mana yang berasal dari data Google Maps. Anda berada 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 pada Petak 3D Fotorealistik selama objek 3D tidak diekstrak, dilacak, atau diperoleh dengan tangan atau mesin dari Petak 3D Fotorealistik.

Pembuatan video dengan Map Tiles API

  • Video Promosi: Anda dapat membuat video promosi yang tunduk kepada persyaratan Perjanjian dan hal-hal berikut:
    • Video promosi tidak boleh menyertakan gambar Street View.
    • Video promosi tidak boleh berdurasi lebih dari 30 detik.
    • Video promosi harus berisi kemampuan aplikasi.
    • Video promosi harus ditandai dengan jelas, "untuk tujuan promosi hanya" dan harus mematuhi Pedoman Atribusi dalam Kebijakan Map Tiles API.
    • Video promosi tidak boleh dijual secara terpisah atau sebagai bagian dari perangkat lunak, 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 merespons panggilan API berikut, bergantung pada layanan menggunakan:

Ubin 2D

Ubin peta jalan, Satelit, dan Medan

Informasi hak cipta dan atribusi tersedia dari informasi area tampilan 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 atribusi dan hak cipta tersedia dari metadata Street View yang dihasilkan. 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, adalah dikecualikan dari pembatasan penyimpanan dalam cache. Oleh karena itu, Anda dapat menyimpan nilai ID panorama tanpa batas waktu. Nilai ID Panorama ditampilkan di kolom panoId di Street Melihat respons Static API.

Photorealistic 3D Tiles

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

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

CesiumJS

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

// 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, Anda harus menampilkan atribusi, Anda harus mengaktifkan kolom Tampilkan Kredit di Layar pada Outliner Dunia.

Cara mengaktifkan atribusi untuk Cesium untuk Tidak nyata

Cesium untuk Unity

Jika Anda menggunakan Cesium untuk Unity sebagai perender, Anda harus menampilkan atribusi, Anda harus mengaktifkan kolom Tampilkan Kredit di Layar pada Konsol pemeriksa.

Cara mengaktifkan atribusi untuk Cesium untuk {i>Unity<i} (Kesatuan)

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;