Panduan memulai geospasial untuk Android

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

Untuk panduan mengembangkan aplikasi Anda sendiri dengan Geospatial API, lihat Panduan developer geospasial untuk Android (Kotlin/Java) atau Panduan developer geospasial untuk Android NDK (C).

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

Jika Anda baru pertama kali melakukan pengembangan dengan ARCore, lihat Memulai.

Persyaratan

Dukungan perangkat

Lihat Perangkat yang didukung untuk daftar lengkap perangkat yang telah disertifikasi untuk bekerja dengan ARCore. Untuk Geospatial API, salah satu kunci hardware yang dibutuhkan adalah magnetometer yang memenuhi Geospatial API spesifikasi produk. Beberapa magnetometer tidak memenuhi spesifikasi ini; perangkat dengan magnetometer di luar spesifikasi tidak didukung.

Software

  • Versi terbaru Layanan Google Play untuk AR diinstal di perangkat yang didukung.

  • Android Studio versi 3.0 atau yang lebih baru dengan Android SDK Platform versi 7.0 (API level 24) atau yang lebih tinggi

  • ARCore SDK untuk Android, yang bisa Anda dapatkan dengan salah satu dari dua cara:

    • Download dari GitHub dan mengekstraknya di komputer Anda.

    • Clone repositori dengan perintah berikut: 

      git clone https://github.com/google-ar/arcore-android-sdk.git

Membuka dan menyiapkan aplikasi contoh

Project geospatial_java yang disertakan dengan ARCore SDK untuk Android menjelaskan kode yang memanggil Geospatial API.

  1. Di Android Studio, dari menu File, klik Open.

  2. Buka folder project untuk arcore-android-sdk.

  3. Buka folder samples, pilih folder geospatial_java, 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. Lihat Menggunakan ARCore API di Google Cloud untuk mengatur otorisasi. Anda dapat memilih otorisasi Keyless atau Kunci API.

Menjalankan aplikasi contoh

Di Android Studio, jalankan aplikasi contoh.

Anda seharusnya dapat melihat tampilan kamera, bersama dengan informasi debug yang menjelaskan pose Geospasial perangkat Anda saat ini. Saat Anda memindai lingkungan di sekitar Anda, perhatikan nilai keyakinan akurasi pemosisian dapat berubah saat Anda bergerak, jika Anda berada di area yang didukung oleh pelokalan VPS.

Setelah ARCore yakin dengan lokasi dan arah perangkat Anda, Anda dapat menempatkan Tetapkan jangkar di lokasi Anda saat ini menggunakan pose 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 Android Studio, buka GeospatialActivity, lalu cari bagian berikut:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

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

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

Langkah berikutnya