Panduan memulai geospasial untuk iOS

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

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

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

Jika Anda baru menggunakan ARCore untuk pengembangan, 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 for iOS dari GitHub untuk mendapatkan kode aplikasi contoh.

  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

Sebelum menggunakan Sistem Pemosisi Visual (VPS) di aplikasi, Anda harus mengaktifkan ARCore API terlebih dahulu di project Google Cloud baru atau yang sudah ada. Meskipun Geospatial API berfungsi dengan otorisasi Kunci API dan Tanpa Kunci, untuk panduan memulai ini, gunakan metode Kunci API.

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 memberikan ID paket untuk dikaitkan dengan kunci API.

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

  2. Tambahkan kunci API ke GARSession: tempelkan kunci API yang Anda salin dari langkah sebelumnya di atas teks, kunci-api-Anda (biarkan tanda kutip), seperti yang ditunjukkan:

    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 akan Anda gunakan nanti untuk mem-build dan menjalankan aplikasi.

Mem-build dan menjalankan aplikasi contoh

  1. Di Xcode, pilih file ruang kerja GeospatialExample, lalu klik Signing & Capabilities.

  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 Anda saat ini. Saat Anda memindai lingkungan di sekitar Anda, perhatikan bahwa nilai keyakinan akurasi pemosisian 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 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 ruangan (bukan di dalam ruangan) selama jam-jam siang hari.

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

Untuk menyesuaikan nilai minimum:

  1. Di Xcode, buka file ViewController.m dan buka 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. Makin tinggi nilainya, makin rendah akurasinya.

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

Langkah berikutnya

Tinjau Panduan developer Geospatial untuk iOS dan mulai buat aplikasi dengan Geospatial API.