Places API 支援現有的 搜尋附近： 如果你很熟悉現有的「搜尋附近」功能， 新版 Nearby Search 進行下列變更：
- 新的「搜尋附近」應用程式會使用 HTTP POST 要求。 將參數做為 HTTP POST 的一部分，傳入要求主體或標頭中 請求。相較之下，現有的「搜尋附近」功能 您利用 HTTP GET 要求傳遞網址參數
- 必須遮蓋欄位。您必須指定要傳回的欄位 回應。沒有預設的傳回欄位清單。如果您省略 清單中，這些方法會傳回錯誤。若需更多資訊，請參閲 FieldMask。
- 全新的「搜尋附近」功能同時支援 API 金鑰 和 OAuth 做為驗證機制
- 新的 Nearby Search。
- 所有包含文字查詢的要求現在應使用 Text Search (新版) 因為 Nearby Search (新版) 不支援文字輸入。
- Nearby Search 的 JSON 回應格式 (新版) API 已變更現有 API 的格式。詳情請參閱 遷移 Places API 回應。
下表列有現有參數 使用者將「附近」一詞重新命名或修改， 新的「附近搜尋」，或是不再適用的參數 支援。
| 目前的參數 | 新增參數 | 附註 |
|---|---|---|
keyword |
不支援。使用 Text Search (新版) 。 | |
language |
languageCode |
|
location |
locationRestriction |
必填。 |
maxprice/minprice |
|
不支援。 |
maxResultCount |
新參數。 | |
opennow |
|
不支援。 |
pagetoken |
不支援。 | |
radius |
|
立即使用 locationRestriction。 |
rankby |
rankPreference |
|
regionCode |
新參數。 | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
新參數也接受多種類型值。現有 API 只接受一個值。 |
要求範例
下列範例 GET 要求會使用現有的
Nearby Search。在這個範例中，您要求取得 JSON 檔案
包含 restaurant 類型地點資訊的回應，並傳遞全部
參數做為網址參數：
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
使用 Nearby Search (新版) 時，傳送 POST 要求和 將 JSON 要求主體或標頭中的所有參數，做為 POST 的一部分傳遞 請求。這個示例也使用了欄位遮罩，因此回應只包含 地點的顯示名稱和格式化地址：
curl -X POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby