Yer Ayrıntılarına Taşı (Yeni)

Android için Yerler SDK'sı, mevcut yer ayrıntılarını destekler. Mevcut Android için Yerler SDK'sını biliyorsanız Yer Ayrıntıları'nın yeni sürümünde aşağıdaki değişiklikler yapılmıştır:

  • Yeni bir fiyatlandırma modeli kullanır. Tüm API'lerin fiyatlandırma bilgileri için Android için Yerler SDK'sı (Yeni) başlıklı makaleyi inceleyin.

  • Places.initializeWithNewPlacesApiEnabled() yöntemini çağırarak uygulamanızı başlatmanız gerekir. Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama başlıklı makaleyi inceleyin.

  • Alan maskelemesi gereklidir. Yanıtta döndürülmesini istediğiniz alanları belirtmeniz gerekir. Döndürülen alanların varsayılan listesi yoktur. Bu listeyi atlarsanız yöntemler hata döndürür.

Aşağıdaki bölümlerde ek değişiklikler açıklanmaktadır.

Yeni yer türlerine erişme

Her yerin bir veya daha fazla tür değeri olabilir. Android için Yerler SDK'sı 3.3.0 ve sonraki sürümleri birçok yeni tür değeri ekler. Tam liste için Genişletilmiş yer türleri başlıklı makaleyi inceleyin.

Place.getPlaceTypes() yöntemi, tür değerlerini dize değerleri listesi olarak döndürür. Döndürülen değerler, Android için Yerler SDK'nızın sürümüne bağlıdır:

  • Android için Yerler SDK'sı (Yeni): 3.3.0 sürümünde eklenen tüm yer türleri de dahil olmak üzere Yer Türleri (Yeni) bölümünde gösterilen A Tablosu ve B Tablosu tarafından tanımlanan dizeleri döndürür.

  • Android için Yerler SDK'sı: Place.Types tarafından tanımlanan enum'ları döndürür. 3.3.0 ve sonraki sürümlerde eklenen yeni türler bu kapsamda değildir.

Yer yorumlarına erişme

Android için Yerler SDK'sı (Yeni), bir yerle ilgili yorum içeren Review sınıfını ekler. Place nesnesi en fazla beş yorum içerebilir.

Review sınıfı, ilişkilendirme ve yazar ilişkilendirmesi de içerebilir. Yorumu uygulamanızda gösteriyorsanız ilişkilendirmeyi veya yazar ilişkilendirmesini de göstermeniz gerekir. Daha fazla bilgi için Yorum görüntüleme bölümüne bakın.

Daha fazla bilgi için ilişkilendirmeler hakkındaki dokümanları inceleyin.

Yer adı dil koduna erişme

Mevcut Place.getName() yöntemi, bir yerin adını içeren bir metin dizesi döndürür. Place nesnesini yer adıyla doldurmak için Place.Field.DISPLAY_NAME değerini yer ayrıntıları isteğinin alan listesine eklemeniz gerekir.

Place nesnesi artık ad dizesinin dil kodunu içeriyor. Place nesnesini dil koduyla doldurmak için:

  1. İsteğin alan listesine Place.Field.DISPLAY_NAME öğesini ekleyin. Bu değer, yanıtı Place nesnesine hem yer adını hem de dil kodunu içerecek şekilde yapılandırır.

  2. PlacesClient.fetchPlace() numaralı telefonu arayın. PlacesClient.findCurrentPlace(), dil kodu alanını desteklemiyor.

  3. Place nesnesinde dil kodu alanına erişmek için Place.getNameLanguageCode() yöntemini kullanın.

Bölge kodunu ayarlama

Android için Yerler SDK'sı (Yeni), bölge kodu istek parametresini Yer Ayrıntıları'na ekler. Bölge kodu, yanıtı biçimlendirmek için kullanılır ve iki karakterli CLDR kodu değeri olarak belirtilir. Bu parametre, arama sonuçlarında da önyargı etkisi yaratabilir. Varsayılan değer yoktur. Bölge kodunu ayarlamak için yeni SDK'yı etkinleştirmeniz gerekir.

Yanıttaki adres alanının ülke adı bölge koduyla eşleşirse ülke kodu adresten çıkarılır.

CLDR kodlarının çoğu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için). Parametre, geçerli yasaya göre sonuçları etkileyebilir.

Örnek istek

Tam bir örnek için Yer Ayrıntıları (Yeni) başlıklı makaleyi inceleyin.