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

Uygulamanızda kullanılabilen Android için Yerler SDK'sı özellikleri şunlardır: kullandığınız SDK sürüm numarasının (ör. 3.5.0) kombinasyonuna göre uygulama yapılandırmanızda, API anahtarınızda etkinleştirilen API'leri ve uygulamanızı başlatın. Bu kılavuzda, sürümler ve sürümler arasındaki farklar açıklanmaktadır. uygulamanızda hangi sürümlerin etkinleştirileceğini seçme.

SDK sürüm numaraları

Uygulama düzeyindeki build.gradle dosyasında belirttiğiniz SDK'nın sürüm numarası dosyası, uygulamanızın sürümü bulunuyor. Örneğin, Otomatik Tamamlama (Yeni) yalnızca SDK'da kullanılabilir Sürüm 3.5.0 veya üzeri.

Her bir SDK sürümünde yapılan değişiklikler hakkında daha fazla bilgi için bkz. Yerler Android sürümü için SDK notlar ekleyin.

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

Bir SDK sürüm numarası belirtmeye ek olarak, Google Play'deki SDK'nın Google Cloud Console'da çağırdığı API hizmeti: Places API veya Places API (Yeni). SDK sürüm numarasıyla birlikte, oluşturduğunuz API hizmeti seçme özelliği, belirli özelliklerin hangi sürümünün uygulamanızda kullanılabileceğini belirler. gibi otomatik tamamlama veya otomatik tamamlama (Yeni) biçimini kullanabilirsiniz. Yalnızca bir SDK belirtebilirsiniz ancak Hem Places API'yi hem de Places API'yi (Yeni) API anahtarını aynı anda kontrol edin ve ardından SDK'nın hangi hizmeti çağıracağını seçin uygulamanızda SDK'yı başlatmak için kullandığınız yöntem. Ancak çoğu durumda Rehber API'sini (Yeni) etkinleştirmek ve Uygulamanızdaki SDK özellikleri.

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:

  1. Google Cloud projenizde Places API, Places API (Yeni) veya her ikisini de seçebilirsiniz. Daha fazla bilgi için bkz. Etkinleştirme API'ler
  2. API anahtarı kısıtlamalarınızda Places API, Places API (Yeni) veya her ikisini de seçebilirsiniz. Daha fazla bilgi için API'yi kısıtlama bölümüne bakın. tuşlar.
  3. Uygulama düzeyindeki build.gradle dosyasında bir sürüm numarası belirtin. Daha fazla bkz. Yükleme.

  4. Şu yöntemlerden birini çağırarak uygulamanızı başlatın: Places.initializeWithNewPlacesApiEnabled() veya Places.initialize() yöntemidir.

Places API hizmetini seçme hakkında daha fazla bilgi için bkz. Google Cloud projesi.

Her sürümde kullanılabilen SDK özellikleri

Aşağıdaki tabloda her bir SDK için hangi SDK ve API sürümlerinin gerekli olduğu gösterilmektedir özellik:

Özellik 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 ardından Places API (Yeni) ve yeni SDK ile başlayın.
  • Mevcut bir müşteriyseniz mevcut SDK'yı kullanmaya devam edebilirsiniz. Ancak, Google Play'de sunulan performans iyileştirmelerinden ve Android için Yerler SDK'sı (Yeni) için yeni özellikleri kullanıyorsanız yeni SDK'dır. Yeni SDK'ya geçmek için taşıma işlemi gerekmez. Geçiş yapmak için SDK sürümünüzü ve API'nizi seçin hizmet.
  • Android için Yerler SDK'sında (Yeni) oturum jetonları şu tarihten itibaren kullanılabilir: sürüm 3.5.0'dır. Daha fazla bilgi için bkz. Oturum jetonlar.
  • Otomatik Yer Tamamlama widget'ları kullanılarak yapılan aramalar her zaman Yer Otomatik tamamlama, değil Otomatik Yer Tamamlama (Yeni); widget aramaları ilk kullanıma hazırlama yöntemidir.
  • 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 bit eşlem döndürür görüntüsüdür.
  • Geçerli 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 (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), hizmette altyapı Google Cloud'da deneyin. Bu uygulama, daha güvenli ve güvenilir bir platform sağlıyor. Bu standart tasarım, iyileştirilmiş SDK'lar genelinde belirli bir tutarlılık düzeyi sağlar. Android için Yerler SDK'sı ile geliştirme verimliliği (Yeni).

Artırılmış performans

Android için Yerler SDK'sı (Yeni) daha iyi performans sağlayarak uygulamaların değiştirilmesine değer olacaktır.

Yeni özellikler

Android için Yerler SDK'sı (Yeni), SDK'nın tamamının en son sürümlerini içerir özellikler:

Yeni Metin Arama hizmeti

Metin Arama (Yeni) bilgi döndürür bir dizeye dayalı olarak bir dizi yer hakkında; örneğin, "İstanbul'da pizza" veya "İstanbul yakınındaki ayakkabı mağazaları" veya "Ana Cadde No: 123". Hizmet, bir listeyle yanıt verir metin dizesiyle eşleşen yer sayısı ve ayarlanan konum önyargısı.

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 yeni Yorum sınıfını kullanır.Place İlgili içeriği oluşturmak için kullanılan Yer sınıfı , bu alanı desteklemek için yeni getReviews() yöntemini içerir. Telefonla arama Bir yerle ilgili beş adede kadar yorum döndürmek için getReviews().

  • Yer Fotoğrafı (Yeni): AuthorAttributions PhotoMetadata sınıfına. AuthorAttributions, şunu içerir: List AuthorAttribution nesneler'i tıklayın.

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

Artık şunları kullanabilirsiniz: Yer Fotoğrafı (Yeni) işlevini kullanın. Daha önce yalnızca görüntü bit eşlemlerinin birini oluşturur.

Basitleştirilmiş fiyatlandırma

Fiyatlandırma, Android (Yeni) için Yerler SDK'sı ile kolaylaştırılmıştır. Böylece yalnızca yalnızca kullandığınız veri için ödeme yaparsınız. Basitleştirilmiş fiyatlandırma, alan listeleri kullanılarak uygulanır. alan maskeleri olarak da adlandırılır.

Yer Ayrıntıları ve Alan listelerini kontrol etmek için kullandığınız Metin Arama alanları kullanın. Bu durumda yalnızca veriler için faturalandırılırsınız. istendi. Alan listesi kullanmak, bir projenizde birden fazla gereksiz veri talep etmeli, bu sayede gereksiz işlem süresini ve faturalandırma ücretleri.

Her iki SDK'yla ilgili ayrıntılı fiyatlandırma bilgileri için Kullanım ve Faturalandırma.

Genişletilmiş yer türleri

Yeni SDK, aşağıdaki tabloda gösterilen yer türlerini ekler. Bu türler ve bu tarih, Yer Ayrıntılarının ve Metin Arama yanıtı. Bu yeni türleri de ve mevcut türlerde de arama yapabilirsiniz. Yeni türler, Tablo Cevap.

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 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ürlerle birlikte, Places API (Yeni) aşağıdaki türleri taşıdı Places API için Tablo 2'den Places API için A Tablosuna (Yeni) kadar bir değer sunar. Yani artık bu türleri bir eğitim programının ara:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality