使用地址輸入控制項輕鬆輸入地址

輸入地址會令人沮喪而且容易出錯，尤其是在行動裝置應用程式中。 使用地址輸入控制項讓輸入地址變得更輕鬆。 在輸入時，控制項會使用模糊規則來建議潛在的相符項目。 選取您要快速輕鬆地輸入的準確地址。

控制項會將地址當作結構化資料傳回。 您的應用程式可以擷取市/鎮、街道、自治區，甚至緯度和經度座標的資訊。 資料的格式適用於許多地區設定和國際地址格式。

先決條件

若要在應用程式中使用該控制項，您需要為環境啟用地理空間服務。 請務必檢查使用地理空間控制項的先決條件。 如需地址輸入控制項的資料使用方式的詳細資料，請參考隱私權和安全性表格。

將地址輸入控制項新增至您的應用程式

在 Power Apps Studio 中開啟應用程式以進行編輯時：

1. 打開插入索引標籤，然後展開輸入。
2. 選取地址輸入，將地址輸入方塊放置在應用程式畫面中，或將控制項拖曳到畫面以更精確地定位。 您必須為地址輸入控制項至少輸入 3 個字元，包括一個數字。

設定預設搜尋半徑

根據預設，控制項將搜尋使用者的位置。 您可以縮小預設搜尋區域，以協助縮小初始結果的範圍。

1. 在地址輸入控制項的屬性索引標籤上，打開 Search within radius 屬性。
2. 輸入經度、緯度和半徑 (以公尺為單位)。

該控制項將開始搜尋指定的緯度和經度，直到指定的距離。

使用地圖控制項和地址輸入控制項

您可以將按鈕新增至應用程式，將輸入的地址儲存為資料收集。 然後，您可以取出地址，並將它們顯示在地圖控制項中。

1. 將地圖控制項與地址輸入控制項新增至應用程式。

2. 插入和放置按鈕控制項。

3. 變更按鈕控制項的 OnSelect 屬性，如下所示。 (提示：複製公式，並將其貼上到公式列或 Advanced 屬性索引標籤上，不論您喜歡哪種。)

4. 輸入經度、緯度和半徑 (以公尺為單位)。

   該控制項將開始搜尋緯度和經度，搜尋半徑欄位中指定的距離。

   If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))
   

   只要搜尋結果不是空白，公式就會將目前的緯度和經度儲存到名稱為位置的集合

   

5. 選取地圖控制項。 變更其屬性，如下所示：

   屬性名稱	數值	位置
   項目	「位置」	屬性索引標籤
   ItemsLatitudes	「緯度」	進階索引標籤
   ItemsLongitudes	「經度」	進階索引標籤

使用者選取按鈕時，來自地址輸入控制項的結果都會以新圖釘的方式新增至地圖中。

屬性

使用屬性變更地址輸入控制項的行為和外觀。 有些屬性只能在進階索引標籤上使用。

屬性	描述	類型	索引標籤
預設	設定控制項的初始值。	字串	屬性; 進階：Default
提示文字	在使用者輸入文字之前，設定出現在控制項中的提示。	字串	屬性; 進階：HintText
字型	設定用於控制項文字的字型系列名稱。	下拉式清單	屬性; 進階：Font
字型大小	設定控制項文字的大小。	浮點數	屬性; 進階：FontSize
字型粗細	設定控制項文字的粗細，可以是粗體、較細、一般或半粗體。	下拉式清單	屬性; 進階：FontWeight
文字對齊	設定控制項文字的水平對齊方式，可以是置中、左右對齊、靠左對齊或靠右對齊。	下拉式清單	屬性; 進階：TextAlignment
行高	設定控制項中文字各行之間的垂直距離。	浮點數	屬性; 進階：LineHeight
顯示模式	確定控制項是允許使用者輸入 (編輯)、只顯示資料 (檢視) 還是停用 (已停用)。	下拉式清單	屬性; 進階：DisplayMode
字型樣式	設定控制項文字的樣式，可以是斜體、底線、刪除線或 [無]。	下拉式清單	屬性; 進階：Italic、Underline、Strikethrough
搜尋結果限制	設定控制項顯示的建議地址數。	整數	屬性; 進階：SearchResultLimit
在半徑內搜索	決定控制項是否應建議緯度和經度之半徑中的地址。	布林值	屬性; 進階：SearchWithinRadius
緯度	設定用於地址建議之中心點的緯度座標。 需要開啟在半徑範圍內搜尋。	浮點數從 -90 到 90	屬性; 進階：Latitude
經度	設定用於地址建議之中心點的經度座標。 需要開啟在半徑範圍內搜尋。	浮點數從 -180 到 180	屬性; 進階：Longitude
半徑	設定緯度和經度周圍的半徑 (以公尺為單位) 以限制地址建議。 需要開啟在半徑範圍內搜尋。	浮點數	屬性; 進階：Radius
語言	設定地址建議傳回的語言。	字串	屬性; 進階：Language
國家/地區集	以 ISO 3166 alpha-2 格式識別以逗點分隔的國家/地區清單，以限制地址建議，例如 US、CA、MX。	字串	屬性; 進階：CountrySet
可見	顯示或隱藏控制項。	布林值	屬性; 進階：Visible
頂端邊距	設定控制項文字與控制項頂端之間的距離。	浮點數	屬性; 進階：PaddingTop
底部邊距	設定控制項文字與控制項底部之間的距離。	浮點數	屬性; 進階：PaddingBottom
左邊距	設定控制項文字與控制項左邊界之間的距離。	浮點數	屬性; 進階：PaddingLeft
右邊距	設定控制項文字與控制項右邊界之間的距離。	浮點數	屬性; 進階：PaddingRight
位置	將控制項的左上角放置在 X 與 Y 中指定的畫面座標處。	整數	屬性; 進階：X、Y
大小	使用寬度和高度中提供的像素值來確定控制項的大小。	整數	屬性; 進階：Width、Height
框線半徑	確定控制項框線的圓角半徑。	浮點數	屬性; 進階：BorderRadius
色彩	設定控制項文字和控制項背景的顏色。	不適用	屬性; 進階：FillColor、TextColor
框線	確定控制項框線的樣式、寬度和顏色。	不適用	屬性; 進階：BorderStyle、BorderThickness、BorderColor
索引標籤索引	指定使用者使用 Tab 索引鍵瀏覽應用程式時，選取控制項的順序。	整數	屬性; 進階：TabIndex
Tooltip	確定當使用者將滑鼠游標懸停在控制項上時要顯示的文字。	字串	屬性; 進階：Tooltip
暫留時色彩	設定當使用者將滑鼠指標懸停在控制項上時，控制項文字、控制項背景和控制項框線的顏色。	不適用	屬性; 進階：HoverFontColor、HoverFillColor、HoverBorderColor
停用色彩	如果 DisplayMode 為已停用，則設定控制項文字、控制項背景和控制項框線的顏色。	不適用	屬性; 進階：DisabledFontColor、DisabledFillColor、DisabledBorderColor
點選時色彩	設定當使用者選取控制項時，控制項文字、控制項背景和控制項框線的顏色。	不適用	屬性; 進階：PressedFontColor、PressedFillColor、PressedBorderColor
ContentLanguage	確定控制項的顯示語言 (如果其與應用程式中使用的語言不同)。	字串	進階
OnAddressSelect	包含當使用者選取建議地址時執行的程式碼。	事件	進階
OnChange	包含變更控制項屬性時執行的程式碼。	事件	進階

輸出屬性

當使用者與地址輸入控制項進行互動時，其他屬性會變得可用。 您可以在其他控制項中使用這些輸出屬性，也可以自訂應用程式體驗。

屬性	描述
UserInput	使用者在輸入方塊中輸入的文字
SelectedLatitude	使用者所選地址的緯度
SelectedLongitude	使用者所選地址的經度
SearchResultJson	以 JSON 格式的字串形式顯示搜尋結果 (根據 UserInput)
FreeformAddress	使用者從建議地址清單中選取的地址
LocalName	地理區域或地區的名稱，該名稱將多個可定址物件分組以用於定址目的，而無需成為管理單位
PostalCode	郵遞區號
ExtendedPostalCode	擴充郵遞區號
CountryCode	國碼 (地區碼)
Country	國家/地區的名稱
CountryCodeISO3	ISO alpha-3 格式的國碼 (地區碼)
CountrySubdivisionName	國家/地區細分名稱
StreetName	街道名稱
StreetNumber	街道號碼
自治區	自治區
MunicipalitySubdivision	自治區細分
CountryTertiarySubdivision	國家/地區第三級細分
CountrySecondarySubdivision	國家/地區第二級細分
CountrySubdivision	國家/地區細分

其他地理空間控制項

若要視覺化並解釋位置資料，請使用 interactive map 控制項。

注意

是否能請您告知您偏好的慣用文件語言？ 請填寫問卷。 (請注意，本問卷為英文版)

完成問卷大約需要七分鐘。 本問卷將不會收集個人資料 (隱私權聲明)。