Place Details (最新)

您可以要求更多與特定建築物或某個地點相關的詳細資料 搜尋曝光 ID並製作 Place Details (新) 要求。 Place Details (新版) 會傳回更詳盡的 地點的相關資訊,例如完整地址、電話 數字、使用者評分和評論

取得地點 ID 的方法有很多種,例如:

Place Details (新) 要求

您可以呼叫下列電話號碼,要求取得地點詳細資料: PlacesClient.fetchPlace()敬上 然後傳送 FetchPlaceRequest 包含地點 ID欄位清單的物件,以及 例如任何選用參數

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

Place Details (新) 回應

Place Details (新版) 會以 Place敬上 物件,只包含您使用 欄位所要求的欄位 list。地點資料結果不可空白,因此請只提供地點結果 帶有資料 (例如,如果要求的地點沒有相片,則 但相片中不會顯示相片欄位)。

如要存取資料欄位,請呼叫 方法。 舉例來說,如要存取地點名稱,請呼叫 getName()

必要參數

如要使用 FetchPlaceRequest敬上 是:

選用參數

這是 Google 提供的選用參數 FetchPlaceRequest 是:

  • 區域代碼

    用於設定回應格式的區碼,以 也就是雙字元 CLDR 代碼值。沒有預設值。

    如果回應中 Place.Field.ADDRESS 欄位的國家/地區名稱與 regionCodePlace.Field.ADDRESS 中省略了國家/地區代碼。

    大部分 CLDR 代碼與 ISO 3166-1 代碼相同 有一些值得注意的例外情況舉例來說,英國的 ccTLD 是 "uk"(.co.uk),但 ISO 3166-1 代碼卻是「gb」(技術上來說 「大不列顛暨北愛爾蘭聯合王國」)。 這個參數會根據適用法律影響結果。

    如要設定區碼參數,請在建立 FetchPlaceRequest 物件時呼叫 setRegionCode() 方法。

  • 工作階段符記

    工作階段符記是使用者產生的字串,可追蹤 自動完成 (新) 呼叫做為「工作階段」。自動完成 (新版) 會使用工作階段符記, 將使用者自動完成搜尋的查詢和地點選擇階段歸入不同的工作階段 做為帳單用途工作階段符記會傳送至 Place Details (新) 呼叫。若需更多資訊,請參閲 工作階段符記

    如要設定工作階段符記參數,請在建立 FetchPlaceRequest 物件時呼叫 setSessionToken() 方法。

Place Details 範例

以下範例會要求以下項目的 IDNAMEADDRESS 欄位: 紐約市帝國大廈。

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