Android için coğrafi hızlı başlangıç kılavuzu

ARCore Geospatial API için bu hızlı başlangıç kılavuzu, Geospatial API'yi gösteren örnek bir uygulamanın Android Studio'da nasıl çalıştırılacağını gösterir.

Geospatial API ile kendi uygulamanızı geliştirme kılavuzu için Android için Geospatial geliştirici kılavuzu (Kotlin/Java) veya Android NDK (C) için Geospatial geliştirici kılavuzu'na bakın.

Geospatial API hakkında daha fazla bilgi için ARCore Geospatial API'ye Giriş bölümüne bakın.

ARCore ile uygulama geliştirmede yeniyseniz Başlarken bölümünü inceleyin.

Koşullar

Cihaz desteği

ARCore ile çalıştığı onaylanmış cihazların tam listesi için Desteklenen cihazlar bölümüne bakın. Geospatial API için gereken temel donanım parçalarından biri Geospatial API spesifikasyonlarını karşılayan bir manyetometredir. Bazı manyetometreler spesifikasyonları karşılamaz. Bu spesifikasyonlara uygun olmayan manyetometrelere sahip cihazlar desteklenmez.

Yazılım

  • Desteklenen cihazda AR için Google Play Hizmetleri'nin son sürümünün yüklü olması.

  • Android Studio için Android SDK Platformu 7.0 (API düzeyi 24) veya üzeri sürüm 3.0 veya üzeri

  • Android için ARCore SDK'sını iki şekilde edinebilirsiniz:

    • GitHub'dan indirip makinenize çıkarın.

    • Aşağıdaki komutla kod deposunu klonlayın: 

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

Örnek uygulamayı açma ve kurma

Android için ARCore SDK'sına dahil edilen geospatial_java projesinde Geospatial API'yi çağıran kod açıklanmaktadır.

  1. Android Studio'da, Dosya menüsünden Aç'ı tıklayın.

  2. arcore-android-sdk proje klasörüne gidin.

  3. samples klasörünü açın, geospatial_java klasörünü seçin ve Aç'ı tıklayın.

Google Cloud projesi oluşturun

Görsel Konumlandırma Sistemi'ni (VPS) kullanmak istiyorsanız uygulamanızın ARCore API için etkinleştirilmiş bir Google Cloud projesiyle ilişkilendirilmiş olması gerekir. Yetkilendirmeyi ayarlamak için Google Cloud'da ARCore API'yi kullanma başlıklı makaleyi inceleyin. Anahtarsız veya API Anahtarı yetkilendirmesi seçeneklerinden birini belirleyebilirsiniz.

Örnek uygulamayı çalıştırma

Android Studio'da örnek uygulamayı çalıştırın.

Cihazınızın geçerli Coğrafi pozisyonunu açıklayan hata ayıklama bilgileriyle birlikte kamera görünümünü görebilmeniz gerekir. Etrafınızdaki ortamı tararken VPS yerelleştirmesinin desteklediği bir alandaysanız siz etrafta gezindikçe konumlandırma doğruluğu güven değerlerinin değişebileceğini unutmayın.

ARCore, cihazınızın konumundan ve yönünden emin olduğunda, Coğrafi pozisyonu kullanarak mevcut konumunuza bir Sabitleme yerleştirebilirsiniz.

VPS bilgisi mevcut değilse konumlandırma doğruluğu çok düşük olabilir. Uygulama internete bağlı olmalı ve VPS konumu biliyor olmalıdır. En iyi sonuçlar için örnek uygulamayı gündüz saatlerinde dışarıda (iç mekanda değil) çalıştırın.

Ayrıca, VPS'yi desteklemeyen bir alandaysanız veya GPS sinyalleri yeterli değilse çapa yerleştirmek için uygulamada güven eşiklerini ayarlamanız gerekebilir.

Eşikleri ayarlamak için:

  1. Android Studio'da GeospatialActivity'yi açın ve aşağıdaki bölüme göz atın:

    // 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. Bu değerleri gerektiği gibi ayarlayın. Değer ne kadar yüksek olursa doğruluk da düşüktür.

    Doğruluğu azaltmak, uygulamanın çapa yerleştirmede daha fazla enlem elde etmesini sağlar. Daha fazla bilgi için Poz doğruluğu için ayarlama konusuna bakın.

Sonraki adımlar