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:
Ekstrak semua informasi hak cipta dari semua kotak yang terlihat.
Pisahkan beberapa sumber hak cipta dengan titik koma.
Urutkan informasi berdasarkan jumlah kejadian.
Tampilkan sumber hak cipta di layar, yang diurutkan dari kemunculan paling banyak ke yang paling jarang, mirip dengan cara Google Earth melakukannya.