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

Bu ARCore Geospatial API hızlı başlangıç kılavuzu, örnek bir uygulamayı nasıl çalıştıracağınızı gösterir Geospatial API'yi görüntüleyebilirsiniz.

Geospatial API ile kendi uygulamanızı geliştirme rehberi için Android için coğrafi geliştirici kılavuzu (Kotlin/Java) veya Android NDK (C) için coğrafi geliştirici kılavuzu.

Bkz. Daha fazla bilgi için ARCore Geospatial API'ye giriş hakkında daha fazla bilgi edinin.

ARCore ile geliştirme konusunda yeniyseniz Başlarken bölümüne bakın.

Şartlar

Cihaz desteği

Aşağıdaki özelliklere sahip cihazların tam listesi için Desteklenen cihazlar bölümüne bakın: ARCore ile çalışma sertifikasına sahiptir. Geospatial API için gereken temel donanımlardan biri, Geospatial API özelliklerini karşılayan bir manyetometredir. Bazı manyetometreler spesifikasyonu karşılamıyor. Bu spesifikasyon dışı manyetometrelere sahip cihazlar desteklenmez.

Yazılım

  • Şu uygulamanın en son sürümü: AR için Google Play Hizmetleri Desteklenen cihazda yüklü olmalıdır.

  • Android Studio 3.0 veya sonraki sürümler Android SDK Platform 7.0 (API düzeyi 24) veya sonraki sürümleriyle

  • Aşağıdaki iki yöntemden birini kullanarak edinebileceğiniz Android için ARCore SDK'sı:

    • GitHub'dan indirip makinenizde açın.

    • Aşağıdaki komutla depoyu klonlayın: 

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

Örnek uygulamayı açıp kurun

Android için ARCore SDK'sına dahil edilen geospatial_java projesi, Geospatial API'yi çağıran kodu açıklar.

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

  2. arcore-android-sdk için 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 için uygulamanızın ARCore API için etkinleştirilmiş bir Google Cloud projesi. Görüntüleyin Google Cloud'da ARCore API'yi kullanma tıklayın. Anahtarsız veya API Anahtarı Yetkilendirmesini seçebilirsiniz.

Örnek uygulamayı çalıştırma

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

Kamera görünümünün yanı sıra uygulamanızı veya oyununuzu cihazınızın o anki coğrafi duruşunu gösterin. Etrafınızdaki ortamı tararken, VPS yerelleştirmesinin desteklediği bir bölgedeyseniz hareket ettikç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 olduktan sonra Coğrafi pozu kullanarak mevcut konumunuza sabitleyin.

VPS bilgileri mevcut değilse konumlandırma doğruluğu çok düşük olabilir. İlgili içeriği oluşturmak için kullanılan Uygulama internete bağlı olmalı ve konum VPS tarafından bilinmelidir. En iyi sonuçlar için örnek uygulamayı gündüz saatlerinde açık havada (iç mekanda değil) çalıştırın.

Ayrıca, VPS'nin desteklenmediği bir yerdeyseniz ya da GPS sinyalleri desteklenmiyorsa Bunun için uygulamada güven eşiklerini ayarlamanız gerekebilir. kullanabilirsiniz.

Eşikleri ayarlamak için:

  1. Android Studio'da GeospatialActivity'yi açın ve şu bölümden

    // 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 şekilde ayarlayın. Değer yükseldikçe doğruluk düşük olur.

    Doğruluğun azaltılması, uygulamaya bir çapa yerleştirilmesi için daha fazla enlem oluşturulmasına olanak tanır. Görüntüleyin Poz doğruluğu için ayarlama konulu videomuzu izleyin.

Sonraki adımlar