使用 地址输入 控件轻松地输入地址

输入地址可能令人沮丧并且容易出错，尤其是在移动应用中。 使用 地址输入 控件让地址输入更轻松。 此控件使用模糊逻辑在您键入时建议潜在的匹配项。 选择您需要的匹配项来快速轻松地输入准确的地址。

此控件将地址作为结构化数据返回。 您的应用可以提取城市、街道、自治市，甚至纬度和经度坐标等信息。 数据采用与许多区域和国际地址格式兼容的格式。

先决条件

您需要为环境启用地理空间功能，然后才能够在应用中使用此控件。 请确保您另外查看了使用地理空间控件的先决条件。 有关 地址输入 控件的数据使用的更多详细信息，请参阅隐私和安全表。

将 地址输入 控件添加到您的应用

在 Power Apps Studio 中让您的应用打开以进行编辑：

1. 打开插入选项卡并展开输入。
2. 选择地址输入以将地址输入框放在应用屏幕中，或将此控件拖到屏幕上以更精确地放置。 对于 地址输入 控件，您必须输入至少三个字符，包括一个数字。

设置默认搜索半径

默认情况下，此控件将搜索用户的位置。 您可以细化默认搜索区域以帮助缩小初始结果。

1. 在 地址输入 控件的属性选项卡上，打开 Search within radius 属性。
2. 以米为单位输入纬度、纬度和半径。

此控件将开始搜索给定的纬度和经度，范围覆盖指定的距离。

将 map 控件与 地址输入 控件一起使用

您可以向您的应用添加一个按钮，以将输入的地址保存为数据集合。 然后，您可以检索这些地址并将它们显示在 map 控件中。

1. 将 map 控件和 地址输入 控件添加到您的应用。

2. 插入和放置 按钮 控件。

3. 更改 button 控件的 OnSelect 属性，如下所示。 （提示：复制公式并将其粘贴到编辑栏中或高级属性选项卡上，具体取决于您喜欢粘贴到哪个。）

4. 输入纬度、纬度和半径（以米为单位）。

   控件将开始搜索纬度和经度，范围覆盖半径字段中指定的距离。

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

   只要搜索结果不为空，公式就会将当前纬度和经度保存到名为位置的集合中。

   

5. 选择 map 控件。 更改控件属性，如下所示：

   属性名称	值	位置
   项目	“Locations”	属性选项卡
   ItemsLatitudes	“Latitude”	高级选项卡
   ItemsLongitudes	“Longitude”	高级选项卡

当用户选择按钮时，地址输入 控件中的结果将作为新图钉添加到地图中。

属性

使用属性更改 地址输入 控件的行为和外观。 有些属性仅在高级选项卡上可用。

属性	说明	类型​​	选项卡​​
默认值	设置控件的初始值。	字符串	属性；高级：Default
提示文本	设置在用户输入文本之前出现在控件中的提示。	字符串	属性；高级：HintText
Font	设置用于控件文本的字体系列的名称。	下拉列表	属性；高级：Font
Font size	设置控件文本的大小。	浮点数	属性；高级：FontSize
Font weight	设置控件文本的粗细，可以是 Bold、Lighter、Normal 或 Semibold。	下拉列表	属性；高级：FontWeight
Text alignment	设置控件文本的水平对齐方式，可以是 Center、Justify、Left 或 Right。	下拉列表	属性；高级：TextAlignment
Line height	设置控件中文本行之间的垂直距离。	浮点数	属性；高级：LineHeight
Display mode	确定控件是允许用户输入 (Edit)、仅显示数据 (View)，还是已禁用 (Disabled)。	下拉列表	属性；高级：DisplayMode
Font style	设置控件文本的样式，如 Italic、Underline、Strikethrough 或“无”。	下拉列表	属性；高级：Italic、Underline、Strikethrough
Search result limit	设置控件显示的建议地址数。	整数	属性；高级：SearchResultLimit
Search within radius	确定控件是否应该推荐纬度和经度的半径内的地址。	布尔值	属性；高级：SearchWithinRadius
Latitude	设置用于地址建议的中心点的纬度坐标。 需要打开在半径内搜索。	-90 到 90 的浮点数	属性；高级：Latitude
Longitude	设置用于地址建议的中心点的经度坐标。 需要打开在半径内搜索。	-180 到 180 的浮点数	属性；高级：Longitude
Radius	以米为单位设置纬度和经度的半径以限制地址建议。 需要打开在半径内搜索。	浮点数	属性；高级：Radius
Language	设置返回地址建议所使用的语言。	字符串	属性；高级：Language
Country set	以 ISO 3166 alpha-2 格式标识以逗号分隔的国家/地区列表，以限制地址建议； 例如，US,CA,MX。	字符串	属性；高级：CountrySet
Visible	显示或隐藏控件。	布尔值	属性；高级：Visible
Padding top	设置控件文本和控件顶部之间的距离。	浮点数	属性；高级：PaddingTop
Padding bottom	设置控件文本和控件底部之间的距离。	浮点数	属性；高级：PaddingBottom
Padding left	设置控件文本和控件左边缘之间的距离。	浮点数	属性；高级：PaddingLeft
Padding right	设置控件文本和控件右边缘之间的距离。	浮点数	属性；高级：PaddingRight
Position	将控件的左上角放置在 X 和 Y 中指定的屏幕坐标处。	整数	属性；高级：X、Y
Size	使用 Width 和 Height 中提供的像素值确定控件的大小。	整数	属性；高级：Width、Height
Border radius	确定控件边框的角半径。	浮点数	属性；高级：BorderRadius
Color	设置控件文本和控件背景的颜色。	不适用	属性；高级：FillColor、TextColor
Border	确定控件边框的样式、宽度和颜色。	不适用	属性；高级：BorderStyle、BorderThickness、BorderColor
Tab index	指定用户使用 Tab 键导航应用时选择控件的顺序。	整数	属性；高级：TabIndex
Tooltip	确定当用户将鼠标悬停在控件上时要显示的文本。	字符串	属性；高级：Tooltip
Hover color	设置当用户将鼠标指针悬停在控件上时控件文本、控件背景和控件边框的颜色。	不适用	属性；高级：HoverFontColor、HoverFillColor、HoverBorderColor
Disabled color	如果 DisplayMode 为 Disabled，设置控件文本、控件背景和控件边框的颜色。	不适用	属性；高级：DisabledFontColor、DisabledFillColor、DisabledBorderColor
Pressed color	设置当用户选择控件时控件文本、控件背景和控件边框的颜色。	不适用	属性；高级：PressedFontColor、PressedFillColor、PressedBorderColor
ContentLanguage	确定控件的显示语言（如果它与应用中使用的语言不同）。	字符串	高级
OnAddressSelect	包含用户选择建议的地址时运行的代码。	事件	高级
OnChange	包含在更改控件属性时运行的代码。	事件	高级

输出属性

当用户与 地址输入 控件交互时，其他属性变为可用。 您可以在其他控件中使用这些输出属性或自定义应用体验。

属性	说明
UserInput	用户在输入框中键入的文本
SelectedLatitude	用户选择的地址的纬度
SelectedLongitude	用户选择的地址的经度
SearchResultJson	基于 UserInput 以 JSON 格式字符串的形式显示的搜索结果
FreeformAddress	用户从建议地址列表中选择的地址
LocalName	为寻址目的将多个可寻址对象分组的地理区域或地区的名称，而无需成为管理单位
PostalCode	邮政编码
ExtendedPostalCode	扩展的邮政编码
CountryCode	国家/地区代码
Country	国家/地区名称
CountryCodeISO3	ISO alpha-3 格式的国家/地区代码
CountrySubdivisionName	国家/地区分部名称
StreetName	街道名称
StreetNumber	街道编号
自治市	自治市
MunicipalitySubdivision	自治市分部
CountryTertiarySubdivision	国家/地区第三分部
CountrySecondarySubdivision	国家/地区第二分部
CountrySubdivision	国家/地区分部

其他地理空间控件

要可视化和解释位置数据，使用 interactive map 控件。

备注

您能告诉我们您的文档语言首选项吗？ 进行简短调查。（请注意，此调查是英文版调查）

此调查大约需要七分钟。 不会收集个人数据（隐私声明）。