Mengaktifkan Geospatial API untuk aplikasi iOS Anda

Konfigurasikan setelan aplikasi Anda agar dapat menggunakan Geospatial API.

Prasyarat

Pastikan Anda memahami konsep AR dasar dan cara mengonfigurasi sesi ARCore sebelum melanjutkan.

Jika Anda ingin menjalankan aplikasi contoh yang mendemonstrasikan fungsi yang dijelaskan di sini, lihat panduan memulai Geospasial ARCore untuk iOS.

Lihat Pengantar Geospatial API untuk mengetahui informasi selengkapnya tentang Geospatial API.

Jika Anda baru mengenal pengembangan dengan ARCore, lihat Memulai untuk mengetahui informasi tentang persyaratan software dan hardware, prasyarat, dan informasi lain khusus untuk platform yang Anda gunakan.

Mengaktifkan ARCore API

Sebelum menggunakan Sistem Pemosisi Visual (VPS) di aplikasi, Anda harus mengaktifkan ARCore API terlebih dahulu di project Google Cloud yang baru atau yang sudah ada. Layanan ini bertanggung jawab untuk menghosting, menyimpan, dan menyelesaikan anchor Geospasial.

Otorisasi tanpa kunci lebih diutamakan, tetapi otorisasi Kunci API juga didukung.

Menambahkan library yang diperlukan ke aplikasi

Setelah memberi aplikasi otorisasi untuk memanggil ARCore API, Anda harus menambahkan library untuk mengaktifkan fitur Geospatial di aplikasi.

Update Podfile untuk aplikasi Anda agar menyertakan ARCore SDK dan pembuatan versi iOS yang didukung. Untuk melakukannya:

  1. Tambahkan platform dan pod berikut ke Podfile project Anda:

    platform :ios, '11.0'
pod 'ARCore/Geospatial', '~> 1.41.0'

    Anda juga dapat menentukan platform :ios, '10.0', jika ingin mendukung iOS 10, tetapi perhatikan bahwa Geospatial API hanya akan berfungsi saat runtime di iOS >= 11.

  2. Buka jendela Terminal dan jalankan pod install dari folder tempat project Xcode Anda berada.

    Tindakan ini akan menghasilkan file .xcworkspace yang Anda gunakan untuk membangun dan menjalankan aplikasi.

Pastikan lingkungan pengembangan Anda memenuhi persyaratan ARCore SDK, seperti yang dijelaskan dalam Panduan Memulai.

Mengaktifkan kemampuan Geospasial di konfigurasi sesi

Periksa kompatibilitas perangkat

Tidak semua perangkat yang mendukung ARCore juga mendukung Geospatial API, seperti yang dijelaskan dalam quickstart.

Gunakan GARSession.isGeospatialModeSupported: untuk memeriksa perangkat, seperti berikut:

if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
  [self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
  return;
}

GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
  [self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
                                                  (int)error.code]];
  return;
}

Meminta izin akses lokasi kepada pengguna saat runtime

Aplikasi Anda harus meminta izin akses lokasi berikut saat runtime, sebelum mengonfigurasi sesi:

Memeriksa ketersediaan Geospasial di lokasi perangkat saat ini

Karena Geospatial API menggunakan kombinasi VPS dan GPS untuk menentukan transformasi Geospatial, API dapat digunakan selama perangkat dapat menentukan lokasinya. Di area dengan akurasi GPS yang rendah, seperti ruang dalam ruangan dan lingkungan perkotaan yang padat, API akan mengandalkan cakupan VPS untuk menghasilkan transformasi akurasi tinggi. Dalam kondisi umum, VPS dapat diharapkan untuk memberikan akurasi posisi sekitar 5 meter, dan akurasi rotasi 5 derajat. Gunakan GARSession.checkVPSAvailabilityAtCoordinate:completionHandler: untuk menentukan apakah lokasi tertentu memiliki 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 menghasilkan transformasi dengan akurasi tinggi.

Langkah selanjutnya