Places Widgets

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Autocomplete 類別

google.maps.places.Autocomplete 類別

可根據使用者輸入文字提供 Place 預測的小工具。它會附加至 text 類型的輸入元素,並監聽該欄位中的文字輸入。預測清單會以下拉式清單的形式顯示,並在輸入文字時更新。

此類別會擴充 MVCObject

使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

使用 v=beta 時,可透過呼叫 const {Autocomplete} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫

Autocomplete
Autocomplete(inputField[, opts])
參數:
建立 Autocomplete 的新執行個體,以指定選項在指定的輸入文字欄位中附加。
getBounds
getBounds()
參數:
傳回值:LatLngBounds|undefined 自訂調整的邊界。
傳回預測的偏誤。
getFields
getFields()
參數:
傳回值:Array<string>|undefined
成功擷取詳細資料時,會傳回要納入詳細資料回應的欄位。如需欄位清單,請參閱 PlaceResult
getPlace
getPlace()
參數:
傳回值:PlaceResult使用者選取的地點。
如果成功擷取詳細資訊,則傳回使用者所選的「地點」詳細資料。否則會傳回一個虛設地點 Place 物件,並將 name 屬性設定為輸入欄位的目前值。
setBounds
setBounds(bounds)
參數:
傳回值:
設定傳回「地點」結果的偏好地區。結果會偏向 (但不限於) 這個區域。
setComponentRestrictions
setComponentRestrictions(restrictions)
參數:
傳回值:
設定元件限制。元件限制可用於將預測限制在父項元件內部預測。例如國家/地區。
setFields
setFields(fields)
參數:
  • fieldsArray<string> optional
傳回值:
設定在成功擷取詳細資料時,要納入詳細資料回應中的「地點」欄位。如需欄位清單,請參閱 PlaceResult
setOptions
setOptions(options)
參數:
傳回值:
setTypes
setTypes(types)
參數:
  • typesArray<string> optional要納入的預測類型。
傳回值:
設定要傳回的預測類型。如需支援的類型,請參閱開發人員指南。如未指定類型,系統將傳回所有類型。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
place_changed
function()
引數:
當為所選地點提供 PlaceResult 時,會觸發此事件。
如果使用者輸入的控制項名稱不是由控制項所建議,然後按下 Enter 鍵;如果「地點詳細資料」要求失敗,PlaceResult 就會在 name 屬性中加入使用者輸入內容,且並未定義其他屬性。

AutocompleteOptions 介面

google.maps.places.AutocompleteOptions 介面

可在 Autocomplete 物件上設定的選項。

使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

bounds optional
用來搜尋地點的區域。
componentRestrictions optional
類型:ComponentRestrictions optional
元件限制。元件限制可用於將預測限制在父項元件內部預測。例如國家/地區。
fields optional
類型:Array<string> optional
成功擷取詳細資料後,要加入詳細資料回應中的「地點」欄位,系統會向這些商家收費。如果傳入 ['ALL'],系統會傳回所有可用欄位,並為其收費 (不建議為實際工作環境部署)。如需欄位清單,請參閱 PlaceResult。您可以使用巢狀路徑 (例如 "geometry.location") 指定巢狀欄位。預設值為 ['ALL']
placeIdOnly optional
類型:boolean optional
是否只擷取地點 ID。當 place_changed 事件觸發時,系統可提供的 PlaceResult 只會含有 place_id、類型和名稱欄位,包含自動完成服務傳回的 place_id、類型和說明。預設為停用。
strictBounds optional
類型:boolean optional
布林值,表示「自動完成」小工具只應在傳送查詢時,傳回其在「自動完成」小工具邊界內的。將 strictBounds 設定為 false (預設值) 時,會將結果偏誤到指定範圍內的地點。
types optional
類型:Array<string> optional
要傳回的預測類型。如需支援的類型,請參閱開發人員指南。如未指定類型,系統將傳回所有類型。

google.maps.places.SearchBox 類別

可根據使用者輸入文字提供查詢預測的小工具。它會附加至 text 類型的輸入元素,並監聽該欄位中的文字輸入。預測清單會以下拉式清單的形式顯示,並在輸入文字時更新。

此類別會擴充 MVCObject

使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

使用 v=beta 時,可透過呼叫 const {SearchBox} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫

SearchBox
SearchBox(inputField[, opts])
參數:
建立 SearchBox 的新執行個體,以指定選項在指定的輸入文字欄位中附加。
getBounds
getBounds()
參數:
傳回值:LatLngBounds|undefined
傳回查詢預測的偏誤。
getPlaces
getPlaces()
參數:
傳回值:Array<PlaceResult>|undefined
傳回使用者選擇要與 places_changed 事件搭配使用的查詢。
setBounds
setBounds(bounds)
參數:
傳回值:
設定要用來調整查詢預測偏誤的地區。結果只會偏向此區域,而且不會完全限制。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
places_changed
function()
引數:
使用者選取查詢時,會觸發此事件。應使用 getPlaces 來取得新地點。

SearchBoxOptions 介面

google.maps.places.SearchBoxOptions 介面

可在 SearchBox 物件上設定的選項。

使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

bounds optional
用於調整查詢預測的面積。預測值會偏向 (但不限於) 指定這些邊界的查詢。