Bekerja dengan perender Ubin 3D Anda sendiri

Jika tidak dapat menyertakan produk rendering pihak ketiga ke dalam solusi, Anda mungkin harus membuat perender Kartu 3D Anda sendiri. Pendekatan ini mengharuskan Anda mempertimbangkan faktor-faktor penting berikut:

URL Konten

Saat menayangkan Kartu 3D Fotorealistik, Map Tiles API akan menampilkan URI untuk kumpulan kartu turunan. URI kumpulan ubin ini bukan URL biasa. URI ini hanya menyertakan komponen jalur dan parameter. Kunci API tidak berisi kunci API Anda, yang diperlukan untuk mengizinkan permintaan Anda. Untuk informasi selengkapnya, lihat Spesifikasi Kartu 3D.

Permintaan dan respons

Berikut beberapa contoh permintaan dan respons Ubin 3D Fotorealistik. Anda memeriksanya menggunakan Chrome Developer Tools.

Contoh permintaan kumpulan ubin root:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

Contoh URI respons rangkaian petak:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

Contoh URL permintaan kartu yang digunakan oleh perender:

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

Anda harus melampirkan parameter apa pun yang muncul di URI tileset, beserta kunci API, saat membuat permintaan kartu berikutnya. 3D Tiles API menyediakan dua parameter berikut:

session
ID bawaan untuk sesi pemuatan 3D. ID ini otomatis dihasilkan oleh API. ID ini harus disertakan oleh perender saat membuat permintaan kartu berikutnya.
key
Kunci API yang Anda gunakan untuk mengakses layanan 3D Tiles. Anda harus melampirkannya ke semua permintaan kartu berikutnya.

Atribusi Display

Atribusi berarti mengonfirmasi sumber petak peta dan merupakan persyaratan untuk penggunaan API ini, termasuk atribusi merek Google (logo) serta atribusi data. Logo Google tersedia untuk Anda di halaman Kebijakan Map Tiles API. Informasi atribusi data ditampilkan di setiap respons kartu. Cari di isi respons, dalam JSON di bagian asset.copyright.

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

Anda harus menggabungkan, mengurutkan, dan menampilkan informasi ini pada baris teks, biasanya di bagian bawah rendering. Hal ini mencakup langkah-langkah berikut:

  1. Ekstrak semua informasi hak cipta dari semua kotak yang terlihat.

  2. Pisahkan beberapa sumber hak cipta dengan titik koma.

  3. Urutkan informasi berdasarkan jumlah kejadian.

  4. Tampilkan sumber hak cipta di layar, yang diurutkan dari kemunculan paling banyak ke yang paling jarang, mirip dengan cara Google Earth melakukannya.