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 ilgili bir açıklamadır. Ö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 altında bulabilirsiniz.
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 Rehber API'sini 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 Places API'yi (Yeni) etkinleştirmek ve Rehber'in (Yeni) 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:
- Google Cloud projenizde Places API, Places API (Yeni) veya her ikisini de seçebilirsiniz. Daha fazla bilgi için bkz. Etkinleştirme API'ler
- 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.
Uygulama düzeyindeki build.gradle dosyasında bir sürüm numarası belirtin. Daha fazla bkz. Yükleme.
Şu yöntemlerden birini çağırarak uygulamanızı başlatın:
Places.initializeWithNewPlacesApiEnabled()veyaPlaces.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ştirmenin 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:
- Otomatik tamamlama (Yeni)
- Yer Ayrıntıları (Yeni)
- Yakında Arama (Yeni)
- Yer Fotoğrafları (Yeni)
- Metin Arama (Yeni)
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 yenigetReviews()yöntemini içerir. Telefonla arama Bir yerle ilgili beş adede kadar yorum döndürmek içingetReviews().Yer Fotoğrafı (Yeni):
AuthorAttributionsPhotoMetadatasınıfına.AuthorAttributions, şunu içerir:ListAuthorAttributionnesneler'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 etmeliyiz. Bu da 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 de 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:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality