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

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Android için Yerler SDK'sı, Yer Ayrıntıları (Eski)'nı destekler. Android için Yerler SDK'sını (Eski) biliyorsanız Yer Ayrıntıları (Yeni) aşağıdaki değişiklikleri yapar:

  • 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. Rehber API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama başlıklı makaleyi inceleyin.

  • Alan maskeleme gereklidir. Yanıtta hangi alanların döndürülmesini istediğinizi belirtmeniz gerekir. Döndürülen alanların varsayılan bir 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 yerle 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ümlerinde birçok yeni tür değeri eklenmiştir. 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'sının sürümünüze bağlıdır:

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

  • Android için Yerler SDK'sı: Place.Types tarafından tanımlanan numaralandırılmış türleri döndürür. Bu türler, 3.3.0 ve sonraki sürümlerde eklenen yeni türleri içermez.

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. 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 başlıklı makaleye bakın.

Daha fazla bilgi için ilişkilendirmeler hakkındaki belgelere göz atın.

Yer adı dil koduna erişme

Android için Yerler SDK'sında (Eski), 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 yer ayrıntıları isteğinin alan listesine Place.Field.DISPLAY_NAME öğesini eklemeniz gerekir.

Place nesnesi artık ad dizesinin dil kodunu içeriyor. Place nesnesini dil koduyla doldurmak için şunları yapmanız gerekir:

  1. İsteğin alan listesine Place.Field.DISPLAY_NAME öğesini ekleyin. Bu değer, yanıtta hem yer adının hem de dil kodunun Place nesnesine dahil edilmesini yapılandırır.

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

  3. Place nesnesindeki 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), Yer Ayrıntıları'na bölge kodu istek parametresini 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ı üzerinde de bir önyargı etkisi yaratabilir. Varsayılan değer yoktur. Bölge kodunu ayarlamak için yeni SDK'yı etkinleştirmeniz gerekir.

Yanıtın adres alanındaki ülke adı, bölge koduyla eşleşiyorsa ülke kodu adresten çıkarılır.

Bazı önemli istisnalar dışında çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "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

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