Terima kasih telah menonton Google I/O. Tonton konten AR secara on-demand.

Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan anchor Geospasial untuk memosisikan konten dunia nyata di iOS

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 dengan cara yang berbeda:

Anchor WGS84:
Anchor WGS84 memungkinkan Anda menempatkan konten 3D pada lintang, bujur, dan ketinggian tertentu.
Anchor medan:
Anchor medan memungkinkan Anda menempatkan konten hanya menggunakan lintang dan bujur dengan tinggi yang relatif terhadap medan di posisi tersebut. Ketinggian ditentukan relatif terhadap tanah atau lantai seperti yang diketahui oleh VPS.
Anchor atap:
Anchor atap memungkinkan Anda menempatkan konten hanya menggunakan lintang dan bujur dengan tinggi yang relatif terhadap atap gedung di posisi tersebut. Ketinggian ditentukan secara relatif terhadap bagian atas bangunan seperti yang diketahui oleh Streetscape Geometry. Nilai ini akan ditetapkan secara default ke ketinggian medan jika tidak ditempatkan di bangunan.

	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 di-resolve 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 Transformasi dari hit-test dan konversikan ke GARGeospatialTransform. Gunakan untuk menempatkan salah satu dari 3 jenis anchor yang dijelaskan.

Mendapatkan Transformasi Geospasial dari Transformasi AR

GARSession.geospatialTransformFromTransform:error: menyediakan cara tambahan untuk menentukan lintang dan bujur dengan mengonversi Transformasi AR menjadi Transformasi Geospasial.

Mendapatkan Transformasi AR dari Transformasi Geospasial

GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error: mengonversi posisi horizontal, ketinggian, dan rotasi kuadrat yang ditentukan Bumi sehubungan dengan bingkai koordinat timur-atas-selatan menjadi Transformasi AR sehubungan dengan koordinat dunia GL.

Memilih metode yang sesuai dengan kasus penggunaan Anda

Setiap metode pembuatan anchor memiliki kompromi terkait yang perlu diingat:

Saat menggunakan Streetscape Geometry, gunakan hit-test untuk melampirkan konten ke gedung.
Pilih anchor Terrain atau Rooftop daripada anchor WGS84 karena menggunakan nilai ketinggian yang ditentukan oleh Google Maps.

Menentukan lintang dan bujur lokasi

Ada tiga cara untuk menghitung lintang dan bujur lokasi:

Gunakan Geospatial Creator untuk melihat dan meningkatkan dunia dengan konten 3D tanpa harus pergi ke lokasi secara fisik. Hal ini memungkinkan Anda menempatkan konten imersif 3D secara visual menggunakan peta Google di Unity Editor. Lintang, bujur, rotasi, dan ketinggian konten akan otomatis dihitung untuk Anda.
Gunakan Google Maps
Gunakan Google Earth. Perhatikan bahwa mendapatkan koordinat ini menggunakan Google Earth, bukan Google Maps, akan memberi Anda margin error hingga beberapa meter.
Buka lokasi fisik

Gunakan Google Maps

Untuk mendapatkan lintang dan bujur 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 memaksa perspektif 2D dan menghilangkan kemungkinan error yang dapat berasal dari tampilan 3D miring.
Pada peta, klik kanan lokasi, lalu pilih bujur/lintang untuk menyalinnya 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 , lalu pilih Gaya Peta.
Nonaktifkan tombol Bangunan 3D.
Setelah tombol Bangunan 3D dinonaktifkan, klik ikon pin untuk menambahkan penanda lokasi 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, lalu 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.

Buka lokasi fisik

Anda dapat menghitung ketinggian lokasi dengan pergi ke sana secara fisik dan melakukan pengamatan lokal.

Mendapatkan kuadrat rotasi

GARGeospatialTransform.eastUpSouthQTarget mengekstrak orientasi dari Transformasi Geospasial dan menghasilkan kuaternion yang mewakili matriks rotasi yang mentransformasikan vektor dari target ke sistem koordinat timur-atas-selatan (EUS). X+ mengarah ke timur, Y+ mengarah ke atas, dan Z+ mengarah 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. Transformasi ini bergantung pada Transformasi, 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 untuk 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 berada di dekat pengguna, Anda dapat menggunakan ketinggian yang mirip dengan ketinggian perangkat pengguna.
Setelah Anda memiliki lintang dan bujur, gunakan Elevation API untuk mendapatkan elevasi berdasarkan spesifikasi EGM96. Anda harus mengonversi elevasi Maps API EGM96 ke WGS84 untuk dibandingkan dengan ketinggian GARGeospatialTransform. Lihat GeoidEval yang memiliki antarmuka command line dan HTML. Maps API melaporkan lintang dan bujur sesuai dengan spesifikasi WGS84 secara default.
Anda dapat memperoleh lintang, bujur, dan ketinggian lokasi dari Google Earth. Hal 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 dekat dan jika Anda tidak berada di lereng yang curam, Anda mungkin dapat menggunakan ketinggian dari GARGeospatialTransform kamera tanpa menggunakan sumber lain, seperti Maps API.

Membuat anchor

Setelah Anda memiliki lintang, bujur, ketinggian, dan kuaternion rotasi, gunakan createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error: untuk menambatkan konten ke koordinat geografis yang Anda tentukan.

  NSError *error = nil;
  GARAnchor *anchor = [self.garSession createAnchorWithCoordinate:coordinate
                                                         altitude:altitude
                                               eastUpSouthQAnchor:eastUpSouthQAnchor
                                                            error:&error];

Angkur Medan

Anchor medan adalah jenis anchor yang memungkinkan Anda menempatkan objek AR hanya menggunakan lintang dan bujur, dengan memanfaatkan informasi dari VPS untuk menemukan ketinggian yang akurat di atas tanah.

Daripada memasukkan ketinggian yang diinginkan, Anda memberikan ketinggian di atas medan. Jika nol, anchor akan sejajar dengan medan.

Menetapkan mode penemuan pesawat

Penemuan bidang bersifat opsional dan tidak diperlukan untuk menggunakan anchor. Perhatikan bahwa hanya bidang horizontal yang digunakan. Bidang horizontal akan membantu penyelarasan dinamis anchor medan di tanah.

Gunakan ARWorldTrackingConfiguration.PlaneDetection untuk memilih cara aplikasi mendeteksi bidang.

Membuat anchor Terrain menggunakan Async API baru

Untuk membuat dan menempatkan anchor Terrain, panggil GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:.

Anchor tidak akan langsung siap dan perlu di-resolve. Setelah diselesaikan, GARCreateAnchorOnTerrainFuture akan tersedia.

GARCreateAnchorOnTerrainFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
                                                                altitudeAboveTerrain:altitude
                                                                  eastUpSouthQAnchor:eastUpSouthQTarget
                                                                   completionHandler:^(GARAnchor *anchor, GARTerrainAnchorState state) {
                                                                     // handle completion
                                                                   }
                                                                               error:&error];

Periksa Keadaan di Masa Depan

Future akan memiliki GARFutureState yang terkait.

Negara Bagian	Deskripsi
`GARFutureStatePending`	Operasi masih tertunda.
`GARFutureStateDone`	Operasi selesai dan hasilnya tersedia.
`GARFutureStateCancelled`	Operasi telah dibatalkan.

Memeriksa status anchor Medan dari hasil Future

GARTerrainAnchorState termasuk dalam operasi asinkron dan merupakan bagian dari hasil Future akhir.

switch (future.resultTerrainAnchorState) {
  case GARTerrainAnchorStateSuccess:
    // Terrain anchor finished resolving.
    break;
  case GARTerrainAnchorStateErrorUnsupportedLocation:
    // The requested anchor is in a location that isn't supported by the Geospatial API.
    break;
  case GARTerrainAnchorStateErrorNotAuthorized:
    // An error occurred while authorizing your app with the ARCore API. See
    // https://developers.google.com/ar/reference/ios/group/GARTerrainAnchorState#garterrainanchorstateerrornotauthorized
    // for troubleshooting steps.
    break;
  case GARTerrainAnchorStateErrorInternal:
    // The Terrain anchor could not be resolved due to an internal error.
    break;
  default:
    break;
}

Pengait Atap

Gambar Utama Rooftop Anchor

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 anchor Rooftop menggunakan Async API baru

Anchor tidak akan langsung siap dan perlu di-resolve.

Untuk membuat dan menempatkan anchor Atap, panggil GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:. Serupa dengan anchor Terrain, Anda juga akan mengakses GARFutureState Future. Kemudian, Anda dapat memeriksa Hasil Future untuk mengakses GARRooftopAnchorState.

GARCreateAnchorOnRooftopFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
                                                                altitudeAboveRooftop:altitude
                                                                  eastUpSouthQAnchor:eastUpSouthQTarget
                                                                   completionHandler:^(GARAnchor *anchor, GARRooftopAnchorState state) {
                                                                     // handle completion
                                                                   }
                                                                               error:&error];

Memeriksa Status Masa Depan

Future akan memiliki GARFutureState terkait, lihat tabel di atas.

Memeriksa status anchor Rooftop dari hasil Future

GARRooftopAnchorState milik operasi asinkron dan merupakan bagian dari hasil Future akhir.

switch (future.resultRooftopAnchorState) {
  case GARRooftopAnchorStateSuccess:
    // Rooftop anchor finished resolving.
    break;
  case GARRooftopAnchorStateErrorUnsupportedLocation:
    // The requested anchor is in a location that isn't supported by the Geospatial API.
    break;
  case GARRooftopAnchorStateErrorNotAuthorized:
    // An error occurred while authorizing your app with the ARCore API. See
    // https://developers.google.com/ar/reference/ios/group/GARRooftopAnchorState#garrooftopanchorstateerrornotauthorized
    // for troubleshooting steps.
    break;
  case GARRooftopAnchorStateErrorInternal:
    // The Rooftop anchor could not be resolved due to an internal error.
    break;
  default:
    break;
}

Langkah berikutnya

Pastikan Anda memahami kuota penggunaan API Geospatial.