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

Uygulamanızda kullanılabilen Android için Yerler SDK'sı, uygulama yapılandırmanızda belirttiğiniz SDK sürüm numarası (ör. 3.5.0), API anahtarınızda etkinleştirilmiş API'ler ve uygulamanızı başlatma şeklinizle birlikte 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ı

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 bir SDK sürümünde yapılan değişiklikler hakkında daha fazla bilgi edinmek için Android için Yerler SDK'sı sürüm notlarına bakın.

Android için Yerler SDK'sının Yerler API'si sürümleri

SDK sürüm numarasını 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 Otomatik tamamlama veya Otomatik Tamamlama (Yeni) gibi belirli özelliklerin hangi sürümünün kullanılabileceğini belirler. Yalnızca bir SDK sürüm numarası belirtebilirsiniz ancak API anahtarınızda aynı anda hem Places API'yi hem de Places API'yi (Yeni) etkinleştirebilir ve ardından SDK'nın uygulamanızda SDK'yı ilk kullanıma hazırlamak için kullandığınız yöntemle hangi hizmeti çağırdığını seçebilirsiniz. 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ılabileceğini seçmek için aşağıdakileri yapın:

  1. Google Cloud projenizde Places API'yi, Places API'yi (Yeni) veya her ikisini birden etkinleştirin. Daha fazla bilgi için API'leri Etkinleştirme konusuna bakın
  2. API anahtarı kısıtlamalarınızda Places API'yi, Places API'yi (Yeni) veya her ikisini birden etkinleştirin. Daha fazla bilgi için API anahtarlarını kısıtlama bölümüne bakın.

  3. Uygulama düzeyindeki build.gradle dosyasında bir sürüm numarası belirtin. Daha fazla bilgi için Yükleme bölümünü inceleyin.

  4. Places.initializeWithNewPlacesApiEnabled() veya Places.initialize() yöntemini çağırarak uygulamanızı ilk kullanıma hazırlayın.

Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama 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 gerekli olduğu 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ındakilerde 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 gereken noktalar

Hangi sürümü seçeceğinize karar vermenize yardımcı olması için aşağıdakileri göz önünde bulundurun:

  • Android için Yerler SDK'sını yeni kullanmaya başlayan yeni bir müşteriyseniz Yerler API'si (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çerken herhangi bir 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ında (Yeni) oturum jetonları 3.5.0 sürümünden itibaren kullanılabilir. Daha fazla bilgi edinmek için Oturum jetonları başlıklı makaleyi inceleyin.
  • Yer Otomatik Tamamlama widget'ları kullanılarak yapılan çağrılar her zaman Otomatik Yer Tamamlama'yı çağırır, Otomatik Yer Tamamlama (Yeni) özelliğini çağırmaz. Widget çağrıları, başlatma yönteminden etkilenmez.
  • Yer Fotoğrafları (Yeni) yalnızca bit eşlem resme bir URI döndürürken Yer Fotoğrafları yalnızca bit eşlem resmi döndürür.
  • Mevcut Yer yalnızca Android için Yerler SDK'sında kullanılabilir, Android için Yerler SDK'sında kullanılamaz (Yeni).

Android için Yerler SDK'sındaki geliş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 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 yerini almaya uygundur.

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 dayalı olarak bir dizi yer hakkındaki bilgileri döndürür; örneğin, "İstanbul'da pizza" veya "Taksim yakınındaki ayakkabı mağazaları" ya da "Ana Cadde No: 123.". Hizmet, metin dizesiyle eşleşen yerlerin bir listesiyle ve ayarlanan konuma bağlı olarak yanıt verir.

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

  • Yer Ayrıntıları (Yeni) seçeneği artık yanıt Place nesnesine yeni Review sınıfını içeriyor. Place sınıfı, bu alanı desteklemek için yeni getReviews() yöntemini içerir. Bir yer için beş adede kadar yorum döndürmek için getReviews() numaralı telefonu arayın.

  • Yer Fotoğrafı (Yeni), PhotoMetadata sınıfına AuthorAttributions öğesini ekler. AuthorAttributions, List boyutunda AuthorAttribution nesne içeriyor.

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

Artık bir resim bit eşlemine URI döndürmek için Yer Fotoğrafı'nı (Yeni) kullanabilirsiniz. Ö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şlem süresi ve fatura ücretlerinin önlenmesine yardımcı olur.

Her iki SDK ile 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. 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

Bu yeni türlerle birlikte Places API (Yeni), aşağıdaki türleri Places API için Tablo 2'den Places API için Tablo A'ya (Yeni) taşıdı. Bu, artık aşağıdaki türleri bir aramanın parçası olarak kullanabileceğiniz anlamına gelir:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality