Panduan memulai geospasial untuk iOS

Panduan memulai untuk ARCore Geospatial API ini menunjukkan cara menjalankan aplikasi contoh di Xcode yang menunjukkan Geospatial API.

Untuk mendapatkan panduan mengembangkan aplikasi Anda sendiri dengan Geospatial API, lihat panduan developer Geospasial untuk iOS.

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

Jika Anda baru mengenal pengembangan dengan ARCore, lihat Memulai.

Prasyarat

  • Xcode versi 13.0 atau yang lebih baru
  • Cocoapods 1.4.0 atau yang lebih baru jika menggunakan Cocoapods
  • Perangkat Apple yang kompatibel dengan ARKit yang menjalankan iOS 12.0 atau yang lebih baru (target deployment iOS 12.0 atau yang lebih baru diperlukan)

Menyiapkan aplikasi contoh

Project GeospatialExample yang disertakan dengan ARCore SDK untuk iOS menjelaskan kode yang memanggil Geospatial API.

  1. Lakukan clone atau download ARCore SDK untuk iOS dari GitHub guna mendapatkan contoh kode aplikasi.

  2. Buka jendela Terminal atau Finder, lalu buka folder tempat Anda meng-clone atau mendownload SDK.

  3. Buka folder arcore-ios-sdk-master/Examples.

  4. Buka folder Examples, pilih folder GeospatialExample, lalu klik Open.

Menyiapkan Project Google Cloud

Untuk menggunakan Sistem Pemosisi Visual (VPS), aplikasi Anda harus dikaitkan dengan Project Google Cloud yang diaktifkan untuk ARCore API.

Anda harus mengaktifkan ARCore API di Project Google Cloud Anda. Jika Anda perlu membuat project, lakukan hal berikut:

  1. Buka Membuat project di Google Cloud Platform.

  2. Masukkan Project name yang sesuai, lalu pilih lokasi untuk project tersebut.

  3. Klik Create.

  4. Di sidebar, pilih API & Layanan, lalu Library.

  5. Telusuri ARCore API, pilih, lalu klik Enable.

Menyiapkan otorisasi

Untuk melakukan panggilan Geospatial API ke VPS, aplikasi contoh memerlukan otorisasi, dan dapat menggunakan kunci API yang tidak dibatasi. Jika menggunakan kunci API yang dibatasi, Anda juga harus menyediakan ID paket untuk dikaitkan dengan kunci API tersebut.

  1. Di Project Google Cloud Anda, dapatkan kunci API seperti yang dijelaskan dalam Membuat kunci API.

  2. Salin kunci API seperti yang akan Anda tempel di langkah selanjutnya.

  3. Di Xcode, di aplikasi contoh GeospatialExample, buka file ViewController.m dan telusuri your-api-key.

  4. Tambahkan kunci API Anda ke GARSession: tempelkan kunci API yang Anda salin dari langkah sebelumnya ke teks, your-api-key (tinggalkan tanda kutip), seperti yang ditunjukkan di bawah ini.

    self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                               bundleIdentifier:nil
                                          error:&error];

Menyiapkan ARCore SDK

Aplikasi GeospatialExample dilengkapi dengan Podfile yang telah dikonfigurasi sebelumnya dengan ARCore SDK dan versi iOS yang Anda perlukan. Untuk menginstal dependensi ini, buka jendela Terminal dan jalankan pod install dari folder tempat project Xcode berada.

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

Mem-build dan menjalankan aplikasi contoh

  1. Di Xcode, pilih file ruang kerja GeospatialExample, lalu klik Penandatanganan & Kemampuan.

  2. Centang kotak Kelola penandatanganan secara otomatis.

  3. Di kolom Tim, masukkan nama tim.

    Anda dapat menggunakan ID Paket default untuk menjalankan aplikasi dari Xcode, tetapi Anda harus mengubahnya jika menggunakan GeospatialExample sebagai stub untuk aplikasi Anda sendiri dalam produksi.

  4. Hubungkan perangkat Anda untuk menjalankan aplikasi contoh.

  5. Build dan jalankan aplikasi GeospatialExample dari file .xcworkspace untuk meluncurkannya di perangkat Anda.

    Untuk menghindari error build, pastikan Anda mem-build dari file .xcworkspace, bukan file .xcodeproj.

Anda akan dapat melihat tampilan kamera, beserta informasi debug yang menjelaskan transformasi Geospasial perangkat saat ini. Saat memindai lingkungan di sekitar Anda, perhatikan bahwa nilai keyakinan akurasi posisi dapat berubah saat Anda bergerak, jika Anda berada di area yang didukung oleh pelokalan VPS.

Jika ARCore yakin dengan lokasi dan arah perangkat, Anda dapat menempatkan Anchor di lokasi Anda saat ini menggunakan transformasi Geospasial.

Akurasi pemosisian mungkin terlalu rendah jika informasi VPS tidak tersedia. Aplikasi harus terhubung ke internet, dan lokasinya harus diketahui oleh VPS. Untuk hasil terbaik, jalankan aplikasi contoh di luar (bukan di dalam ruangan) saat siang hari.

Selain itu, jika Anda berada di area yang tidak mendukung VPS, atau jika sinyal GPS tidak memadai, Anda mungkin perlu menyesuaikan batas keyakinan di aplikasi untuk menempatkan anchor.

Untuk menyesuaikan ambang batas:

  1. Di Xcode, buka file ViewController.m dan cari bagian berikut:

    // Thresholds for 'good enough' accuracy. These can be tuned for the
// application. We use both 'low'
// and 'high' values here to avoid flickering state changes.
static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;

  2. Sesuaikan nilai ini sesuai kebutuhan. Semakin tinggi nilainya, semakin rendah akurasinya.

    Menurunkan akurasi memungkinkan aplikasi lintang lebih besar dalam menempatkan anchor. Lihat Menyesuaikan akurasi transformasi untuk mengetahui informasi selengkapnya.

Langkah berikutnya

Tinjau panduan developer Geospasial untuk iOS dan mulai membuat aplikasi dengan Geospatial API.