SDK sürümünüzü seçin

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ı 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 Places SDK'sı sürüm notlarına bakın.

Android 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ı belirtebilirsiniz ancak 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çme

Uygulamanızda kullanılabilecek SDK özelliklerini seçmek için aşağıdakileri yapın:

  1. 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.
  2. 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.

  3. 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.

  4. Places.initializeWithNewPlacesApiEnabled() veya Places.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 İlk kullanıma hazırlama 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()

Hangi sürümlerin etkinleştirileceğini seçerken dikkat edilmesi gerekenler

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'sini (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 gerekmez. SDK sürümünüzü ve API hizmetlerinizi seçme bölümündeki adımları uygulamanız yeterlidir.
  • 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.
  • Fotoğraf Yerleştirme (Yeni) işlevi yalnızca bir bitmap resminin URI'sini döndürür. Fotoğraf Yerleştirme işlevi ise yalnızca bir bitmap resmi döndürür.
  • Mevcut Yer, yalnızca Android için Yerler SDK'sında (Yeni) değil, Android için Yerler SDK'sında kullanılabilir.

Android için Yerler SDK'sında yapılan geliştirmeler (Yeni)

Bu bölümde, Android için Yerler SDK'sı'na (Yeni) eklenen önemli ö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 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), daha iyi performans sunarak mevcut SDK'yı kullanan uygulamaları değiştirmeyi değerli kılar.

Yeni özellikler

Android için Yerler SDK'sı (Yeni), tüm SDK özelliklerinin en son sürümlerini içerir:

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 bir listesiyle yanıt verir.

Yer Ayrıntıları (Yeni) ve Yer Fotoğrafları (Yeni) özelliklerine yeni yanıt verileri eklendi

  • Yer Ayrıntıları (Yeni) artık yanıt Place nesnesindeki yeni İnceleme sınıfını içeriyor. Place sınıfı, bu alanı destekleyen yeni getReviews() yöntemini içerir. Bir yerle ilgili en fazla beş yorum döndürmek için getReviews() numaralı telefonu arayın.

  • Fotoğraf yerleştir (Yeni) seçeneği, AuthorAttributions sınıfına PhotoMetadata sınıfı ekler. AuthorAttributions, AuthorAttribution nesnesi içeren bir List içeriyor.

Yer fotoğraflarına yeni URI yanıtı eklendi (Yeni)

Artık bir resim bitmap'inin URI'sini döndürmek için Fotoğraf Yerleştir'i (Yeni) kullanabilirsiniz. Daha önce yalnızca resim bitmap'ini döndürebilmeniz mümkündü.

Basitleştirilmiş fiyatlandırma

Android 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.

Yer Ayrıntıları 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:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality