遷移至 Nearby Search (新功能)

歐洲經濟區 (EEA) 開發人員

簡介

Places API 支援鄰近搜尋 (舊版)。如果您熟悉 Nearby Search (舊版)，Nearby Search (新版) 有以下異動：

  • Nearby Search (新版) 使用 HTTP POST 要求。 在要求主體或標頭中傳遞參數，做為 HTTP POST 要求的一部分。相較之下，Nearby Search (舊版) 則是使用 HTTP GET 要求傳遞網址參數。
  • 必須提供欄位遮罩。您必須指定要在回應中傳回哪些欄位。系統沒有預設的傳回欄位清單。如果省略這份清單，方法會傳回錯誤。詳情請參閱 FieldMask。
  • Nearby Search (新版) 支援 API 金鑰和 OAuth 權杖做為驗證機制。
  • Nearby Search (新版) 僅支援 JSON 回應格式。
  • Nearby Search (新版) 不支援文字輸入，因此所有包含文字查詢的要求，現在都應使用 Text Search (新版)。
  • Nearby Search (新版) 的 JSON 回應格式與舊版 API 不同。詳情請參閱「遷移 Places API 回應」。

下表列出 Nearby Search (舊版) 中，已重新命名或修改為 Nearby Search (新版) 的參數，或是不再支援的參數。

目前參數 新增參數 附註
keyword 不支援。請改用 Text Search (New)。
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