Autocomplete Data (new)

AutocompleteSuggestion 類別

google.maps.places.AutocompleteSuggestion class

自動完成建議結果。

撥打 const {AutocompleteSuggestion} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
參數: 
傳回值:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
擷取 AutocompleteSuggestions 清單。

如果要求中提供 AutocompleteRequest.sessionToken,系統會在第一次呼叫 Place.fetchFields 時自動納入該工作階段權杖,並在結果 PlacePrediction 中,對 PlacePrediction.toPlace 傳回的每個 Place 執行這項操作。
placePrediction
類型:  PlacePrediction optional
包含傳回結果的使用者可解讀名稱。如果是機構結果,通常會顯示商家名稱和地址。

如果在用於擷取這個 AutocompleteSuggestion 的 AutocompleteRequest 中提供 AutocompleteRequest.sessionToken,當您在 PlacePrediction.toPlace 呼叫傳回的 Place 上首次呼叫 Place.fetchFields 時,系統會自動加入相同權杖。

AutocompleteRequest interface

google.maps.places.AutocompleteRequest 介面

AutocompleteSuggestion.fetchAutocompleteSuggestions 的要求介面。

input
類型:  string
要搜尋的文字字串。
includedPrimaryTypes optional
類型:  Array<string> optional
包含主要地點類型 (例如「restaurant」或「gas_station」)。

只有當地點的主要類型包含在此清單中時,系統才會傳回地點。最多可指定 5 個值。如未指定類型,系統會傳回所有地點類型。
includedRegionCodes optional
類型:  Array<string> optional
只納入指定區域的結果,最多可指定 15 個 CLDR 雙字元區域代碼。如果集合為空白,系統不會限制結果。如果同時設定 locationRestrictionincludedRegionCodes,結果會位於交集區域。
inputOffset optional
類型:  number optional
以零為基準的 Unicode 字元位移值 input,表示 input 中的游標位置。游標位置可能會影響系統傳回的預測結果。如未指定,則預設為 input 的長度。