Bekerja dengan perender Ubin 3D Anda sendiri

Developer Wilayah Ekonomi Eropa (EEA)

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

URL Konten

Saat menyajikan Ubin 3D Fotorealistik, API Ubin Peta mengembalikan URI untuk himpunan ubin anak. URI tileset ini bukan URL biasa. URI ini hanya mencakup komponen jalur dan parameter. Mereka tidak berisi kunci API Anda, yang diperlukan untuk mengotorisasi permintaan Anda. Untuk informasi lebih lanjut, lihat Spesifikasi Ubin 3D.

Permintaan dan respons

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

Contoh permintaan set petak 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 ubin 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 set petak, bersama dengan kunci API Anda, saat Anda membuat permintaan petak berikutnya. 3D Tiles API menyediakan dua parameter berikut:

session
ID bawaan untuk sesi pemuatan 3D. ID ini dibuat secara otomatis oleh API. Header ini harus dilampirkan oleh perender saat membuat permintaan petak berikutnya.
key
Kunci API yang Anda gunakan untuk mengakses layanan 3D Tiles. Anda harus melampirkannya ke semua permintaan petak berikutnya.

Menampilkan atribusi

Atribusi berarti mengonfirmasi sumber petak peta dan merupakan persyaratan untuk penggunaan API ini - hal ini mencakup 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 petak glTF, 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 dalam satu baris teks, biasanya di bagian bawah rendering. Hal ini memerlukan langkah-langkah berikut:

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

  2. Pisahkan beberapa sumber hak cipta dengan titik koma.

  3. Urutkan informasi berdasarkan jumlah kemunculan.

  4. Tampilkan sumber hak cipta di layar, diurutkan dari yang paling sering muncul hingga yang paling jarang, mirip dengan cara Google Earth melakukannya.