遷移至 Nearby Search (新功能)

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 includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
新參數也接受多個類型值。現有 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