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 mengetahui informasi selengkapnya tentang Geospatial API.

Jika Anda baru mengenal pengembangan dengan ARCore, lihat Memulai.

Persyaratan

Dukungan perangkat

Lihat Perangkat yang didukung untuk melihat daftar lengkap perangkat yang telah disertifikasi agar berfungsi dengan ARCore. Untuk Geospatial API, salah satu hardware penting yang diperlukan adalah magnetometer yang memenuhi spesifikasi Geospatial API. Beberapa magnetometer tidak memenuhi spesifikasi; perangkat dengan magnetometer di luar spesifikasi ini tidak didukung.

Software

  • Versi terbaru Layanan Google Play untuk AR yang 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 berikut:

    • Download dari GitHub dan ekstrak di mesin 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 menyiapkan otorisasi. Anda dapat memilih otorisasi Tanpa Kunci atau Kunci API.

Menjalankan aplikasi contoh

Di Android Studio, jalankan aplikasi contoh.

Anda akan dapat melihat tampilan kamera, beserta informasi debug yang menjelaskan pose Geospasial perangkat Anda 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.

Setelah ARCore yakin dengan lokasi dan arah perangkat, Anda dapat menempatkan Anchor 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 (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 Android Studio, buka GeospatialActivity dan jelajahi 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 lintang lebih besar dalam menempatkan anchor. Lihat Menyesuaikan akurasi pose untuk informasi selengkapnya.

Langkah berikutnya