You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/geospatial-component-input-address.md
-214Lines changed: 0 additions & 214 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -209,220 +209,6 @@ The following table lists the output properties available.
209
209
## Other geospatial components
210
210
211
211
To visualize and interpret ___location data, use the **[Interactive map](geospatial-component-map.md)** component.
212
-
=======
213
-
---
214
-
title: Enter and resolve address in maps
215
-
description: Use the address input component in your apps to let users search for and find addresses.
216
-
author: iaanw
217
-
manager: shellyha
218
-
ms.service: powerapps
219
-
ms.topic: conceptual
220
-
ms.custom: canvas, ce06122020
221
-
ms.reviewer: tapanm
222
-
ms.date: 1/19/2021
223
-
ms.author: iawilt
224
-
search.audienceType:
225
-
- maker
226
-
search.app:
227
-
- PowerApps
228
-
---
229
-
230
-
# Address input component
231
-
232
-
Entering addresses can be frustrating and error-prone, particularly in mobile scenarios.
233
-
234
-
The address input component lets you see dynamic address suggestions as you type. Using fuzzy matching logic, the component suggests multiple potential address matches that the user can select—making it quicker and easier to enter accurate addresses.
235
-
236
-
The component returns the address as structured data, allowing your application to extract information like city, street, municipality, and even latitude and longitude. The data is in a format friendly to many locales and international address formats.
237
-
238
-
To use the component, you need to [enable geospatial features for the environment](geospatial-overview.md#enable-the-geospatial-features-for-the-environment).
239
-
240
-
Make sure you also [review the prerequisites for using geospatial components](geospatial-overview.md#prerequisites).
241
-
242
-
## Use the component
243
-
244
-
Insert the component into your app as you normally would for any other control or component.
245
-
246
-
With an app open for editing in [Power Apps Studio](https://create.powerapps.com):
247
-
248
-
1. Open the **Insert** tab.
249
-
250
-
2. Expand **Input**.
251
-
252
-
3. Select the component **Address input (preview)** to place it in the center of the app screen, or drag it to position it anywhere on the screen.
253
-
254
-
255
-
You can modify the component by using many [properties](#input-properties).
256
-
257
-
### Set a default search radius
258
-
259
-
By default, the component will search around the user's ___location (providing the user has consented for the app to access their ___location). However, you can refine the default search area to help narrow or change initial results when users input an address.
260
-
261
-
1. On the **Properties** pane, set the **Search within radius** switch to **On**.
262
-
263
-
1. Enter a longitude, latitude, and radius (in meters).
264
-
265
-
The component will start searching at the latitude and longitude, out to the distance specified in the radius field.
266
-
267
-
### Use the map component with the input address component
268
-
269
-
You can save addresses that a user inputs into the address component as a data collection. You can then retrieve these addresses and display them in [the map component](geospatial-component-map.md).
270
-
271
-
1. App the map component and the input address component to your app.
272
-
2. On the **Insert** menu, select **Button** and move it into your app.
273
-
3. Go to the **Advanced** tab on the **Properties** pane. Under **OnSelect**, enter the following code:
This code causes the button to save the current latitude and longitude to a collection named *locations*, as long as the search results are not blank
280
-
281
-

282
-
283
-
4. Select the map component, and go to the **Advanced** tab on the **Properties** pane.
284
-
285
-
5. Set the following properties:
286
-
287
-
- **Items** as *locations*
288
-
- **ItemsLatitudes** as *"Latitude"*
289
-
- **ItemsLongitudes** as *"Longitude"*
290
-
291
-
Each time a user selects the button, the result from the address input component will be added to the map as a new pin.
292
-
293
-
### Input properties
294
-
295
-
The following properties are on the component's **Address Input** pane on the **Properties** and **Advanced** tabs.
296
-
297
-

298
-
299
-
Some properties are only available on the **Advanced** tab, in the **More options** section.
300
-
301
-
| Property | Description | Type | Location |
302
-
| - | - | - | - |
303
-
| Search result limit | The number of suggested addresses the component displays. | Integer | Properties |
304
-
| Search within radius | Whether the component should suggest addresses within the user-defined **Radius** of the **Latitude** and **Longitude**. | Boolean | Properties |
305
-
| Latitude | The latitude of the center point used to geo-bias address suggestions. Requires **Search within radius** to be on. | Decimal from –180 through 180 | Properties |
306
-
| Longitude | The longitude of the center point used to geo-bias address suggestions. Requires **Search within radius** to be on. | Decimal from –180 through 180 | Properties |
307
-
| Radius | The radius, in meters, around **Latitude** and **Longitude** to constrain the address suggestions. Requires **Search within radius** to be on. | Decimal | Properties |
308
-
| Language | The language the address suggestions are returned in | String | Properties |
309
-
| Country set | Comma-separated list of countries to constrain the address suggestions to, in ISO 3166 alpha-2 country codes. For example, **US, FR, KW** | String | Properties |
310
-
311
-
### Output properties
312
-
313
-
The component outputs various properties when a user interacts with it inside an app. You can use these outputs in other components or to customize the experience.
314
-
315
-
The following table lists the output properties available.
316
-
317
-
| Property | Description |
318
-
| -- | -- |
319
-
| UserInput | Text the user has typed in the input box. |
320
-
| SelectedLatitude | Latitude of the user-selected address in the input field. |
321
-
| SelectedLongitude | Longitude of the user-selected address in the input field. |
322
-
| SearchResultJson | The search result (based on the UserInput property), displayed as a string in JSON format. |
323
-
| FreeformAddress | Selected address from the list of suggested addresses. |
324
-
| LocalName | An address component which represents the name of a geographic area or locality that groups multiple addressable objects for addressing purposes, without being an administrative unit. |
325
-
| PostalCode | Postal code. |
326
-
| ExtendedPostalCode | Extended Postal Code. |
327
-
| CountryCode | Country code. |
328
-
| Country | Country. |
329
-
| CountryCodeISO3 | Country code in ISO alpha-3 format. |
330
-
| CountrySubdivisionName | Country subdivision name. |
| CountryTertiarySubdivision | Country tertiary subdivision. |
336
-
| CountrySecondarySubdivision | Country secondary subdivision. |
337
-
| CountrySubdivision | Country subdivision. |
338
-
339
-
340
-
### Additional (common) properties
341
-
342
-
**[Default](./controls/properties-core.md)** – The initial value of a control before it's changed by the user.
343
-
344
-
**[Text](./controls/properties-core.md)** – Text that appears on a control or that the user types into a control.
345
-
346
-
**[BorderColor](./controls/properties-color-border.md)** – The color of a control's border.
347
-
348
-
**BorderRadius** – The radius of a control's border.
349
-
350
-
**[BorderStyle](./controls/properties-color-border.md)** – Whether a control's border is **Solid**, **Dashed**, **Dotted**, or **None**.
351
-
352
-
**[BorderThickness](./controls/properties-color-border.md)** – The thickness of a control's border.
353
-
354
-
**[Color](./controls/properties-color-border.md)** – The color of text in a control.
355
-
356
-
**[DisplayMode](./controls/properties-core.md)** – Whether the control allows user input (**Edit**), only displays data (**View**), or is disabled (**Disabled**).
357
-
358
-
**[DisabledBorderColor](./controls/properties-color-border.md)** – The color of a control's border if the control's **[DisplayMode](./controls/properties-core.md)** property is set to **Disabled**.
359
-
360
-
**[DisabledColor](./controls/properties-color-border.md)** – The color of text in a control if its **[DisplayMode](./controls/properties-core.md)** property is set to **Disabled**.
361
-
362
-
**[DisabledFill](./controls/properties-color-border.md)** – The background color of a control if its **[DisplayMode](./controls/properties-core.md)** property is set to **Disabled**.
363
-
364
-
**[Fill](./controls/properties-color-border.md)** – The background color of a control.
365
-
366
-
**[FocusedBorderColor](./controls/properties-color-border.md)** – The color of a control's border when the control is in focus.
367
-
368
-
**[FocusedBorderThickness](./controls/properties-color-border.md)** – The thickness of a control's border when the control is in focus.
369
-
370
-
**[Font](./controls/properties-text.md)** – The name of the family of fonts in which text appears.
371
-
372
-
**[FontWeight](./controls/properties-text.md)** – The weight of the text in a control: **Bold**, **Semibold**, **Normal**, or **Lighter**.
373
-
374
-
**[Height](./controls/properties-size-___location.md)** – The distance between a control's top and bottom edges.
375
-
376
-
**Hint text** – Light-gray text that appears in an input-text control if it's empty.
377
-
378
-
**[HoverBorderColor](./controls/properties-color-border.md)** – The color of a control's border when the user keeps the mouse pointer on that control.
379
-
380
-
**[HoverColor](./controls/properties-color-border.md)** – The color of the text in a control when the user keeps the mouse pointer on it.
381
-
382
-
**[HoverFill](./controls/properties-color-border.md)** – The background color of a control when the user keeps the mouse pointer on it.
383
-
384
-
**[Italic](./controls/properties-text.md)** – Whether the text in a control is italic.
385
-
386
-
**[LineHeight](./controls/properties-text.md)** – The vertical distance between lines of text—for example, between items in a list.
387
-
388
-
**[OnChange](./controls/properties-core.md)** – How the app responds when the user changes the value of a control (for example, by adjusting a slider).
389
-
390
-
**[PaddingBottom](./controls/properties-size-___location.md)** – The distance between text in a control and the bottom edge of that control.
391
-
392
-
**[PaddingLeft](./controls/properties-size-___location.md)** – The distance between text in a control and the leftmost edge of that control.
393
-
394
-
**[PaddingRight](./controls/properties-size-___location.md)** – The distance between text in a control and the rightmost edge of that control.
395
-
396
-
**[PaddingTop](./controls/properties-size-___location.md)** – The distance between text in a control and the top edge of that control.
397
-
398
-
**[PressedBorderColor](./controls/properties-color-border.md)** – The color of a control's border when the user taps or clicks that control.
399
-
400
-
**[PressedColor](./controls/properties-color-border.md)** – The color of text in a control when the user taps or clicks that control.
401
-
402
-
**[PressedFill](./controls/properties-color-border.md)** – The background color of a control when the user taps or clicks that control.
403
-
404
-
**[Size](./controls/properties-text.md)** – The font size of the text that appears on a control.
405
-
406
-
**[Strikethrough](./controls/properties-text.md)** – Whether a line appears through the text that appears on a control.
407
-
408
-
**[TabIndex](./controls/properties-accessibility.md)** – Keyboard navigation order in relation to other controls.
409
-
410
-
**[Tooltip](./controls/properties-core.md)** – Explanatory text that appears when the user hovers over a control.
411
-
412
-
**[Underline](./controls/properties-text.md)** – Whether a line appears under the text that appears on a control.
413
-
414
-
**[Visible](./controls/properties-core.md)** – Whether a control appears or is hidden.
415
-
416
-
**[Width](./controls/properties-size-___location.md)** – The distance between a control's leftmost and rightmost edges.
417
-
418
-
**[X](./controls/properties-size-___location.md)** – The distance between the leftmost edge of a control and the leftmost edge of its parent container (or screen, if the control has no parent container).
419
-
420
-
**[Y](./controls/properties-size-___location.md)** – The distance between the top edge of a control and the top edge of the parent container (or screen, if the control has no parent container).
421
-
422
-
## Other geospatial components
423
-
424
-
To visualize and interpret ___location data, use the **[Interactive map](geospatial-component-map.md)** component.
0 commit comments