Uygulamanızda kullanılabilen Android için Places 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ı nasıl başlattığınızın bir kombinasyonuyla belirlenir. Bu kılavuzda, sürümler arasındaki farklar ve uygulamanızda hangi sürümlerin etkinleştirileceğinin nasıl seçileceği açıklanmaktadır.
SDK sürüm numaraları
Uygulama düzeyindeki build.gradle dosyanızda belirttiğiniz SDK 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 3.5.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 Android için Yerler SDK'sı sürüm notlarına bakın.
Android için Yerler SDK'sı'nın desteklediği Yerler API 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ümünün kullanılabileceğini belirler. Yalnızca bir SDK sürüm numarası belirtebilseniz de API anahtarınızda aynı anda hem Yerler API'yi hem de Yerler API'yi (Yeni) etkinleştirebilir, ardından uygulamanızda SDK'yı başlatmak için kullandığınız yöntem aracılığıyla SDK'nın hangi hizmeti çağıracağını seçebilirsiniz. Ancak çoğu durumda, Yerler 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çin
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.
Uygulama düzeyindeki build.gradle dosyasında bir sürüm numarası belirtin. Daha fazla bilgi için Yükleme bölümüne 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 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:
| Özellik | API anahtarında Places API etkin | 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 |
| Fotoğraf Yerleştirme (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() |
|
| Fotoğraf yerleştirme | Places API | initialize() |
Etkinleştirilecek sürümleri seçmeyle ilgili dikkat edilmesi gereken noktalar
Hangi sürümü seçeceğinize karar vermek için aşağıdakileri göz önünde bulundurun:
- Android için Yerler SDK'sını kullanmaya yeni başlayan bir müşteriyseniz Yerler API'si (Yeni) ve yeni SDK'yı kullanmaya 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 istiyorsanız yeni SDK'yı kullanmanız gerekir. Yeni SDK'ya geçiş yaparken taşıma işlemi yapmanız gerekmez. SDK sürümünüzü ve API hizmetlerinizi seçin başlıklı makaledeki adımları uygulayın.
- Android için Yerler SDK'sı (Yeni) 3.5.0 sürümünden itibaren oturum jetonları kullanılabilir. Daha fazla bilgi için Oturum jetonları başlıklı makaleyi inceleyin.
- Yer Otomatik Tamamlama widget'ları kullanılarak yapılan çağrılar her zaman Yer Otomatik Tamamlama (Yeni) yerine Yer Otomatik Tamamlama'yı çağırır. Widget çağrıları, başlatma yönteminden etkilenmez.
- Yer Fotoğrafları (Yeni) yalnızca bir bitmap resminin URI'sini döndürür. Yer Fotoğrafları ise yalnızca bir bitmap resmi döndürür.
- Mevcut Yer, Android için Yerler SDK'sında (Yeni) değil, yalnızca Android için Yerler SDK'sında kullanılabilir.
Android için Yerler SDK'sında yapılan iyileştirmeler (Yeni)
Bu bölümde, Android için Yerler SDK'sına (Yeni) eklenen temel özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulanır.
Android için Places 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 Android 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
Android 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
Android için Yerler SDK'sı (Yeni), SDK özelliklerinin tümünün en son sürümlerini içerir:
- Otomatik tamamlama (Yeni)
- Yer Ayrıntıları (Yeni)
- Yakında Arama (Yeni)
- Fotoğraf Yerleştirme (Yeni)
- Metin Arama (Yeni)
Yeni metin arama hizmeti
Metin arama (Yeni), bir dizeye göre bir dizi yer hakkında bilgi döndürür (ör. "New York'ta pizza" veya "Ottawa yakınlarındaki ayakkabı mağazaları" ya da "123 Ana Cadde"). Hizmet, metin dizesine ve ayarlanmış konum yanlılığına eşleşen yerlerin listesini döndürür.
Yer Ayrıntıları (Yeni) ve Yer Fotoğrafları (Yeni) alanlarına yeni yanıt verileri eklendi
Yer Ayrıntıları (Yeni) artık yanıt
Placenesnesinde yeni Yorum sınıfını içeriyor. Place sınıfı, bu alanı destekleyen yenigetReviews()yöntemini içerir. Bir yerle ilgili en fazla beş yorum döndürmek içingetReviews()numaralı telefonu arayın.Fotoğraf yerleştir (Yeni) seçeneği,
AuthorAttributionssınıfınıPhotoMetadatasınıfına ekler.AuthorAttributions,AuthorAttributionobjeden oluşan birListiçerir.
Yer fotoğraflarına yeni URI yanıtı eklendi (Yeni)
Artık bir resim bitmap'i için URI döndürmek üzere Fotoğraf Yerleştir'i (Yeni) kullanabilirsiniz. Daha önce yalnızca resim bitmap'ini döndürebilmeniz mümkündü.
Basitleştirilmiş fiyatlandırma
Yalnızca kullandığınız veriler için ödeme yapmanız amacıyla Android için Yerler SDK'sı (Yeni) ile fiyatlandırma basitleştirilmiştir. Basitleştirilmiş fiyatlandırma, alan maskeleri olarak da bilinen alan listeleri kullanılarak uygulanır.
Yer Ayrıntıları ve Metin Arama'da, 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 veriler 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 aramalı 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 için Tablo 2'den Places API (Yeni) için Tablo A'ya taşıdı. Yani artık arama kapsamında aşağıdaki türleri kullanabilirsiniz:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality