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.

Kebijakan

Bagian ini menjelaskan kebijakan yang relevan dengan Map Tiles API. Kebijakan memberikan panduan dan persyaratan penerapan praktis untuk membantu Anda menggunakan Layanan dengan benar dan sesuai dengan ekspektasi Google Maps Platform.

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
  • Penafsiran 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 . 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.

Cetak

Gambar Street View tidak boleh digunakan untuk tujuan cetak, seperti yang diuraikan dalam kebijakan Street View.

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:

Gambar yang dirender yang menampilkan atribusi data Google dan Google Maps
Atribusi Google Maps yang diterapkan ke peta menggunakan Map Tiles API

Anda harus menyertakan atribusi Google Maps yang jelas saat menampilkan konten dari API Google Maps Platform di aplikasi atau situs Anda. Atribusi harus berbentuk logo Google Maps jika memungkinkan. Jika ruang terbatas, teks Google Maps dapat diterima.

Atribusi logo

Variasi yang dapat diterima untuk atribusi logo Google Maps
Variasi yang dapat diterima untuk atribusi logo Google Maps

Logo Google Maps

Gunakan logo resmi Google Maps yang disediakan di bawah.

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 menghindari 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
Representasi logo Google Maps yang menunjukkan ruang kosong minimum dan rentang ukuran yang dapat diterima

Aksesibilitas logo

Ikuti persyaratan aksesibilitas berikut untuk logo Google Maps:

Menampilkan logo Google Maps dengan perender pihak ketiga

Saat Anda menggunakan Map Tiles API untuk menampilkan Google Maps menggunakan perender pihak ketiga, Anda tidak boleh menumpuk atau mengaburkan logo Google dengan logo lain, seperti logo perender. Pertahankan jarak buffer yang wajar antara logo Google dan logo pihak ketiga agar keduanya terlihat sebagai logo yang terpisah. Tidak boleh ada logo yang 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 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 ubin yang ditampilkan, atau dalam tampilan perender 3D. Perhatikan bahwa string atribusi bervariasi, 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 diarahkan kursor berlabel "Sumber data", yang akan terbuka di dalam jendela peta untuk memberikan informasi atribusi. Selalu usahakan untuk mempertahankan praktik kartografi yang baik.

Footer yang berisi logo Google dan atribusi penyedia data.

Menampilkan atribusi 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.

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

Menampilkan logo dan atribusi data dalam visualisasi hibrid

Saat menggunakan data Google Maps sebagai peta dasar saat menempatkan data peta Anda sendiri, Anda harus memastikan audiens Anda 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 Atribusi Google Maps di atas.

Sebagai contoh, pertimbangkan untuk menggabungkan Petak 3D Fotorealistik (sebagai pengisi latar belakang) dengan model fotorealistik Anda sendiri (di latar depan). Pengguna dapat 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 pengguna 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 Petak 3D Fotorealistik

Anda dapat menempatkan objek 3D Anda sendiri di atas Petak 3D Fotorealistik asalkan objek 3D tersebut tidak diekstrak, dilacak, atau diperoleh secara manual 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.
    • Video promosi tidak boleh berdurasi lebih dari 30 detik.
    • Video promosi harus berisi kemampuan aplikasi Anda.
    • Video promosi harus ditandai dengan jelas, "hanya untuk tujuan promosi" dan harus mematuhi pedoman Menampilkan Atribusi Google Maps.
    • 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:

Petak 2D

Petak Roadmap, Satellite, dan Terrain

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": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0",
  …
}

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 tanpa batas waktu. Nilai ID panorama ditampilkan di kolom panoId dalam respons Street View Static API.

Anda harus menampilkan hyperlink reportProblemLink di sudut kanan bawah gambar, dan hyperlink tersebut harus menyertakan teks link yang bertuliskan sesuatu seperti "Laporkan masalah terkait gambar ini".

Photorealistic 3D Tiles

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

Jika Anda 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 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 konsol Inspector.

Cara mengaktifkan atribusi untuk Cesium for Unity