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'