iOS için Yerler SDK'sı kod örnekleri

Platform seçin: Android iOS JavaScript

iOS için Yerler SDK'sı ile birlikte sunulan GitHub'daki iOS için Yerler SDK'sı demo uygulaması, Yer Otomatik Tamamlama ve Yer Fotoğrafları dahil olmak üzere çeşitli özellikleri gösterir. Ayrıca, bu geliştirici kılavuzunun her sayfasında kod snippet'leri bulabilirsiniz. Uygulamayı içe aktarıp oluşturun, API anahtarınızı ekleyin, demoyu görüntüleyin ve uygulamanız için başlangıç noktası olarak sağlanan örnek kodu kullanın.

Örnek uygulamayı çalıştırdığınızda, kendi cihazınızda çalıştırabileceğiniz kullanılabilir örneklerin listesi gösterilir. Seçeneklerden birini belirleyin.

Tam örnek uygulamayı yerel olarak çalıştırma

iOS için Yerler SDK'sı örnek uygulaması, GitHub'dan indirilebilen bir arşiv olarak sunulmaktadır. iOS için Yerler SDK'sı örnek uygulamasını yüklemek ve denemek için aşağıdaki adımları uygulayın.

  1. GitHub'dan GitHub ve arşivi açın. Alternatif olarak, depoyu yerel bir dizine klonlayın: 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. Bir terminal penceresi açın, örnek dosyaları genişlettiğiniz dizine gidin ve kullanmak istediğiniz sürümün dizinine inin:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. Xcode projesinde File (Dosya) > Add Package Dependencies'e (Paket Bağımlılıkları Ekle) gidin. URL olarak https://github.com/googlemaps/ios-places-sdk adresini girin, paketi çekmek için Enter tuşuna basın ve Add Package'ı (Paket Ekle) tıklayın.
  4. Google Cloud Console projeniz için iOS için Yerler SDK'sını etkinleştirin.
  5. Places API ve/veya Places API (Yeni) etkinleştirilmiş projenizden API anahtarı alın.
  6. Aşağıdaki talimatları uygulayarak API anahtarınızı uygulamaya ekleyin.

    SwiftUI

    API anahtarınız için GooglePlacesDemos.xcconfig adlı yerel bir yapılandırma dosyası oluşturun. Bu dosyayı, demo uygulamasının Info.plist dosyasıyla (GooglePlacesDemos/GooglePlacesDemos) aynı dizine yerleştirin.

    API anahtarınızı tanımlamak için yapılandırma dosyanıza bir satır ekleyin:

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    YOUR_PLACES_API_KEY kısmını önceki adımlardaki API anahtarıyla değiştirin.

    Yerel yapılandırma dosyası oluşturma konusunda yardım için Yapılandırma ayarları dosyası (xcconfig) biçimi başlıklı makaleye bakın.

    Swift

    SDKDemoAPIKey dosyasını düzenleyin ve API anahtarınızı uygun sabite yapıştırın. Örneğin:

    let placesAPIKey = "YOUR_API_KEY"

    Varsa aşağıdaki satırı kaldırın:

    #error (Register for API Key and insert here. Then delete this line.)

    Xcode, düzenleme için SDKDemoAPIKey dosyasının kilidini açmanızı isterse Kilidi aç'ı seçin.

    Objective-C

    SDKDemoAPIKey dosyasını düzenleyin ve API anahtarınızı uygun sabite yapıştırın. Örneğin:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Varsa aşağıdaki satırı kaldırın

    #error (Register for API Key and insert here. Then delete this line.)

    Xcode, düzenleme için SDKDemoAPIKey dosyasının kilidini açmanızı isterse Kilidi aç'ı seçin.

  7. Uygulamayı oluşturun.
  8. İlk kez çalıştırdığınızda derleme başarısız olursa veya uygulama API anahtarınızla ilgili bir hatayla kilitlenirse yukarıdaki talimatlarda belirtilen gerekli anahtarları sağladığınızdan emin olun.
  9. Örnek uygulamayı çalıştırırsanız iOS simülatör penceresinde Yerler Demoları listesi gösterilir.
  10. Demo uygulamasının konumunuza erişmesine izin vermeniz istenirse İzin ver'i seçin.
  11. Seçtiğiniz örnek artık çalıştırılmaya hazır.