Yer Ayrıntıları (Yeni)

Platform seçin: Android iOS JavaScript Web Hizmeti

Belirli bir tesis ya da işletme noktası hakkında daha fazla bilgi yerini kullanarak kimliği belirleme ve Yer Ayrıntıları (Yeni) isteği. Yer Ayrıntıları (Yeni) daha kapsamlı iadeler belirtilen yerle ilgili bilgiler (ör. tam adresi, telefon numarası) kullanıcı oyları ve yorumları dahil edilir.

Yer kimliğini almanın birçok yolu vardır. Şunları kullanabilirsiniz:

• Metin Arama (Yeni)
• Yakında Arama (Yeni)
• Otomatik tamamlama (Yeni)

Not: Yer Ayrıntıları (Yeni), Yerler SDK'sında kullanıma sunuldu Android 3.3.0 ve sonraki sürümler için geçerlidir. Daha fazla bilgi için SDK'nızı seçme konusuna bakın sürümünü indirin.

Yer Ayrıntıları (Yeni) istekleri

Şu numarayı arayarak yer ayrıntılarını isteyebilirsiniz: PlacesClient.fetchPlace() ve FetchPlaceRequest yer kimliği ve alan listesi de içeren nesne (isteğe bağlı parametreler gibi)

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

.

Not: PlacesClient uygulamasını başlatma hakkında daha fazla bilgi için bkz. Places API istemcisini başlatın.

CancellationToken kullanabilirsiniz. (örneğin, FetchPlaceRequest). İptal işlemi en iyi çaba esasına göre gerçekleştirilir. İptal isteği gönderildiğinde yanıt döndürülmez. İptal jetonu vermek, belirli bir isteğin gerçekleşeceğini garanti ETMEZ iptal edilir ve iptal edilebilse bile söz konusu istek için döndürülmesi gerekir.

Yer Ayrıntıları (Yeni) yanıtları

Yer Ayrıntıları (Yeni), verileri Place nesnesi (alanını kullanarak istediğiniz alanları içerir) liste'yi tıklayın. Yer verisi sonuçları boş bırakılamaz, bu nedenle yalnızca konum sonuçları gösterilir verilerin döndürülmesi (örneğin, istenen bir yerde hiç fotoğraf yoksa, fotoğraf alanı sonuçta görünmez).

Veri alanlarına erişmek için ilgili method ile kullanılabilir. Örneğin, yer adına erişmek için getName() numaralı telefonu arayın.

Gerekli parametreler

Şunun için gerekli parametreler: FetchPlaceRequest şunlardır:

• Yer kimliği

  Bir araçtan alınan, bir yeri benzersiz şekilde tanımlayan metinsel bir tanımlayıcı Metin Arama (Yeni), Yakında Arama (Yeni) veya Otomatik tamamlama (Yeni). Yer kimlikleri hakkında daha fazla bilgi için bkz. yer kimliğine genel bakış.

• Alan listesi

  Bir yer isteğinde bulunduğunuzda, hangi yer verilerinin döndürüleceğini belirtmeniz gerekir. Alıcı: bunu yapmak için Place.Field değerlerinin bir listesini iletin. döndürülecek verileri belirtme. Varsayılan bir döndüren alan adları belirleyebilirsiniz.

  Alan listeleri, bir istek gönderen kullanıcı için Böylece, gereksiz işlem süresini ve ele alacağız.Bu liste, teşhis işlemi sırasında çünkü her isteğin maliyetini etkiler. Daha fazla bilgi için bkz. Kullanım ve Faturalandırma.

  Aşağıdaki alanlardan birini veya daha fazlasını belirtin:

  • Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Kimlikler) SKU'sunu tetikler:

    Place.Field.ID, Place.Field.NAME, Place.Field.PHOTO_METADATAS

  • Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Konum) SKU'sunu tetikler:

    Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT

  • Aşağıdaki alanlar Yer Ayrıntıları (Temel) SKU'sunu tetikler:

    Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

  • Aşağıdaki alanlar Yer Ayrıntıları (Gelişmiş) SKU'sunu tetikler:

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

  • Aşağıdaki alanlar Yer Ayrıntıları (Tercih Edilen) SKU'sunu tetikler:

    Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

İsteğe bağlı parametreler

FetchPlaceRequest şunlardır:

• Bölge kodu

  Yanıtı biçimlendirmek için kullanılan bölge kodu, CLDR kodu değerini girin. Varsayılan bir değer yok.

  Yanıttaki Place.Field.ADDRESS alanının ülke adı regionCode, ülke kodu Place.Field.ADDRESS öğesinden atlandı.

  Çoğu CLDR kodu ISO 3166-1 kodlarıyla aynıdır. bazı önemli istisnalarla birlikte. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu "gb" ise (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı"). Parametre, geçerli yasalara göre sonuçları etkileyebilir.

  Bölge kodu parametresini ayarlamak için FetchPlaceRequest nesnesini oluştururken setRegionCode() yöntemini çağırın.

• Oturum jetonu

  Oturum jetonları, etkinlikleri izleyen kullanıcı tarafından oluşturulmuş Aramaları "oturumlar" olarak otomatik tamamlama (yeni). Otomatik Tamamlama (Yeni), şunları yapmak için oturum jetonlarını kullanır: bir kullanıcı otomatik tamamlama aramasının sorgu ve yer seçimi aşamalarını ayrı bir oturumda gruplandırmak . Oturum jetonları Yer Ayrıntılarına aktarılır (Yeni) Otomatik tamamlama (Yeni) aramalarını takip eden aramalar Daha fazla bilgi için bkz. Oturum jetonları.

  Oturum jetonu parametresini ayarlamak için FetchPlaceRequest nesnesini oluştururken setSessionToken() yöntemini çağırın.

Yer Ayrıntıları örneği

Aşağıdaki örnekte,IDNAMEADDRESS New York'taki Empire State Binası

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);