Method: searchText

透過文字查詢搜尋地點。

HTTP 要求

POST https://mapstools.googleapis.com/v1:searchText

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
欄位
textQuery

string

必填。文字查詢。
languageCode

string

(選用步驟) 要求傳回摘要時使用的語言。如果未指定或無法辨識語言代碼，系統會傳回英文摘要。

例如「en」代表英文。

目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。
regionCode

string

(選用步驟) 要求來源位置的 Unicode 國家/地區代碼 (CLDR)。這個參數用於顯示地點詳細資料，例如特定區域的地點名稱 (如有)。這項參數可能會根據適用法律影響結果。

例如「US」代表美國。

詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

請注意，目前不支援 3 位數的區域代碼。
pageSize

integer

(選用步驟) 要傳回的地點數量上限，最多 10 個。服務傳回的產品數量可能會少於這個值。預設值為 5。

如果要求超過 5 個地點，系統會觸發 Pro 級方案，並產生較高的已計費用和延遲時間。
includeExtendedDetails

boolean

(選用步驟) 在回應中加入延伸地點詳細資料。

如果使用者要求需要豐富的質性洞察、即時動態或專業實體屬性，請將這個欄位設為 true：- 質性評論、顧客情緒和意見回饋。- 特色餐點，例如菜單品項、菜餚、特色美食、飲料或商家亮點。- 氣氛、室內裝潢、美感、氛圍或情調的品質。- 即時資料和特殊設施規格、訪客政策/提示、等待時間。

如要進行標準探索搜尋 (例如料理、商店類型)、位置/地址查詢、聯絡資訊、營業時間和標準中繼資料/設施，請保留 false (預設)。

啟用這個欄位會觸發 Pro 級別，並產生較高的已計費用和延遲時間。
locationBias

object (LocationBias)

可選填，用於偏重搜尋結果的區域。如果 textQuery 中有明確位置，系統會使用該位置 (而非這個欄位) 偏重搜尋結果。

回應主體

如果成功，回應主體會包含 SearchTextResponse 的執行個體。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/maps-platform.mapstools