Bekerja dengan perender Ubin 3D Anda sendiri

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

URL Konten

Saat menyajikan Ubin 3D Fotorealistik, Map Tiles API menampilkan URI untuk set kartu turunan. URI kumpulan ubin ini bukan URL biasa. Kolom tersebut hanya mencakup komponen jalur dan parameter. Mereka tidak berisi kunci API Anda, yang yang diperlukan untuk menyetujui permintaan Anda. Untuk informasi selengkapnya, lihat Spesifikasi Ubin 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 kumpulan ubin, bersama dengan kunci API, saat Anda membuat permintaan kartu berikutnya. 3D Tiles API menyediakan dua parameter berikut:

session
ID bawaan untuk sesi pemuatan 3D. Hasil ini dibuat secara otomatis oleh API. ID ini harus disertakan oleh perender saat menyusun elemen berikutnya permintaan kotak.
key
Kunci API yang Anda gunakan untuk mengakses layanan 3D Tiles. Anda harus melampirkannya pada semua permintaan kartu berikutnya.

Atribusi Display

Atribusi berarti mengakui sumber petak peta dan merupakan persyaratan untuk API ini - termasuk atribusi merek Google (logo) serta atribusi data. Logo Google tersedia untuk Anda di Kebijakan Map Tiles API. Data informasi atribusi 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, menyortir, dan menampilkan informasi ini pada satu baris teks, biasanya berada 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. Menampilkan sumber hak cipta di layar, diurutkan dari kemunculan sebagian besar ke sama seperti bagaimana Google Earth yang melakukannya.