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_UNIT 錯誤。

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

我們建議遵循下列規範：

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