使用 地址输入 控件轻松地输入地址
输入地址可能令人沮丧并且容易出错，尤其是在移动应用中。 使用 地址输入 控件让地址输入更轻松。 此控件使用模糊逻辑在您键入时建议潜在的匹配项。 选择您需要的匹配项来快速轻松地输入准确的地址。
此控件将地址作为结构化数据返回。 您的应用可以提取城市、街道、自治市，甚至纬度和经度坐标等信息。 数据采用与许多区域和国际地址格式兼容的格式。
先决条件
您需要为环境启用地理空间功能，然后才能够在应用中使用此控件。 请确保您另外查看了使用地理空间控件的先决条件。 有关 地址输入 控件的数据使用的更多详细信息，请参阅隐私和安全表。
将 地址输入 控件添加到您的应用
在 Power Apps Studio 中让您的应用打开以进行编辑：
- 打开插入选项卡并展开输入。
- 选择地址输入以将地址输入框放在应用屏幕中，或将此控件拖到屏幕上以更精确地放置。 对于 地址输入 控件，您必须输入至少三个字符，包括一个数字。
设置默认搜索半径
默认情况下，此控件将搜索用户的位置。 您可以细化默认搜索区域以帮助缩小初始结果。
- 在 地址输入 控件的属性选项卡上，打开 Search within radius 属性。
- 以米为单位输入纬度、纬度和半径。
此控件将开始搜索给定的纬度和经度，范围覆盖指定的距离。
将 map 控件与 地址输入 控件一起使用
您可以向您的应用添加一个按钮，以将输入的地址保存为数据集合。 然后，您可以检索这些地址并将它们显示在 map 控件中。
将 map 控件和 地址输入 控件添加到您的应用。
插入和放置 按钮 控件。
更改 button 控件的 OnSelect 属性，如下所示。 （提示：复制公式并将其粘贴到编辑栏中或高级属性选项卡上，具体取决于您喜欢粘贴到哪个。）
输入纬度、纬度和半径（以米为单位）。
控件将开始搜索纬度和经度，范围覆盖半径字段中指定的距离。
If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))只要搜索结果不为空，公式就会将当前纬度和经度保存到名为位置的集合中。
选择 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 控件。