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 geospasial untuk iOS.

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

Jika Anda baru pertama kali melakukan 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 for iOS dari GitHub untuk mendapatkan kode aplikasi contoh.

  2. Buka jendela Terminal atau Finder dan navigasikan ke folder tempat Anda meng-clone atau mendownload SDK.

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

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

Menyiapkan Project Google Cloud

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

Menyiapkan otorisasi

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

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

  2. Tambahkan kunci API Anda ke GARSession: tempel kunci API yang Anda salin dari langkah sebelumnya di atas teks, your-api-key (biarkan tanda kutip), sebagai ditampilkan:

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

Menyiapkan ARCore SDK

Aplikasi GeospatialExample dikirimkan 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 sudah ada.

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

Mem-build dan menjalankan aplikasi contoh

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

  2. Centang kotak Kelola penandatanganan secara otomatis.

  3. Di kolom Team, masukkan nama tim.

    Anda dapat menggunakan Bundle Identifier default untuk menjalankan aplikasi dari Xcode, tetapi Anda harus mengubahnya jika menggunakan GeospatialExample sebagai stub untuk aplikasi Anda dalam lingkungan production.

  4. Hubungkan perangkat Anda untuk menjalankan aplikasi contoh.

  5. Bangun dan jalankan aplikasi GeospatialExample dari file .xcworkspace ke meluncurkannya di perangkat Anda.

    Untuk menghindari error build, pastikan Anda membangun dari .xcworkspace dan bukan file .xcodeproj.

Anda seharusnya dapat melihat tampilan kamera, bersama dengan 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 berpindah-pindah, jika Anda berada di area yang didukung oleh pelokalan VPS.

Setelah ARCore yakin dengan lokasi dan arah perangkat Anda, Anda dapat menempatkan Tetapkan 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 ruangan (bukan di dalam ruangan) selama jam-jam siang hari.

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

Untuk menyesuaikan ambang batas:

  1. Di Xcode, buka file ViewController.m lalu buka file 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 menggunakan lintang yang lebih besar dalam menempatkan anchor. Lihat Melakukan penyesuaian untuk akurasi transformasi untuk informasi selengkapnya.

Langkah berikutnya

Ulas Panduan developer geospasial untuk iOS dan mulai membangun dengan Geospatial API.