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

Android için Yerler SDK'sı, mevcut yer ayrıntılarını destekler. Android için mevcut 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'ler için fiyatlandırma bilgileri Android için Yerler SDK'sı (Yeni) başlıklı makalede verilmiştir.

  • 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 kendisiyle ilişkili bir veya daha fazla tür değeri olabilir. Android için Yerler SDK'sının 3.3.0 ve sonraki sürümleri birçok yeni tür değeri ekler. Tam listeyi Genişletilmiş yer türleri başlıklı makalede bulabilirsiniz.

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 ve B tablolarında 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 listeye dahil değildir.

Yer yorumlarına erişme

Android için Yerler SDK'sı (Yeni), bir yerin yorumunu 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. İncelemeyi uygulamanızda gösteriyorsanız ilişkilendirme 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'yi yer ayrıntıları isteğinin alan listesine eklemeniz gerekir.

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

  1. Place.Field.DISPLAY_NAME değerini isteğin alan listesine 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ı desteklemez.

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

Bölge kodu ayarlama

Android için Yerler SDK'sı (Yeni), bölge kodu istek parametresini Yer Ayrıntıları'na ekler. Yanıtı biçimlendirmek için kullanılan bölge kodu, iki karakterli bir 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 "Birleşik Krallık ve Kuzey İrlanda" 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.