Uygulamanızda kullanılabilen Android için Yerler SDK'sı özellikleri, uygulama yapılandırmanızda belirttiğiniz SDK sürüm numarasının (ör. 3.5.0), API anahtarınızda etkinleştirilen API'lerin ve uygulamanızı başlatma şeklinizin bir kombinasyonuna göre belirlenir. Bu kılavuzda, sürümler arasındaki farklar ve uygulamanızda etkinleştirilen sürümlerin nasıl seçileceği açıklanmaktadır.
SDK sürüm numaraları
Uygulama düzeyindeki build.gradle dosyanı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 3.5.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 Android için Yerler SDK'sı sürüm notlarına bakın.
Android 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ştirebilir ve daha sonra, uygulamanızda SDK'yı başlatmak için kullandığınız yöntemle SDK'nın hangi hizmeti çağıracağını seçebilirsiniz. Ancak, çoğu durumda Places API'yi (Yeni) etkinleştirmek ve uygulamanızda SDK özelliklerinin (Yeni) sürümlerini kullanmak isteyebilirsiniz.
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.
Uygulama düzeyindeki build.gradle dosyasında bir sürüm numarası belirtin. Daha fazla bilgi edinmek için Yükleme konusuna bakın.
Places.initializeWithNewPlacesApiEnabled()
veyaPlaces.initialize()
yöntemini çağırarak uygulamanızı başlatı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 | Başlatma yöntemi | Minimum SDK sürümü |
---|---|---|---|
Otomatik tamamlama (Yeni) | Places API (Yeni) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
Yer Ayrıntıları (Yeni) | Places API (Yeni) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
Yakında Arama (Yeni) | Places API (Yeni) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
Yer Fotoğrafları (Yeni) | Places API (Yeni) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
Metin Arama (Yeni) | Places API (Yeni) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
Otomatik Yer Tamamlama | Places API | initialize() |
|
Mevcut Yer | Places API | initialize() |
|
Yer Ayrıntıları | Places API | initialize() |
|
Yer Fotoğrafları | Places API | initialize() |
Etkinleştirilecek sürümleri seçerken dikkate alınması gereken noktalar
Hangi sürümü seçeceğinize karar verirken aşağıdakileri göz önünde bulundurun:
- Android 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 Android için Yerler SDK'sının (Yeni) performans iyileştirmelerinden ve özellik geliştirmelerinden yararlanmak için 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.
- Android için Yerler SDK'sında (Yeni) oturum jetonları 3.5.0 sürümünden itibaren kullanılabilir. Daha fazla bilgi için Oturum jetonları bölümüne bakın.
- Otomatik Yer Tamamlama widget'ları kullanılarak yapılan aramalar her zaman Otomatik Yer Tamamlama işlevini çağırır, Otomatik Yer Tamamlama (Yeni) özelliğini çağırmaz. Widget aramaları başlatma yönteminden etkilenmez.
- Yer Fotoğrafları (Yeni) yalnızca bir bit eşlem görüntüsüne URI döndürürken Yer Fotoğrafları yalnızca bir bit eşlem görüntüsü döndürür.
- Current Place yalnızca Android için Yerler SDK'sında kullanılabilir, Android için Yerler SDK'sında (Yeni) kullanılamaz.
Android için Yerler SDK'sındaki Geliştirmeler (Yeni)
Bu bölümde, Android (Yeni) için Yerler SDK'sına eklenen temel özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulanır
Android 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, Android 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
Android için Yerler SDK'sı (Yeni) daha iyi performans sağladığından mevcut SDK'yı kullanan uygulamaların değiştirilmesini kolaylaştırır.
Yeni özellikler
Android 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)
Yeni Metin Arama hizmeti
Metin Arama (Yeni), bir dizeye dayalı olarak bir yer grubu ile ilgili bilgileri döndürür. Örneğin, "İstanbul'da pizza" veya "İstanbul yakınındaki ayakkabı mağazaları" ya da "Ana Cadde No: 123". Hizmet, metin dizesiyle eşleşen yerlerin bir listesiyle ve ayarlanan konum ön yargılarıyla yanıt verir.
Yer Ayrıntıları (Yeni) ve Yer Fotoğrafları (Yeni) bölümlerine yeni yanıt verileri eklendi
Yer Ayrıntıları (Yeni) artık yanıt
Place
nesnesinde yeni Review sınıfını içeriyor. Place sınıfı, bu alanı destekleyen yenigetReviews()
yöntemini içerir. Bir yerle ilgili beş yoruma kadar geri dönmek içingetReviews()
numaralı telefonu arayın.Yer Fotoğrafı (Yeni),
PhotoMetadata
sınıfınaAuthorAttributions
öğesini ekler.AuthorAttributions
,AuthorAttribution
nesnedenList
değerini içeriyor.
Yer Fotoğrafları'na yeni URI yanıtı eklendi (Yeni)
Artık bir resim bit eşleminin URI'sini döndürmek için Yer Fotoğrafı (Yeni) aracını kullanabilirsiniz. Önceden, yalnızca resim bit eşleminin kendisi döndürülebiliyordu.
Basitleştirilmiş fiyatlandırma
Android (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.
Yer Ayrıntıları 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 | playground | 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