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

ARCore Geospatial API ile ilgili bu hızlı başlangıç kılavuzunda, Xcode'da Geospatial API'yi gösteren örnek bir uygulamanın nasıl çalıştırılacağı gösterilmektedir.

Geospatial API ile kendi uygulamanızı geliştirme rehberi için iOS 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.

Ön koşullar

  • Xcode 13.0 veya sonraki sürümler
  • Cocoapods kullanıyorsanız Cocoapods 1.4.0 veya üzeri
  • iOS 12.0 veya sonraki sürümleri çalıştıran ARKit uyumlu bir Apple cihaz (iOS 12.0 veya sonraki sürümlerin dağıtım hedefi gereklidir)

Örnek uygulamayı kurma

iOS için ARCore SDK'sına dahil edilen GeospatialExample projesi Geospatial API'yi çağıran kodu tanımlar.

  1. Şunu klonlayın veya indirin: GitHub'dan iOS için ARCore SDK'sı ifadesini girin.

  2. Bir Terminal veya Finder penceresi açın ve klonladığınız klasöre gidin SDK'yı indirin.

  3. arcore-ios-sdk-master/Examples klasörüne gidin.

  4. Örnekler klasörünü açın, GeospatialExample klasörünü seçin ve Aç'ı tıklayın.

Google Cloud projesi oluşturma

Uygulamanızda Görsel Konumlandırma Sistemi'ni (VPS) kullanmadan önce ARCore API'yi etkinleştirin . Geospatial API, Google'ın Hem Anahtarsız hem de API Anahtarı Yetkilendirmesi: Bu hızlı başlangıç kılavuzu için API'yi kullanın Anahtar yöntemi.

Yetkilendirme kurulumu

VPS'ye Geospatial API çağrıları yapmak için örnek uygulamanın yetkilendirmesi gerekir ve sınırsız bir API anahtarı kullanabilir. Kısıtlanmış bir API anahtarı kullanıyorsanız şunları da yapmalısınız: API anahtarıyla ilişkilendirilecek bir paket kimliği sağlayın.

  1. XCode'da, GeospatialExample örnek uygulamasında ViewController.m dosyasını açın. your-api-key araması yapın.

  2. API anahtarınızı GARSession içine ekleyin: metnin önceki adımında, your-api-key (tırnak işareti bırakın), gösteriliyor:

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

ARCore SDK'sını kurma

GeospatialExample uygulaması, önceden yapılandırılmış bir Podfile İhtiyacınız olan ARCore SDK ve iOS sürümleri. Bu bağımlılıkları yüklemek için Terminal penceresine açın ve Xcode projesinin bulunduğu klasörden pod install komutunu çalıştırın. gerekir.

Bu işlem, daha sonra.xcworkspace uygulamasını indirin.

Örnek uygulamayı derleyip çalıştırma

  1. Xcode'da GeospatialExample çalışma alanı dosyasını seçin ve İmza ve Yetenekler'i tıklayın.

  2. İmzalamayı otomatik olarak yönet kutusunu işaretleyin.

  3. Team (Ekip) alanına bir ekip adı girin.

    Uygulamayı Xcode'dan çalıştırmak için varsayılan Paket Tanımlayıcı'yı kullanabilirsiniz, ancak GeospatialExample öğesini kendi URL'niz için saplama olarak kullanıyorsanız oluşturmaya karar verdi.

  4. Örnek uygulamayı çalıştırmak için cihazınızı bağlayın.

  5. GeospatialExample uygulamasını .xcworkspace dosyasından derleyip çalıştırın ve cihazınızda başlatın.

    Yapı hatalarını önlemek için oluşturma işlemini .xcworkspace temel alınarak yaptığınızdan emin olun dosyasını değil, .xcodeproj dosyasını değil.

Kamera görünümünün yanı sıra uygulamanızı veya oyununuzu cihazınızın mevcut Coğrafi dönüşümü. Ortamı tararken Konumlandırma doğruluğu güven değerlerinin değişebileceğine dikkat edin. ve VPS yerelleştirmenin desteklendiği bir bölgedeyseniz başka yere gidin.

ARCore, cihazınızın konumundan ve yönünden emin olduktan sonra Coğrafi dönüşümü 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ı elde etmek için örnek uygulamayı gündüz saatlerinde dışarıda (içeride 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. Xcode'da ViewController.m dosyasını açın ve aşağıdakilere göz atın: bölüm:

    // 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. Bu değerleri ihtiyacınıza göre 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 Dönüşüm doğruluğu için ayarlama konulu videomuzu izleyin.

Sonraki adımlar

Şu göz atın: iOS için coğrafi geliştirici kılavuzu adresine gidin ve Geospatial API ile derlemelere başlayın.