Places API 支援現有的 Place Details。 如果您熟悉現有的 Places API 新版 Place Details 進行下列變更:
- 必須遮蓋欄位。您必須指定要傳回的欄位 回應。沒有預設的傳回欄位清單。如果您省略 清單中,這些方法會傳回錯誤。詳情請參閱「FieldMask」。
- 新的 Place Details 支援這兩種格式 API 金鑰 和 OAuth 做為驗證機制
- 新版 Place Details 僅支援 JSON 回應格式。
- Place Details 的 JSON 回應格式 (新版) API 已變更現有 API 的格式。詳情請參閱 遷移 Places API 回應。
下表列有現有參數 已重新命名或修改的地點詳細資料 新的 Place Details,或不再適用的參數 支援。
目前的參數 | 新增參數 | 附註 |
---|---|---|
place_id |
places/PLACE_ID |
字串 places/PLACE_ID 也稱為地點資源名稱。在 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 要求的回應中,這個字串會包含在回應的 name 欄位中。獨立地點 ID 包含在回應的 id 欄位中。 |
language |
languageCode |
|
region |
regionCode |
要求範例
以下範例 GET 要求會使用現有的 Place Details。在這個範例中,您會要求 JSON 回應,其中包含地點 ID 相關資訊,並將所有參數設為網址參數。這個範例也使用 fields
,因此回應只包含
地點的顯示名稱和格式化地址:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
使用 Place Details (新版) 時,您可以發出 GET 要求,並將網址參數和標頭中的所有參數,做為要求的一部分傳遞。這個 這個範例也會使用欄位遮罩,因此回應只會包含顯示名稱 地點的地址和格式化地址:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
字串 places/PLACE_ID
也稱為位置資源名稱。Place Details 回應中
(新版)、Nearby Search (新版),以及
Text Search (新版) 要求,這個字串已包含在
回應的 name
欄位。獨立地點 ID 位於
回應的 id
欄位。