遷移至 Text Search (新功能)

Places API 支援現有的 Text Search。如果您熟悉 Text Search、 新版 Text Search 進行下列變更:

  • 新版 Text Search 會使用 HTTP POST 要求。通過 參數。 相較之下,現有的 Text Search 使用 HTTP GET 要求的網址參數。
  • 必須遮蓋欄位。您必須指定要傳回的欄位 回應。沒有預設的傳回欄位清單。如果您省略 清單中,這些方法會傳回錯誤。若需更多資訊,請參閲 FieldMask
  • 新版 Text Search 同時支援兩種 API 金鑰OAuth 權杖做為驗證機制。
  • 新的 文字搜尋。
  • 現有的 Text Search 可讓您指定經緯度 字串中的座標。例如:query=37.4239,-122.0925。 新版文字搜尋不支援這個選項。

    使用 反向地理編碼 搜尋座標並傳回地址。 Nearby Search (新版) 來尋找特定位置附近的地點

  • Text Search 的 JSON 回應格式 (新版) API 已變更現有 API 的格式。詳情請參閱 遷移 Places API 回應

下表列有現有參數 重新命名或修改的 新的 Text Search,或是不再的參數 。

目前的參數 新增參數 附註
evOptions 新參數。
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken 不支援。
query textQuery 所有要求均須具備。
radius locationBias 定義 locationBias 時指定半徑。
region regionCode
type includedType 僅接受單一值。
strictTypeFiltering 新參數。

要求範例

下列範例 GET 要求會使用現有的 文字搜尋。在這個範例中,您要求取得 JSON 檔案 回覆中包含有關「Spicy Vegetarian Food in Sydney」的資訊, 澳洲」然後將所有參數做為網址參數傳遞:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY

使用 Text Search (新版) 時,傳送 POST 要求和 將 JSON 要求主體或標頭中的所有參數,做為 POST 的一部分傳遞 請求。這個示例也使用了欄位遮罩,因此回應只包含 地點的顯示名稱和格式化地址:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'