Geospatial API menggunakan kombinasi VPS dan data GPS untuk menghasilkan pose Geospasial akurasi tinggi. API ini dapat digunakan di mana pun perangkat dapat menentukan lokasinya:
- Di area dengan akurasi GPS rendah, seperti dalam ruangan dan lingkungan perkotaan yang padat, API ini akan bergantung pada cakupan VPS untuk menghasilkan pose dengan akurasi tinggi.
- Di lingkungan luar ruangan dengan sedikit atau tanpa penghalang di atas, Geospatial API mungkin dapat menggunakan data lokasi GPS yang tersedia untuk membuat pose Geospasial dengan akurasi tinggi.
Anda dapat menentukan ketersediaan VPS di posisi horizontal tertentu sebelum sesi AR dimulai dan menggunakannya untuk menciptakan pengalaman yang lebih spesifik — misalnya, untuk menampilkan "Enter AR" tombol ini hanya jika VPS tersedia.
Mengaktifkan ARCore API
Aplikasi Anda harus mengaktifkan ARCore API untuk memeriksa ketersediaan VPS.
Memeriksa ketersediaan VPS di aplikasi
Geospatial API dapat digunakan di mana pun perangkat dapat menentukan lokasinya. Jika pengalaman AR Anda bergantung pada cakupan VPS, Anda dapat menggunakan AREarthManager.CheckVpsAvailabilityAsync()
untuk mendapatkan VpsAvailabilityPromise
, tugas asinkron yang memeriksa ketersediaan VPS pada posisi horizontal tertentu.
Setelah memiliki VpsAvailabilityPromise
, Anda dapat memperoleh hasilnya dengan polling.
Membuat polling untuk hasil
Gunakan VpsAvailabilityPromise.State
untuk mendapatkan status InterruptiblePromise
. Ada tiga status yang berbeda:
Pending
: Operasi belum selesai, sehingga tidak ada hasil yang diketahui.Cancelled
: Operasi telah dibatalkan olehVpsAvailabilityPromise.Cancel()
. Callback yang terdaftar tidak akan pernah dipanggil.Done
: Operasi selesai. GunakanVpsAvailabilityPromise.Result
untuk mendapatkan hasil.
Anda dapat terus memeriksa VpsAvailabilityPromise.State
hingga tugas selesai.
Batalkan InterruptiblePromise
Gunakan VpsAvailabilityPromise.Cancel()
untuk mencoba membatalkan InterruptiblePromise
. Karena paralelisme thread, ada kemungkinan bahwa upaya pembatalan Anda sebenarnya tidak berhasil.
Menggunakan Geospatial API tanpa cakupan VPS
Geospatial API juga dapat digunakan di area yang tidak memiliki cakupan VPS. Di lingkungan luar ruangan dengan sedikit atau tanpa penghalang di atas kepala, GPS mungkin cukup untuk membuat pose dengan akurasi tinggi.
Langkah berikutnya
- Dapatkan pose Geospasial kamera perangkat untuk menentukan lokasi persis perangkat pengguna di dunia nyata.