Bekerja dengan perender Ubin 3D Anda sendiri

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

URL Konten

Saat menayangkan Photorealistic 3D Tiles, Map Tiles API menampilkan URI untuk set kartu turunan. URI tileset ini bukan URL reguler. URI tersebut hanya menyertakan komponen jalur dan parameter. File tersebut tidak berisi kunci API Anda, yang diperlukan untuk mengizinkan permintaan Anda. Untuk informasi selengkapnya, lihat Spesifikasi Kartu 3D.

Permintaan dan respons

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

Contoh permintaan tileset root:

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

Contoh URI respons tileset:

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

Contoh URL permintaan tile 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, bersama dengan kunci API, saat membuat permintaan kartu berikutnya. 3D Tiles API menyediakan dua parameter berikut:

session
ID bawaan untuk sesi pemuatan 3D. ID ini dibuat secara otomatis oleh API. Atribut ini harus dilampirkan 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 tampilan

Atribusi berarti mengakui sumber ubin peta dan merupakan persyaratan untuk penggunaan API ini - 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, di JSON pada 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 memerlukan langkah-langkah berikut:

  1. Ekstrak semua informasi hak cipta dari semua ubin yang ada dalam tampilan.

  2. Pisahkan beberapa sumber hak cipta dengan titik koma.

  3. Mengurutkan informasi berdasarkan jumlah kemunculan.

  4. Menampilkan sumber hak cipta di layar, yang diurutkan dari kejadian terbanyak hingga yang paling sedikit, mirip dengan cara Google Earth melakukannya.