Android için Yerler SDK'sının 3.4.0 sürümü, iki SDK sürümünü destekler: Android için Yerler SDK'sı mevcut SDK'dır. Android için Yerler SDK'sı (Yeni) ise SDK'nın yeni nesil sürümüdür.
Android için Yerler SDK'sının 3.4.0 sürümünün yayınlanmasıyla birlikte, ilk göreviniz hangi SDK'nın kullanılacağına karar vermektir. Bu durum, yeni bir müşteriyseniz veya halihazırda SDK'yı kullanan mevcut bir müşteriyseniz geçerlidir. İki SDK arasındaki temel farkları anlamak için bu kılavuzu kullanın.
SDK sürümünüzü seçme
Arka uçta, Android için Yerler SDK'sı Places API (Yeni) veya Places API olan Places API hizmetini kullanır. Android için Yerler SDK'sını kullanabilmeniz için Google Cloud projenizde Places API hizmetini etkinleştirmeniz gerekir.
Android'de, uygulamanızda kullanabileceğiniz API'leri belirlemek için gerçekleştirebileceğiniz iki işlem vardır:
Uygulamanızda kullanmak istediğiniz ürüne bağlı olarak, projenizde Places API'yi (Yeni), Places API'yi veya API anahtarınıza bağlı olarak her ikisini de etkinleştirmeniz gerekir.
Places.initializeWithNewPlacesApiEnabled()
veyaPlaces.initialize()
yöntemini çağırarak uygulamanızı ilk kullanıma hazırlayın.
SDK'nızı seçin
Etkinleştirdiğiniz Places API hizmetinin sürümü, uygulamanız tarafından kullanılan SDK sürümünü kontrol eder:
Her ikisi de: Android için Yerler SDK'sı ve Android için Yerler SDK'sı (Yeni) için tüm özellikleri etkinleştirir. Mevcut özellikleri kontrol etmek için
Places.initializeWithNewPlacesApiEnabled()
vePlaces.initialize()
yöntemini kullanın.Places API: Mevcut Android için Yerler SDK'sını etkinleştirir. Android sürüm 3.4.0 için Yerler SDK'sına eklenen yeni özelliklere erişiminiz yoktur.
Places API (Yeni): Android için Yerler SDK'sını (Yeni) ve Android için Yerler SDK'sına eklenen önemli özellikler (Yeni) konusunda açıklanan tüm yeni özellikleri etkinleştirir ancak Mevcut Yer ve Otomatik Yer Tamamlama gibi mevcut özellikleri etkinleştirmez.
Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama bölümüne bakın.
Uygulamanızı ilk kullanıma hazırlama
Uygulamanızı ilk kullanıma hazırlarken Places.initializeWithNewPlacesApiEnabled()
veya Places.initialize()
yöntemini çağırmanız gerekir.
Aşağıdaki tabloda, her bir SDK'yı etkinleştirmenin ve her başlatma yöntemini çağırmanın etkileri gösterilmektedir. Örneğin, Yerler SDK'sını (Yeni) etkinleştirip Places.initializeWithNewPlacesApiEnabled()
yöntemini çağırırsanız yeni API'lerin ve mevcut API'lerin tümünü kullanabilirsiniz.
Yerler SDK'sını (Yeni) etkinleştirip Places.initialize()
yöntemini çağırırsanız Yer Ayrıntıları ve Yer Fotoğrafları'nın yeni özelliklerini kullanamazsınız, ancak yeni Metin Arama'yı çağırabilirsiniz. Places API'yi etkinleştirmezseniz Yer Ayrıntıları'nın eski sürümüne erişemezsiniz ancak yeni Metin Arama'yı çağırabilirsiniz.
Sürüm | API'ler | API anahtarında SDK Etkin | Başlatma yöntemi | ||
---|---|---|---|---|---|
Places API'si | Places API (Yeni) | initialize() |
initializeWithNewPlacesApiEnabled() |
||
v3.3.0 | Yer Ayrıntıları | ||||
Yer Ayrıntıları (Yeni) | |||||
Fotoğraf Meta Verileri (Yeni) | |||||
Metin Arama (Yeni) | İki yöntem | ||||
v3.4.0 | Fotoğraf URI'si (Yeni) | ||||
Fotoğraf bit eşlemi | İki yöntem | ||||
CurrentPlace | İki yöntem | ||||
Otomatik tamamlama | İki yöntem |
Hangi SDK'yı seçersiniz?
Hangi sürümü seçeceğinize karar vermenize yardımcı olması için:
Yeni bir müşteriyseniz Android için Yerler SDK'sını yeni kullanmaya başlıyorsanız Places API (Yeni) ve yeni SDK ile başlayın.
Kotlin geliştiricisiyseniz SDK'lardan herhangi birini kullanabilirsiniz ancak Android için Yerler SDK'sı (Yeni) özelliğindeki yeni özellikler yalnızca Java'nın 3.4.0 sürümünde kullanılabilir.
Mevcut bir müşteriyseniz ve oturum jetonları kullanıyorsanız mevcut SDK'yı kullanmaya devam edin. Android (Yeni) için Yerler SDK'sı şu anda oturum jetonlarını desteklememektedir.
Mevcut 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ı kullanabilirsiniz.
Yeni SDK'ya geçiş için herhangi bir taşıma işlemi gerekmez. Yapmanız gereken tek şey:
- Uygulamanızda kullanılan API anahtarında Places API'yi (Yeni) etkinleştirin. Daha fazla bilgi için API Anahtarlarını Kullanma bölümüne bakın.
Modül düzeyindeki
build.gradle
dosyanızındependencies
bölümünde,places
bağımlılığını güncelleyin vekotlin-bom
bağımlılığını ekleyin:dependencies { implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0")) implementation 'com.google.android.libraries.places:places:3.3.0' }
kotlin-bom
bağımlılığı hakkında daha fazla bilgi için Geçişli bağımlılıklarda en yeni kotlin-stdlib sürümünün kullanımı bölümüne bakın.- Mevcut uygulamanızı, uygulamanızı ilk kullanıma hazırlamak için yeni
Places.initializeWithNewPlacesApiEnabled()
yöntemini çağıracak şekilde güncelleyin. Daha fazla bilgi için Place API istemcisini başlatma bölümüne bakın.
Mevcut uygulamalarınız değişmeden çalışmaya devam eder, ancak artık tüm yeni SDK özelliklerinden yararlanabilirsiniz.
Android için Yerler SDK'sına eklenen temel özellikler (Yeni)
Bu bölümde, Android için Yerler SDK'sına (Yeni) eklenen temel özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulandı
Android 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 getiriyor. Bu standart tasarım, Android için Yerler SDK'sı ile geliştirme verimliliğini artıran SDK'lar arasında tutarlılık düzeyi sağlar (Yeni).
Artırılmış performans
Android için Yerler SDK'sı (Yeni) gelişmiş performans sunduğundan mevcut SDK'yı kullanan uygulamaların yerine başka bir uygulama tercih etmek önemlidir.
Yeni Metin Arama hizmeti
Metin Arama, bir dizeye göre bir dizi yer hakkındaki bilgileri döndürür. Örneğin, "İstanbul'da pizza", "Taksim yakınındaki ayakkabı mağazaları" veya "Ana Cadde No: 123". Hizmet, metin dizesiyle eşleşen yerlerin bir listesiyle ve ayarlanan konum önyargısıyla yanıt verir.
Yer Ayrıntıları ve Yer Fotoğrafları'na yeni yanıt verileri eklendi
Yer Ayrıntıları artık yanıt
Place
nesnesinde yeni Review sınıfını içeriyor. Place sınıfı, bu alanı desteklemek için yenigetReviews()
yöntemini içerir. Bir yer için beş adede kadar yorum döndürmek içingetReviews()
numaralı telefonu arayın.Yer Fotoğrafı,
AuthorAttributions
öğesiniPhotoMetadata
sınıfına ekler.AuthorAttributions
,List
boyutundaAuthorAttribution
nesne içeriyor.
Yer Fotoğrafları'na yeni URI yanıtı eklendi
Artık Yer Fotoğrafları'nı kullanarak bir resim bit eşlemine bir URI döndürebilirsiniz. Önceden, yalnızca resim bit eşleminin kendisini döndürebiliyordunuz.
Basitleştirilmiş fiyatlandırma
Android için Yerler SDK'sı (Yeni) ile fiyatlandırma basitleştirildi; böylece 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. Böylece 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. Böylece gereksiz işleme süresi ve faturalandırma ücretlerinin önüne geçilir.
Her iki SDK ile ilgili ayrıntılı fiyatlandırma bilgisi 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 bir aramada da kullanabilirsiniz. Yeni türler A Tablosu'nda yer almaktadır.
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 | Farmstay | 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 | 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 |
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality