Yer Ayrıntıları (Yeni)

Belirli bir işletme veya önemli nokta hakkında daha fazla bilgi edinmek için yer kimliğini kullanarak Yer Ayrıntıları (Yeni) isteğinde bulunabilirsiniz. Yer Ayrıntıları (Yeni), belirtilen yer hakkında tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi daha kapsamlı bilgiler döndürür.

Yer kimliği edinmenin birçok yolu vardır. Şunları kullanabilirsiniz:

• Text Search (New)
• Yakında Arama (Yeni)
• Autocomplete (New)

Yer Ayrıntıları (Yeni) istekleri

PlacesClient.fetchPlace() yöntemini çağırıp yer kimliği ve alan listesi içeren bir FetchPlaceRequest nesnesi ve isteğe bağlı parametreler ileterek yer ayrıntılarını isteyebilirsiniz:

// 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);

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

Yer Ayrıntıları (Yeni), Place nesnesi biçiminde veri döndürür. Bu nesne, yalnızca alan listesini kullanarak istediğiniz alanları içerir. Yer verisi sonuçları boş olamaz. Bu nedenle, yalnızca veri içeren yer sonuçları döndürülür (örneğin, istenen bir yerin fotoğrafı yoksa sonuçta fotoğraf alanı bulunmaz).

Veri alanlarına erişmek için ilgili yöntemi çağırın. Örneğin, yer adına erişmek için getName() yöntemini çağırın.

Gerekli parametreler

FetchPlaceRequest için gerekli parametreler şunlardır:

• Yer kimliği

  Text Search (New), Yakında Arama (New) veya Autocomplete (New) tarafından döndürülen ve bir yeri benzersiz şekilde tanımlayan metin tanımlayıcı. Yer kimlikleri hakkında daha fazla bilgi için yer kimliğine genel bakış bölümünü inceleyin.

• Alan listesi

  Bir yer istediğinizde hangi yer verilerinin döndürüleceğini belirtmeniz gerekir. Bunu yapmak için döndürülecek verileri belirten bir Place.Field değerleri listesi iletin. Yanıtta döndürülen alanların varsayılan bir listesi yoktur.

  Alan listeleri, gereksiz veriler istememenizi sağlayan iyi bir tasarım uygulamasıdır. Bu sayede gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınabilirsiniz. Bu liste, her isteğin maliyetini etkilediği için önemli bir husustur. Daha fazla bilgi için Kullanım ve Faturalandırma bölümüne bakın.

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

  • Aşağıdaki alanlar, Yer Ayrıntıları Essentials IDs Only SKU'yu tetikler:

    Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
    kullanın.

    Alanların ve ilişkili SKU'larının tam listesi için Yer Verileri Alanları (Yeni) başlıklı makaleyi inceleyin.

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

    Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
        * Place.Field.ADDRESS (desteği sonlandırıldı) yerine kullanın.
    Place.Field.LOCATION*
        * Place.Field.LAT_LNG (desteği sonlandırıldı) yerine kullanın.
    Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

    Alanların ve ilişkili SKU'larının tam listesi için Yer Verileri Alanları (Yeni) başlıklı makaleyi inceleyin.

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

    Place.Field.ACCESSIBILITY_OPTIONS*
        * Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE yerine kullanın (desteği sonlandırıldı).
    Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
        * Desteği sonlandırılan Place.Field.NAME yerine kullanın.
    Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
        * Place.Field.ICON_URL (desteği sonlandırıldı) yerine kullanın.
    Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

    Alanların ve ilişkili SKU'larının tam listesi için Yer Verileri Alanları (Yeni) başlıklı makaleyi inceleyin.

  • Aşağıdaki alanlar, Yer Ayrıntıları Kurumsal SKU'sunu tetikler:

    Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
        * Desteği sonlandırılan Place.Field.PHONE_NUMBER yerine kullanın.
    Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT*
        * Desteği sonlandırılan Place.Field.USER_RATINGS_TOTAL yerine kullanın.
    Place.Field.WEBSITE_URI

    Alanların ve ilişkili SKU'larının tam listesi için Yer Verileri Alanları (Yeni) başlıklı makaleyi inceleyin.

  • Aşağıdaki alanlar Yer Ayrıntıları Enterprise Plus SKU'sunu tetikler:

    Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT

    Alanların ve ilişkili SKU'larının tam listesi için Yer Verileri Alanları (Yeni) başlıklı makaleyi inceleyin.

İsteğe bağlı parametreler

FetchPlaceRequest için isteğe bağlı parametreler şunlardır:

• Bölge kodu

  Yanıtı biçimlendirmek için kullanılan ve iki karakterli CLDR kodu değeri olarak belirtilen bölge kodu. Varsayılan değer yoktur.

  Yanıttaki Place.Field.FORMATTED_ADDRESS alanının ülke adı regionCode ile eşleşirse ülke kodu Place.Field.FORMATTED_ADDRESS alanından çıkarılır.

  Çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır ancak bazı önemli istisnalar vardı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.

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

• Oturum jetonu

  Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını "oturum" olarak izleyen, kullanıcı tarafından oluşturulan dizelerdir. Otomatik tamamlama (yeni), faturalandırma amacıyla bir kullanıcı otomatik tamamlama aramasının sorgu ve yer seçimi aşamalarını ayrı bir oturumda gruplandırmak için oturum jetonlarını kullanır. Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarından sonra gelen Yer Ayrıntıları (Yeni) çağrılarına iletilir. Daha fazla bilgi için Oturum jetonları başlıklı makaleyi inceleyin.

  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, New York'taki Empire State Binası için ID, DISPLAY_NAME ve FORMATTED_ADDRESS alanları istenmektedir.

// 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.DISPLAY_NAME, Place.Field.FORMATTED_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);