Place Details (最新)

選取平台： Android iOS JavaScript 網頁服務

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

取得地點 ID 的方法有很多種，例如：

• Text Search (新版)
• Nearby Search (新版)
• 自動完成 (新版)

，瞭解如何調查及移除這項存取權。

注意： Places SDK 提供 Place Details (新版) 。詳情請參閱「選擇 SDK 版本。

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

注意：如要進一步瞭解如何初始化 PlacesClient，請參閱 初始化 Places API 用戶端。

您可以使用 CancellationToken 嘗試取消傳送至任何要求類別的要求 (例如， FetchPlaceRequest)。取消作業會盡可能完成。 提出取消要求後，系統不會傳回任何回應。 核發取消憑證並「不保證」特定要求 將遭到取消，即使沒有 回應。

Place Details (新) 回應

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

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

必要參數

如要使用 FetchPlaceRequest敬上 是：

• 地點 ID

  可識別特定地點的文字 ID，從 Text Search (新版)， 搜尋附近地點 (新版)，或 自動完成 (新版)： 如要進一步瞭解地點 ID，請參閱 地點 ID 總覽。

• 欄位清單

  要求地點時，必須指定要傳回的地點資料。目的地： 操作時，請傳遞 Place.Field 值清單 指定要傳回的資料沒有預設的 傳回的 欄位。

  欄位清單是不錯的設計做法，可確保您不要要求這些清單 不必要的資料，有助於避免不必要的處理時間，並 產生帳單費用時 這會影響每個請求的費用若需更多資訊，請參閲 使用方式 以及帳單。

  指定下列一或多個欄位：

  • 下列欄位會觸發 Place Details (僅限 ID) SKU：

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

  • 下列欄位會觸發 Place Details (Location Only) SKU：

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

  • 下列欄位會觸發 Place Details (基本) SKU：

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

  • 下列欄位會觸發 Place Details (進階) SKU：

    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

  • 下列欄位會觸發 Place Details (Preferred) SKU:

    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。 。

選用參數

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

• 區域代碼

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

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

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

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

• 工作階段符記

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

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

Place Details 範例

以下範例會要求以下項目的 ID、NAME 和 ADDRESS 欄位： 紐約市帝國大廈。

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