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

iOS için Yerler SDK'sı ile birlikte sağlanan GitHub'daki iOS için Yerler SDK'sı demo uygulaması, Yer Adı 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ı ve iOS için Haritalar 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 anahtarlarınızı tanımlamak için yapılandırma dosyanıza iki satır ekleyin:

   PLACES_API_KEY = YOUR_PLACES_API_KEY ve MAPS_API_KEY = YOUR_MAPS_API_KEY.

   YOUR_PLACES_API_KEY ve YOUR_MAPS_API_KEY yerine önceki adımlardaki API anahtarlarını girin.

   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. Derleme başarısız olursa veya uygulama ilk kez çalıştırıldığında API anahtarınızla ilgili bir hatayla çökerse 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.