Anchor geospasial adalah jenis anchor yang memungkinkan Anda menempatkan konten 3D di dunia nyata.
Jenis anchor Geospasial
Ada tiga jenis anchor Geospasial, yang masing-masing menangani ketinggian secara berbeda:
Anchor WGS84:
Anchor WGS84 memungkinkan Anda menempatkan konten 3D pada garis lintang tertentu, bujur, dan ketinggian.Anchor medan:
Anchor medan memungkinkan Anda menempatkan konten hanya menggunakan lintang dan garis bujur dengan ketinggian relatif terhadap medan di posisi tersebut. Ketinggian ditentukan relatif terhadap tanah atau lantai sebagaimana diketahui oleh VPS.Anchor atap:
Anchor atap memungkinkan Anda menempatkan konten hanya menggunakan garis lintang dan garis bujur dengan ketinggian relatif terhadap atap bangunan pada posisi tersebut. Ketinggian ditentukan relatif terhadap bagian atas bangunan sebagaimana diketahui oleh Streetscape Geometry. Setelan ini akan menetapkan ketinggian medan jika tidak ditempatkan di atas bangunan secara default.
WGS84 | Medan | Atap | |
---|---|---|---|
Posisi Horizontal | Lintang, Bujur | Lintang, Bujur | Lintang, Bujur |
Posisi Vertikal | Relatif terhadap ketinggian WGS84 | Relatif terhadap tingkat medan yang ditentukan oleh Google Maps | Relatif terhadap tingkat atap yang ditentukan oleh Google Maps |
Perlu diselesaikan server? | Tidak | Ya | Ya |
Prasyarat
Pastikan Anda mengaktifkan Geospatial API sebelum melanjutkan.
Menempatkan anchor Geospasial
Setiap jenis anchor memiliki API khusus untuk membuatnya; lihat Jenis anchor Geospasial untuk mengetahui informasi selengkapnya.
Membuat anchor dari hit-test
Anda juga dapat membuat anchor Geospasial dari hasil hit-test.
Gunakan Pose dari hit-test dan konversikan menjadi GeospatialPose
. Gunakan untuk menempatkan salah satu dari 3 jenis anchor yang dijelaskan.
Ambil Pose Geospasial dari Pose AR
Earth.getGeospatialPose()
memberikan cara tambahan untuk menentukan lintang dan bujur dengan mengonversi Pose AR menjadi Pose Geospasial.
Ambil Pose AR dari Pose Geospasial
Earth.getPose()
mengonversi posisi horizontal, ketinggian, dan rotasi kuarternion yang ditentukan Bumi sehubungan dengan bingkai koordinat timur-atas-selatan menjadi Pose AR sehubungan dengan koordinat dunia GL.
Pilih metode yang sesuai dengan kasus penggunaan Anda
Setiap metode pembuatan anchor memiliki konsekuensi terkait yang perlu diingat:
- Saat menggunakan Streetscape Geometry, menggunakan hit-test untuk memasang konten ke sebuah bangunan.
- Memilih Anchor Medan atau Atap daripada anchor WGS84 karena menggunakan nilai ketinggian yang ditentukan oleh Google Maps.
Menentukan lintang dan bujur suatu lokasi
Ada tiga cara untuk menghitung lintang dan bujur lokasi:
- Gunakan Geospatial Creator untuk melihat dan memperkaya dunia dengan konten 3D tanpa harus pergi ke suatu lokasi secara fisik. Ini memungkinkan Anda menempatkan konten imersif 3D secara visual menggunakan Google Maps di Editor Unity. Lintang, bujur, rotasi, dan ketinggian konten akan dihitung secara otomatis untuk Anda.
- Gunakan Google Maps
- Gunakan Google Earth. Perhatikan bahwa memperoleh koordinat ini menggunakan Google Earth, bukan dengan Google Maps, akan memberi Anda margin kesalahan hingga beberapa meter.
- Pergi ke lokasi fisik
Gunakan Google Maps
Untuk mendapatkan lintang dan bujur suatu lokasi menggunakan Google Maps:
Buka Google Maps di komputer desktop.
Buka Lapisan > Lainnya.
Ubah Jenis Peta menjadi Satelit dan hapus centang pada kotak Tampilan Globe di sudut kiri bawah layar.
Tindakan ini akan memaksakan perspektif 2D dan menghilangkan kemungkinan error yang dapat muncul dari tampilan 3D miring.
Pada peta, klik kanan lokasi lalu pilih bujur/lintang untuk disalin ke papan klip.
Menggunakan Google Earth
Anda dapat menghitung lintang dan bujur lokasi dari Google Earth dengan mengklik lokasi di UI dan membaca data dari detail penanda letak.
Untuk mendapatkan lintang dan bujur suatu lokasi menggunakan Google Earth:
Buka Google Earth di komputer desktop.
Buka menu tiga garis
dan pilih Map Style.
Nonaktifkan tombol Bangunan 3D.
Setelah tombol Bangunan 3D dinonaktifkan, klik ikon pin
untuk menambahkan penanda letak di lokasi yang dipilih.
Tentukan project untuk menyertakan penanda letak Anda, lalu klik Simpan.
Di kolom Judul untuk penanda letak, masukkan nama untuk penanda letak.
Klik panah kembali
di panel project dan pilih menu Tindakan Lainnya
.
Pilih Ekspor sebagai file KML dari menu.
File KLM melaporkan lintang, bujur, dan ketinggian untuk penanda letak di tag <coordinates>
yang dipisahkan dengan koma, sebagai berikut:
<coordinates>-122.0755182435043,37.41347299422944,7.420342565583832</coordinates>
Jangan gunakan lintang dan bujur dari tag <LookAt>
, yang menentukan posisi kamera, bukan lokasi.
Pergi ke lokasi fisik
Anda dapat menghitung ketinggian lokasi dengan pergi ke sana secara fisik dan melakukan observasi lokal.
Mendapatkan kuarternion rotasi
GeospatialPose.getEastUpSouthQuaternion()
mengekstrak orientasi dari Pose Geospasial dan menghasilkan kuartal yang mewakili matriks rotasi yang mentransformasikan vektor dari target ke sistem koordinat timur-atas-selatan (EUS). X+ menunjuk ke timur, Y+ menunjuk ke atas, dan Z+ menunjuk ke selatan. Nilai ditulis dalam urutan {x, y, z, w}
.
Anchor WGS84
Anchor WGS84 adalah jenis anchor yang memungkinkan Anda menempatkan konten 3D pada lintang, bujur, dan ketinggian tertentu. Tema bergantung pada Pose, dan orientasi, untuk ditempatkan di dunia nyata. Posisi terdiri dari lintang, bujur, dan ketinggian, yang ditetapkan dalam sistem koordinat WGS84. Orientasi terdiri dari rotasi kuaternion.
Ketinggian dilaporkan dalam meter di atas elipsoid WGS84 referensi sehingga permukaan tanah bukan nol. Aplikasi Anda bertanggung jawab memberikan koordinat ini untuk setiap anchor yang dibuat.
Tempatkan anchor WGS84 di dunia nyata
Menentukan ketinggian lokasi
Ada beberapa cara untuk menentukan ketinggian lokasi untuk menempatkan anchor:
- Jika lokasi anchor secara fisik dekat dengan pengguna, Anda dapat menggunakan ketinggian yang serupa dengan ketinggian perangkat pengguna.
- Setelah Anda memiliki lintang dan bujur, gunakan Elevation API untuk mendapatkan elevasi berdasarkan spesifikasi EGM96. Anda harus mengonversi ketinggian Maps API EGM96 menjadi WGS84 untuk dibandingkan dengan ketinggian
GeospatialPose
. Lihat GeoidEval yang memiliki command line dan antarmuka HTML. Maps API melaporkan lintang dan bujur sesuai dengan spesifikasi WGS84 yang siap pakai. - Anda dapat memperoleh lintang, bujur, dan ketinggian lokasi dari Google Earth. Tindakan ini akan memberi Anda margin error hingga beberapa meter. Gunakan lintang, bujur, dan ketinggian dari tag
<coordinates>
, bukan tag<LookAt>
, di file KML. - Jika anchor yang ada berada dekat dan jika Anda tidak berada di lereng yang curam, Anda mungkin dapat menggunakan ketinggian dari
GeospatialPose
kamera tanpa menggunakan sumber lain, seperti Maps API.
Membuat anchor
Setelah memiliki garis lintang, bujur, ketinggian, dan kuaternion rotasi, gunakan Earth.createAnchor()
untuk menambatkan konten ke koordinat geografis yang Anda tentukan.
Java
if (earth != null && earth.getTrackingState() == TrackingState.TRACKING) { Anchor anchor = earth.createAnchor( /* Location values */ latitude, longitude, altitude, /* Rotational pose values */ qx, qy, qz, qw); // Attach content to the anchor specified by geodetic location and pose. }
Kotlin
if (earth.trackingState == TrackingState.TRACKING) { val anchor = earth.createAnchor( /* Location values */ latitude, longitude, altitude, /* Rotational pose values */ qx, qy, qz, qw ) // Attach content to the anchor specified by geodetic location and pose. }
Angkur Medan
Anchor medan adalah jenis anchor yang memungkinkan Anda menempatkan objek AR hanya menggunakan lintang dan bujur, yang memanfaatkan informasi dari VPS untuk menemukan ketinggian yang akurat di atas tanah.
Alih-alih memasukkan ketinggian yang diinginkan, Anda memberikan ketinggian di atas medan. Jika nilainya nol, jangkar akan sejajar dengan medan.
Menyetel mode pencarian bidang
Penemuan bidang bersifat opsional dan tidak diwajibkan untuk menggunakan anchor. Perhatikan bahwa hanya bidang horizontal yang digunakan. Bidang horizontal akan membantu penyelarasan dinamis jangkar medan di tanah.
Gunakan Config.PlaneFindingMode
untuk memilih cara aplikasi mendeteksi pesawat.
Membuat anchor Medan menggunakan Asynchronous API yang baru
Untuk membuat dan menempatkan anchor Medan, panggil Earth.resolveAnchorOnTerrainAsync()
.
Anchor tidak akan langsung siap dan harus diselesaikan. Setelah diselesaikan, masalah tersebut akan tersedia di ResolveAnchorOnTerrainFuture
.
Java
final ResolveAnchorOnTerrainFuture future = earth.resolveAnchorOnTerrainAsync( latitude, longitude, /* altitudeAboveTerrain= */ 0.0f, qx, qy, qz, qw, (anchor, state) -> { if (state == TerrainAnchorState.SUCCESS) { // do something with the anchor here } else { // the anchor failed to resolve } });
Kotlin
var future = earth.resolveAnchorOnTerrainAsync( latitude, longitude, altitudeAboveTerrain, qx, qy, qz, qw, { anchor, state -> if (state == TerrainAnchorState.SUCCESS) { // do something with the anchor here } else { // the anchor failed to resolve } } )
Periksa Keadaan di Masa Depan
Future akan memiliki FutureState
terkait.
Negara Bagian | Deskripsi |
---|---|
FutureState.PENDING |
Operasi masih tertunda. |
FutureState.DONE |
Operasi selesai dan hasilnya tersedia. |
FutureState.CANCELLED |
Operasi telah dibatalkan. |
Memeriksa status tetap Medan dari hasil Mendatang
Anchor.TerrainAnchorState
milik operasi asinkron dan merupakan bagian dari hasil Future akhir.
Java
switch (terrainAnchorState) { case SUCCESS: // A resolving task for this Terrain anchor has finished successfully. break; case ERROR_UNSUPPORTED_LOCATION: // The requested anchor is in a location that isn't supported by the Geospatial API. break; case ERROR_NOT_AUTHORIZED: // An error occurred while authorizing your app with the ARCore API. See // https://developers.google.com/ar/reference/java/com/google/ar/core/Anchor.TerrainAnchorState#error_not_authorized // for troubleshooting steps. break; case ERROR_INTERNAL: // The Terrain anchor could not be resolved due to an internal error. break; default: // not reachable break; }
Kotlin
when (state) { TerrainAnchorState.SUCCESS -> { // A resolving task for this Terrain anchor has finished successfully. } TerrainAnchorState.ERROR_UNSUPPORTED_LOCATION -> { // The requested anchor is in a location that isn't supported by the Geospatial API. } TerrainAnchorState.ERROR_NOT_AUTHORIZED -> { // An error occurred while authorizing your app with the ARCore API. See // https://developers.google.com/ar/reference/java/com/google/ar/core/Anchor.TerrainAnchorState#error_not_authorized // for troubleshooting steps. } TerrainAnchorState.ERROR_INTERNAL -> { // The Terrain anchor could not be resolved due to an internal error. } else -> { // Default. } }
Angkur Atap
Anchor atap adalah jenis anchor dan sangat mirip dengan Anchor medan di atas. Perbedaannya adalah Anda akan memberikan ketinggian di atas atap bukan ketinggian di atas medan.
Membuat Rooftop Anchor menggunakan Asynchronous API yang baru
Anchor tidak akan langsung siap dan harus diselesaikan.
Untuk membuat dan menempatkan Anchor atap, panggil Earth.resolveAnchorOnRooftopAsync()
. Sama halnya dengan Anchor Medan, Anda juga akan mengakses FutureState
Future. Kemudian, Anda dapat memeriksa hasil Future untuk mengakses Anchor.RooftopAnchorState
.
Java
final ResolveAnchorOnRooftopFuture future = earth.resolveAnchorOnRooftopAsync( latitude, longitude, /* altitudeAboveRooftop= */ 0.0f, qx, qy, qz, qw, (anchor, state) -> { if (state == RooftopAnchorState.SUCCESS) { // do something with the anchor here } else { // the anchor failed to resolve } });
Kotlin
var future = earth.resolveAnchorOnRooftopAsync( latitude, longitude, altitudeAboveRooftop, qx, qy, qz, qw, { anchor, state -> if (state == RooftopAnchorState.SUCCESS) { // do something with the anchor here } else { // the anchor failed to resolve } } )
Periksa Keadaan di Masa Depan
Future akan memiliki FutureState
terkait, lihat tabel di atas.
Memeriksa status anchor atap dari hasil Future
Anchor.RooftopAnchorState
milik operasi asinkron dan merupakan bagian dari hasil Future akhir.
Java
switch (rooftopAnchorState) { case SUCCESS: // A resolving task for this Rooftop anchor has finished successfully. break; case ERROR_UNSUPPORTED_LOCATION: // The requested anchor is in a location that isn't supported by the Geospatial API. break; case ERROR_NOT_AUTHORIZED: // An error occurred while authorizing your app with the ARCore API. // https://developers.google.com/ar/reference/java/com/google/ar/core/Anchor.RooftopAnchorState#error_not_authorized // for troubleshooting steps. break; case ERROR_INTERNAL: // The Rooftop anchor could not be resolved due to an internal error. break; default: // not reachable break; }
Kotlin
when (state) { RooftopAnchorState.SUCCESS -> { // A resolving task for this Rooftop anchor has finished successfully. } RooftopAnchorState.ERROR_UNSUPPORTED_LOCATION -> { // The requested anchor is in a location that isn't supported by the Geospatial API. } RooftopAnchorState.ERROR_NOT_AUTHORIZED -> { // An error occurred while authorizing your app with the ARCore API. See // https://developers.google.com/ar/reference/java/com/google/ar/core/Anchor.RooftopAnchorState#error_not_authorized // for troubleshooting steps. } RooftopAnchorState.ERROR_INTERNAL -> { // The Rooftop anchor could not be resolved due to an internal error. } else -> { // Default. } }
Langkah berikutnya
- Pastikan Anda memahami kuota penggunaan API Geospatial.