Method: places.get

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

string

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

string

選用設定。系統會以偏好語言 (如有) 顯示地點詳細資料。

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

string

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

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

string

選用設定。用於計費的 Autocomplete 工作階段識別字串。必須是安全的 base64 字串，且長度不得超過 36 個 ASCII 字元。否則會傳回 INVALID_ARGUMENT 錯誤。

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

建議您遵循下列準則：

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