Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

Android için Yerler SDK'sının 3.4.0 sürümü, iki SDK sürümünü destekler: Android için Yerler SDK'sı mevcut SDK'dır. Android için Yerler SDK'sı (Yeni) ise SDK'nın yeni nesil sürümüdür.

Android için Yerler SDK'sının 3.4.0 sürümünün yayınlanmasıyla birlikte, ilk göreviniz hangi SDK'nın kullanılacağına karar vermektir. Bu durum, yeni bir müşteriyseniz veya halihazırda SDK'yı kullanan mevcut bir müşteriyseniz geçerlidir. İki SDK arasındaki temel farkları anlamak için bu kılavuzu kullanın.

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

Arka uçta, Android için Yerler SDK'sı Places API (Yeni) veya Places API olan Places API hizmetini kullanır. Android için Yerler SDK'sını kullanabilmeniz için Google Cloud projenizde Places API hizmetini etkinleştirmeniz gerekir.

Android'de, uygulamanızda kullanabileceğiniz API'leri belirlemek için gerçekleştirebileceğiniz iki işlem vardır:

Uygulamanızda kullanmak istediğiniz ürüne bağlı olarak, projenizde Places API'yi (Yeni), Places API'yi veya API anahtarınıza bağlı olarak her ikisini de etkinleştirmeniz gerekir.
Places.initializeWithNewPlacesApiEnabled() veya Places.initialize() yöntemini çağırarak uygulamanızı ilk kullanıma hazırlayın.

SDK'nızı seçin

Etkinleştirdiğiniz Places API hizmetinin sürümü, uygulamanız tarafından kullanılan SDK sürümünü kontrol eder:

Her ikisi de: Android için Yerler SDK'sı ve Android için Yerler SDK'sı (Yeni) için tüm özellikleri etkinleştirir. Mevcut özellikleri kontrol etmek için Places.initializeWithNewPlacesApiEnabled() ve Places.initialize() yöntemini kullanın.
Places API: Mevcut Android için Yerler SDK'sını etkinleştirir. Android sürüm 3.4.0 için Yerler SDK'sına eklenen yeni özelliklere erişiminiz yoktur.
Places API (Yeni): Android için Yerler SDK'sını (Yeni) ve Android için Yerler SDK'sına eklenen önemli özellikler (Yeni) konusunda açıklanan tüm yeni özellikleri etkinleştirir ancak Mevcut Yer ve Otomatik Yer Tamamlama gibi mevcut özellikleri etkinleştirmez.

Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama bölümüne bakın.

Uygulamanızı ilk kullanıma hazırlama

Uygulamanızı ilk kullanıma hazırlarken Places.initializeWithNewPlacesApiEnabled() veya Places.initialize() yöntemini çağırmanız gerekir.

Aşağıdaki tabloda, her bir SDK'yı etkinleştirmenin ve her başlatma yöntemini çağırmanın etkileri gösterilmektedir. Örneğin, Yerler SDK'sını (Yeni) etkinleştirip Places.initializeWithNewPlacesApiEnabled() yöntemini çağırırsanız yeni API'lerin ve mevcut API'lerin tümünü kullanabilirsiniz.

Yerler SDK'sını (Yeni) etkinleştirip Places.initialize() yöntemini çağırırsanız Yer Ayrıntıları ve Yer Fotoğrafları'nın yeni özelliklerini kullanamazsınız, ancak yeni Metin Arama'yı çağırabilirsiniz. Places API'yi etkinleştirmezseniz Yer Ayrıntıları'nın eski sürümüne erişemezsiniz ancak yeni Metin Arama'yı çağırabilirsiniz.

Sürüm	API'ler	API anahtarında SDK Etkin		Başlatma yöntemi
		Places API'si	Places API (Yeni)	`initialize()`	`initializeWithNewPlacesApiEnabled()`
v3.3.0	Yer Ayrıntıları
	Yer Ayrıntıları (Yeni)
	Fotoğraf Meta Verileri (Yeni)
	Metin Arama (Yeni)			İki yöntem
v3.4.0	Fotoğraf URI'si (Yeni)
	Fotoğraf bit eşlemi			İki yöntem
	CurrentPlace			İki yöntem
	Otomatik tamamlama			İki yöntem

Hangi SDK'yı seçersiniz?

Hangi sürümü seçeceğinize karar vermenize yardımcı olması için:

Yeni bir müşteriyseniz Android için Yerler SDK'sını yeni kullanmaya başlıyorsanız Places API (Yeni) ve yeni SDK ile başlayın.
Kotlin geliştiricisiyseniz SDK'lardan herhangi birini kullanabilirsiniz ancak Android için Yerler SDK'sı (Yeni) özelliğindeki yeni özellikler yalnızca Java'nın 3.4.0 sürümünde kullanılabilir.
Mevcut bir müşteriyseniz ve oturum jetonları kullanıyorsanız mevcut SDK'yı kullanmaya devam edin. Android (Yeni) için Yerler SDK'sı şu anda oturum jetonlarını desteklememektedir.
Mevcut 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ı kullanabilirsiniz.

Yeni SDK'ya geçiş için herhangi bir taşıma işlemi gerekmez. Yapmanız gereken tek şey:
1. Uygulamanızda kullanılan API anahtarında Places API'yi (Yeni) etkinleştirin. Daha fazla bilgi için API Anahtarlarını Kullanma bölümüne bakın.
2. Modül düzeyindeki build.gradle dosyanızın dependencies bölümünde, places bağımlılığını güncelleyin ve kotlin-bom bağımlılığını ekleyin:
```
  dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.3.0'
  }
```
  kotlin-bom bağımlılığı hakkında daha fazla bilgi için Geçişli bağımlılıklarda en yeni kotlin-stdlib sürümünün kullanımı bölümüne bakın.
3. Mevcut uygulamanızı, uygulamanızı ilk kullanıma hazırlamak için yeni Places.initializeWithNewPlacesApiEnabled() yöntemini çağıracak şekilde güncelleyin. Daha fazla bilgi için Place API istemcisini başlatma bölümüne bakın.
Mevcut uygulamalarınız değişmeden çalışmaya devam eder, ancak artık tüm yeni SDK özelliklerinden yararlanabilirsiniz.

Android için Yerler SDK'sına eklenen temel özellikler (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 yerine başka bir uygulama tercih etmek önemlidir.

Yeni Metin Arama hizmeti

Metin Arama, bir dizeye göre bir dizi yer hakkındaki bilgileri döndürür. Örneğin, "İstanbul'da pizza", "Taksim yakınındaki ayakkabı mağazaları" veya "Ana Cadde No: 123". Hizmet, metin dizesiyle eşleşen yerlerin bir listesiyle ve ayarlanan konum önyargısıyla yanıt verir.

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

Yer Ayrıntıları artık yanıt Place nesnesinde 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ı, AuthorAttributions öğesini PhotoMetadata sınıfına ekler. AuthorAttributions, List boyutunda AuthorAttribution nesne içeriyor.

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

Artık Yer Fotoğrafları'nı kullanarak bir resim bit eşlemine bir URI döndürebilirsiniz. Ö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şleme süresi ve faturalandırma ücretlerinin önüne geçilir.

Her iki SDK ile ilgili ayrıntılı fiyatlandırma bilgisi 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 de Tablo B'den A Tablosu'ndan taşımıştır. Yani artık arama kapsamında aşağıdaki türleri kullanabilirsiniz:

country
administrative_area_level_1
administrative_area_level_2
postal_code
locality