Method: places.get

根據地點的資源名稱 (places/{placeId} 格式的字串) 取得詳細資料。

HTTP 要求

GET https://places.googleapis.com/v1/{name=places/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必填。地點的資源名稱，格式為 places/{placeId}。

查詢參數

參數
languageCode

string

(選用步驟) 如果地點詳細資料有提供偏好語言版本，系統就會顯示該版本。

目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。
regionCode

string

(選用步驟) 要求來源地點的 Unicode 國家/地區代碼 (CLDR)。這個參數用於顯示地點詳細資料，例如特定區域的地點名稱 (如有)。根據適用法律，這項參數可能會影響結果。詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

請注意，系統目前不支援 3 位數的區域代碼。
sessionToken

string

(選用步驟) 用於識別 Autocomplete 工作階段的字串，以利計費。必須是網址和檔案名稱安全 Base64 字串，長度最多為 36 個 ASCII 字元。否則會傳回 INVALID_ARGUMENT 錯誤。

工作階段是從使用者輸入查詢時開始，到使用者選取地點並呼叫 Place Details 或地址驗證時結束。在每個工作階段中，使用者可以輸入多筆查詢，最終提出一項 Place Details 或地址驗證要求。工作階段中每項要求使用的憑證，都必須屬於同一個 Google Cloud 控制台專案。工作階段結束後，符記就會失效。您的應用程式必須為每個工作階段產生新的符記。如果省略 sessionToken 參數或重複使用工作階段符記，系統會視為未提供工作階段符記，並針對工作階段收費 (每個要求分別收費)。

建議遵循下列準則：

  • 在所有 Place Autocomplete 呼叫中使用工作階段符記。
  • 為每個工作階段產生新的符記。建議使用第 4 版 UUID。
  • 請確保工作階段中所有 Place Autocomplete、Place Details 和地址驗證要求使用的憑證，都屬於同一個 Cloud 控制台專案。
  • 請務必針對每個新的工作階段傳遞不重複的工作階段符記。如果多個工作階段使用同一個符記，則每個要求會分別計費。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 Place 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform