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

ARCore Geospatial API için bu hızlı başlangıç kılavuzu, Xcode'da Geospatial API'yi gösteren örnek bir uygulamayı nasıl çalıştıracağınızı gösterir.

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

Ön koşullar

  • Xcode 13.0 veya sonraki bir sürüm
  • 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 açıklar.

  1. Örnek uygulama kodunu edinmek üzere GitHub'dan iOS için ARCore SDK'sını klonlayın veya indirin.

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

  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ş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.

Google Cloud Projenizde ARCore API'yi etkinleştirmeniz gerekir. Projeyi oluşturmanız gerekiyorsa aşağıdakileri yapın:

  1. Create a project in Google Cloud Platform (Google Cloud Platform'da proje oluşturma) bölümünü ziyaret edin.

  2. Uygun bir Proje adı girin ve proje için bir konum seçin.

  3. Oluştur'u tıklayın.

  4. Kenar çubuğundan API'ler ve Hizmetler'i ve ardından Kitaplık'ı seçin.

  5. ARCore API'yi arayın, seçin ve Etkinleştir'i tıklayın.

Yetkilendirme kurulumu

VPS'ye Geospatial API çağrıları yapmak için örnek uygulamanın yetkilendirmesi gerekir ve kısıtlanmamış bir API anahtarı kullanabilir. Kısıtlanmış API anahtarı kullanıyorsanız API anahtarıyla ilişkilendirmek için bir paket kimliği de sağlamanız gerekir.

  1. Google Cloud Projenizde, API anahtarı oluşturma bölümünde açıklandığı şekilde bir API anahtarı edinin.

  2. API anahtarını daha sonraki bir adımda yapıştıracağınız şekilde kopyalayın.

  3. Xcode'da, GeospatialExample örnek uygulamasında ViewController.m dosyasını açın ve your-api-key ifadesini arayın.

  4. API anahtarınızı GARSession öğesine ekleyin: Önceki adımdan kopyaladığınız API anahtarını, aşağıda gösterildiği gibi your-api-key (tırnak işaretlerini bırakın) metninin üzerine yapıştırın.

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

ARCore SDK'sını ayarlama

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

Bu işlemden sonra uygulamayı oluşturmak ve çalıştırmak için daha sonra kullanacağınız bir .xcworkspace dosyası oluşturulur.

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

  1. Xcode'da GeospatialExample çalışma alanı dosyasını seçin ve Signing & Capabilities'i tıklayın.

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

  3. Ekip alanına bir ekip adı girin.

    Uygulamayı Xcode'dan çalıştırmak için varsayılan Paket Tanımlayıcısı'nı kullanabilirsiniz, ancak üretimde kendi uygulamanızın saplaması olarak GeospatialExample'i kullanırsanız bunu değiştirmeniz gerekir.

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

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

    Derleme hatalarını önlemek için .xcodeproj dosyasından değil .xcworkspace dosyasından derleme yaptığınızdan emin olun.

Cihazınızın geçerli Coğrafi dönüşümünü 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 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 dönüşümü 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. Xcode'da ViewController.m dosyasını açın ve aşağıdaki bölüme gidin:

    // 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 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 Dönüşüm doğruluğu için ayarlama bölümüne bakın.

Sonraki adımlar

iOS için Geospatial geliştirici kılavuzunu inceleyin ve Geospatial API ile uygulama geliştirmeye başlayın.