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ı (ör. 9.0.0) ve API anahtarınızda etkinleştirilen API'lerin bir kombinasyonuna göre belirlenir. Bu kılavuzda, sürümler arasındaki farklar ve uygulamanızda etkinleştirilecek sürümlerin nasıl seçileceği açıklanmaktadır.
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ümde eklenen özelliklere erişimi olup olmadığını belirler. Örneğin, Otomatik Tamamlama (Yeni) yalnızca SDK 9.0.0 veya sonraki sürümlerde kullanılabilir.
Her bir 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ı için Yerler API'si sürümleri
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)) kullanılabileceğini belirler. Yalnızca bir SDK sürüm numarası belirtebilirsiniz, ancak API anahtarınızda hem Places API'yi hem de Places API'yi (Yeni) aynı anda etkinleştirebilirsiniz. Ancak çoğu durumda, Places API'yi (Yeni) etkinleştirmek ve uygulamanızdaki SDK özelliklerinin (Yeni) sürümlerini kullanmak istersiniz.
SDK sürümünüzü ve API hizmetlerinizi seçin
Uygulamanızda hangi SDK özelliklerinin kullanılabildiğini seçmek için aşağıdakileri yapın:
- Google Cloud projenizde Places API, Places API (Yeni) veya her ikisini de etkinleştirin. Daha fazla bilgi için API'leri etkinleştirme bölümüne bakın.
- API anahtarı kısıtlamalarınızda Places API, Places API (Yeni) veya her ikisini de etkinleştirin. Daha fazla bilgi için API anahtarlarını kısıtlama bölümüne bakın.
- SDK'yı yüklerken sürüm numarasını belirtin. Daha fazla bilgi için Xcode projesi oluşturma bölümüne bakın.
Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi oluşturma bölümüne bakın.
Her sürümde kullanılabilen SDK özellikleri
Aşağıdaki tabloda, her bir SDK özelliği için hangi SDK ve API sürümlerinin gerektiği gösterilmektedir:
Öne Çıkarın | API anahtarında Places API etkinleştirildi | Minimum SDK sürümü |
---|---|---|
Otomatik tamamlama (Yeni) | Places API (Yeni) | 9.0.0 |
Yer Ayrıntıları (Yeni) | Places API (Yeni) | 9.0.0 |
Yakında Arama (Yeni) | Places API (Yeni) | 9.0.0 |
Yer Fotoğrafları (Yeni) | Places API (Yeni) | 9.0.0 |
Metin Arama (Yeni) | Places API (Yeni) | 8.5.0 |
Otomatik Yer Tamamlama | Places API | 3.0.0 |
Mevcut Yer | Places API | 3.0.0 |
Yer Ayrıntıları | Places API | 3.0.0 |
Yer Fotoğrafları | Places API | 3.0.0 |
Etkinleştirilecek sürümleri seçerken dikkate alınması gereken noktalar
- iOS için Yerler SDK'sını kullanmaya yeni başlayan yeni bir müşteriyseniz Places API (Yeni) ve yeni SDK ile 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 için Places API'yi (Yeni) etkinleştirmeniz ve yeni SDK'yı kullanmanız gerekir. Yeni SDK'ya geçiş yapmak için taşıma işlemi gerekmez. SDK sürümünüzü ve API hizmetlerinizi seçin bölümündeki adımları uygulamanız yeterlidir.
- Places API (Yeni) Geçerli Yer,
GMSPlace.isOpen
veGMSPlaceisOpenAtDate
gibi bazı mevcut özellikleri etkinleştirmez.
GooglePlacesSwift Önizleme sürümünü kullanma
GooglePlacesSwift'i kullanmak için aşağıdaki adımlar gereklidir:
- Places API'yi (Yeni) etkinleştirin.
- Bağımlılıklarınıza GooglePlacesSwiftSDK kodunu ekleyin.
- Yerler istemcisini
PlacesClient
ile başlatın.
GooglePlacesSwift hakkında daha fazla bilgi edinmek için referans belgeleri inceleyin.
Yeni API'lere geçiş yapın
Mevcut bir API'yi kullanıyor ve yeni API'ye geçmek istiyorsanız her API için aşağıdaki taşıma rehberlerini inceleyin:
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 uygulanmıştır. Bu uygulama, daha güvenli ve güvenilir bir platform sağlıyor. Bu standart tasarım, iOS için Yerler SDK'sı (Yeni) ile geliştirmenin verimliliğini artıran SDK'lar arasında belirli bir düzeyde tutarlılık sağlar.
Artırılmış performans
iOS için Yerler SDK'sı (Yeni) daha iyi performans sağladığından mevcut SDK'yı kullanan uygulamaları değiştirmek faydalı olur.
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 (Yeni) için Yerler SDK'sı ile fiyatlandırma basitleştirilerek yalnızca kullandığınız veriler için ödeme yaparsınız. Basitleştirilmiş fiyatlandırma, alan maskeleri olarak da adlandırılan alan listeleri kullanılarak uygulanır.
iOS için Yerler SDK'sı ve Metin Arama ile yanıtta döndürülecek alanların 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. Alan listesi kullanmak, gereksiz veri isteğinde bulunmadığınızdan emin olmak için iyi bir tasarım uygulamasıdır. Bu da gereksiz işleme süresi ve faturalandırma ücretlerinin önlenmesine yardımcı olur.
Her iki SDK'yla ilgili 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. Ayrıca, Metin Arama ile bir aramada bu yeni türleri ve mevcut türleri de kullanabilirsiniz. Yeni türler A Tablosu'na dahil edilmiştir.
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 konaklaması | 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 | uyarlamak |
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 | heliport | 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 |
Places API (Yeni), bu yeni türlerle birlikte aşağıdaki türleri Places API için Tablo 2'den Places API için A Tablosuna (Yeni) taşıdı. Diğer bir deyişle, artık bir aramanın parçası olarak şu türleri kullanabilirsiniz:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality