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ğını gösterilmektedir.

Geospatial API ile kendi uygulamanızı geliştirmeyle ilgili kılavuz için iOS için Geospatial geliştirici kılavuzu başlıklı makaleyi inceleyin.

Geospatial API hakkında daha fazla bilgi için ARCore Geospatial API'ye Giriş başlıklı makaleyi inceleyin.

ARCore ile geliştirme yapmaya yeni başladıysanız Başlangıç 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 sonraki sürümler
  • 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ı ayarlama

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

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

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

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

  4. Examples 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 yeni veya mevcut bir Google Cloud projesinde ARCore API'yi etkinleştirmeniz gerekir. Geospatial API hem anahtarsız hem de API anahtarı yetkilendirmesiyle çalışır ancak bu hızlı başlangıç kılavuzunda API anahtarı yöntemini kullanın.

Yetkilendirme kurulumu

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

  1. XCode'ta GeospatialExample örnek uygulamasında ViewController.m dosyasını açın ve api-anahtarınız ifadesini arayın.

  2. API anahtarınızı GARSession alanına ekleyin: Önceki bir adımdan kopyaladığınız API anahtarını metnin üzerine yapıştırın (tırnak işaretlerini kaldırın), api-anahtarınız:

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

ARCore SDK'sını ayarlama

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

Bu işlem, daha sonra uygulamayı derlemek ve çalıştırmak için kullanacağınız bir .xcworkspace dosyası oluşturur.

Ö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. İmza işlemini 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 GeospatialExample'ı üretimdeki kendi uygulamanız için bir taslak olarak kullanıyorsanız bunu değiştirmeniz gerekir.

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

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

    Derleme hatalarını önlemek için .xcodeproj dosyasından değil, .xcworkspace dosyasından derlediğinizden emin olun.

Cihazınızın mevcut coğrafi dönüşümünü açıklayan hata ayıklama bilgilerinin yanı sıra bir kamera görünümü görebilirsiniz. Etrafınızdaki ortamı tararken, VPS yerelleştirmesi tarafından desteklenen 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 konumu ve yönüyle ilgili güvenilir bilgilere sahip olduğunda Coğrafi Dönüşüm'ü kullanarak mevcut konumunuza bir ankraj yerleştirebilirsiniz.

VPS bilgileri kullanılamıyorsa konumlandırma doğruluğu çok düşük olabilir. Uygulamanın internete bağlı olması ve konumun VPS tarafından bilinmesi gerekir. 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'yi desteklemeyen bir bölgedeyseniz veya GPS sinyalleri yeterli değilse ankraj yerleştirmek için uygulamadaki 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 şekilde ayarlayın. Değer ne kadar yüksek olursa doğruluk o kadar düşük olur.

    Doğruluğu düşürmek, uygulamanın ankraj yerleştirme konusunda daha fazla özgürlük tanır. Daha fazla bilgi için Dönüşüm doğruluğu için ayarlama başlıklı makaleyi inceleyin.

Sonraki adımlar

iOS için Coğrafi Geliştirici Kılavuzu'nu inceleyin ve Geospatial API ile uygulama geliştirmeye başlayın.