Places Widgets

Autocomplete 類別

google.maps.places.Autocomplete 類別

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

此類別會擴充 MVCObject。

必須使用 &libraries=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)
參數：
  • fields：Array<string> optional
傳回值：無
設定在成功擷取詳細資料時，要納入詳細資料回應中的「地點」欄位。如需欄位清單，請參閱 PlaceResult。
setOptions
setOptions(options)
參數：
傳回值：無
setTypes
setTypes(types)
參數：
  • types：Array<string> optional要納入的預測類型。
傳回值：無
設定要傳回的預測類型。如需支援的類型，請參閱開發人員指南。如未指定類型，系統將傳回所有類型。
繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
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 中的程式庫。
SearchBox
SearchBox(inputField[, opts])
參數：
建立 SearchBox 的新執行個體，以指定選項在指定的輸入文字欄位中附加。
getBounds
getBounds()
參數：無
傳回值：LatLngBounds|undefined
傳回查詢預測的偏誤。
getPlaces
getPlaces()
參數：無
傳回值：Array<PlaceResult>|undefined
傳回使用者選擇要與 places_changed 事件搭配使用的查詢。
setBounds
setBounds(bounds)
參數：
傳回值：無
設定要用來調整查詢預測偏誤的地區。結果只會偏向此區域，而且不會完全限制。
繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
places_changed
function()
引數：無
使用者選取查詢時，會觸發此事件。應使用 getPlaces 來取得新地點。

SearchBoxOptions 介面

google.maps.places.SearchBoxOptions 介面

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

必須使用 &libraries=places 網址參數。請參閱 Maps JavaScript API 中的程式庫。
bounds optional
用於調整查詢預測的面積。預測值會偏向 (但不限於) 指定這些邊界的查詢。