Uygulamanızda kullanılabilen iOS için Yerler SDK'sı özellikleri, paket bağımlılıklarınızda belirttiğiniz SDK sürüm numarasının (ör. 9.0.0) ve API anahtarınızda etkinleştirilen API'lerin bir kombinasyonuyla belirlenir. Bu kılavuzda, sürümler arasındaki farklar ve uygulamanızda hangi sürümlerin etkinleştirileceğini seçme hakkında bilgi verilmektedir.
SDK sürüm numaraları
Paket bağımlılıklarınızda belirttiğiniz SDK'nın sürüm numarası, uygulamanızın belirli bir sürüme eklenen özelliklere erişip erişemeyeceğini belirler. Örneğin, Otomatik Tamamlama (Yeni) yalnızca SDK 9.0.0 veya sonraki sürümlerde kullanılabilir.
Her SDK sürümünde yapılan değişiklikler hakkında daha fazla bilgi için iOS için Yerler SDK'sı sürüm notlarına bakın.
iOS için Yerler SDK'sı'nın desteklediği Yerler API'si sürümleri
Bir SDK sürüm numarası belirtmenin yanı sıra, SDK'nın Google Cloud Console'da çağırdığı Places API hizmetini de seçmeniz gerekir: Places API veya Places API (Yeni). Seçtiğiniz API hizmeti, SDK sürüm numarasıyla birlikte uygulamanızda hangi özelliklerin (ör. Otomatik Tamamlama veya Otomatik Tamamlama (Yeni)) hangi sürümlerinin kullanılabileceğini belirler. Yalnızca bir SDK sürüm numarası belirtebilseniz de API anahtarınızda aynı anda hem Places API'yi hem de Places API'yi (Yeni) etkinleştirebilirsiniz. Ancak çoğu durumda, Places API'yi (Yeni) etkinleştirmek ve uygulamanızda SDK özelliklerinin (Yeni) sürümlerini kullanmak istersiniz.
SDK sürümünüzü ve API hizmetlerinizi seçme
Uygulamanızda kullanılabilecek SDK özelliklerini seçmek için aşağıdakileri yapın:
- Google Cloud projenizde Places API'yi, Places API (Yeni)'yi veya ikisini birden etkinleştirin. Daha fazla bilgi için API'leri etkinleştirme başlıklı makaleyi inceleyin.
- API anahtarı kısıtlamalarınızda Places API'yi, Places API (Yeni)'yi veya ikisini birden etkinleştirin. Daha fazla bilgi için API anahtarlarını kısıtlama başlıklı makaleyi inceleyin.
- SDK'yı yüklerken sürüm numarasını belirtin. Daha fazla bilgi için Xcode projesi oluşturma başlıklı makaleyi inceleyin.
Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama başlıklı makaleye bakın.
Her sürümde kullanılabilen SDK özellikleri
Aşağıdaki tabloda, her SDK özelliği için hangi SDK ve API sürümlerinin gerekli olduğu gösterilmektedir:
| iOS için Yerler SDK'sı (Yeni) | Minimum SDK sürümü | iOS için Yerler SDK'sı | Minimum SDK sürümü |
|---|---|---|---|
| Yer Ayrıntıları (Yeni) | 9.0.0 | Yer Ayrıntıları | 3.0.0 |
| Yer Fotoğrafı (Yeni) | 9.0.0 | Yer Fotoğrafı | 3.0.0 |
| Metin Arama (Yeni) | 8.5.0 | ||
| Yakında Arama (Yeni) | 9.0.0 | ||
| Otomatik tamamlama (Yeni) | 9.0.0 | Otomatik tamamlama | 3.0.0 |
| Mevcut Yer | 3.0.0 |
Hangi sürümlerin etkinleştirileceğini seçerken dikkat edilmesi gerekenler
- iOS için Yerler SDK'sını kullanmaya yeni başlayan bir müşteriyseniz Yerler API'sini (Yeni) ve yeni SDK'yı kullanmaya başlayın.
- Mevcut bir müşteriyseniz mevcut SDK'yı kullanmaya devam edebilirsiniz. Ancak iOS için Yerler SDK'sının (Yeni) performans iyileştirmelerinden ve özellik geliştirmelerinden yararlanmak istiyorsanız Yerler API'sini (Yeni) etkinleştirmeniz ve yeni SDK'yı kullanmanız gerekir. Yeni SDK'ya geçiş yaparken taşıma işlemi gerekmez. SDK sürümünüzü ve API hizmetlerinizi seçme bölümündeki adımları uygulamanız yeterlidir.
- Places API (Yeni), Mevcut Yer,
GMSPlace.isOpenveGMSPlace.isOpenAtDategibi bazı mevcut özellikleri etkinleştirmez.
iOS için Yerler Swift SDK'sını kullanma (Önizleme)
iOS için Yerler Swift SDK'sını (Önizleme) kullanmak üzere aşağıdaki adımlar gereklidir:
- Places API'yi (Yeni) etkinleştirin.
- iOS için Yerler Swift SDK'sını (Önizleme) bağımlılıklarınıza ekleyin.
- Yerler istemcisini
PlacesClientile başlatın.
iOS için Places Swift SDK'sı (Önizleme) hakkında daha fazla bilgi edinmek isterseniz genel bakış veya taşıma kılavuzunu inceleyin.
Yeni API'lere geçiş
Mevcut bir API kullanıyorsanız ve yeni API'ye geçmek istiyorsanız her API için aşağıdaki taşıma kılavuzlarına bakın:
iOS için Yerler SDK'sındaki geliştirmeler (Yeni)
Bu bölümde, iOS için Yerler SDK'sına (Yeni) eklenen temel özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulanır.
iOS için Yerler SDK'sı (Yeni), Google Cloud'daki hizmet altyapısında uygulanır. Bu uygulama, daha güvenli ve güvenilir bir platform sağlar. Bu standart tasarım, SDK'lar arasında iOS için Yerler SDK'sı (Yeni) ile geliştirme verimliliğini artıran bir tutarlılık düzeyi sağlar.
Artırılmış performans
iOS için Yerler SDK'sı (Yeni), mevcut SDK'yı kullanan uygulamaların değiştirilmesini değerli kılan iyileştirilmiş bir performans sunar.
Yeni özellikler
iOS için Yerler SDK'sı (Yeni), tüm SDK özelliklerinin en son sürümlerini içerir:
- Otomatik tamamlama (Yeni)
- Yer Ayrıntıları (Yeni)
- Yakında Arama (Yeni)
- Yer Fotoğrafları (Yeni)
- Metin Arama (Yeni)
Basitleştirilmiş fiyatlandırma
iOS için Yerler SDK'sı (Yeni) ile fiyatlandırma basitleştirilmiştir. Böylece, yalnızca kullandığınız veriler için ödeme yaparsınız. Basitleştirilmiş fiyatlandırma, alan maskeleri olarak da bilinen alan listeleri kullanılarak uygulanır.
iOS için Yerler SDK'sı ve metin aramada, yanıtta döndürülecek alan listesini kontrol etmek için alan listelerini kullanırsınız. Bu durumda, yalnızca istenen veriler için faturalandırılırsınız. Gereksiz veri istemediğinizden emin olmak için alan listesi kullanmak iyi bir tasarım uygulamasıdır. Bu, gereksiz işlem süresini ve faturalandırma ücretlerini önlemeye yardımcı olur.
Her iki SDK için ayrıntılı fiyatlandırma bilgileri için Kullanım ve Faturalandırma bölümüne bakın.
Genişletilmiş yer türleri
Yeni SDK, aşağıdaki tabloda gösterilen yer türlerini ekler. Bu türler, Yer Ayrıntıları ve Metin Arama yanıtının bir parçası olarak döndürülür. Bu yeni türleri ve mevcut türleri Metin Arama ile yapılan bir aramada da kullanabilirsiniz. Yeni türler Tablo A'ya dahil edilir.
| Tür | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | çiftlik | korean_restaurant | sporting_goods_store |
| barber_shop | çiftlik evi | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | market | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | terzi |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | motel | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| danışman | helikopter pisti | oyun alanı | vegetarian_restaurant |
| convention_center | hiking_area | okul öncesi kurum | vietnamese_restaurant |
| kır evi | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | pansiyon | resort_hotel | toptancı |
| dental_clinic | otel | rest_stop |
Bu yeni türlerin yanı sıra Places API (Yeni), aşağıdaki türleri Places API'nin 2. Tablosu'ndan Places API (Yeni) için A Tablosu'na taşıdı. Bu sayede artık aşağıdaki türleri bir aramanın parçası olarak kullanabilirsiniz:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality