共用方式為


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

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

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

先決條件

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

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

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}))
    

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

    在 Power Apps Studio 中建構按鈕的螢幕擷取畫面,顯示了其 OnSelect 屬性。

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

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

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

屬性

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

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

注意

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

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