Merge pull request #2936 from MicrosoftDocs/iawilt-geospat

add geo topics

Author: shellyhaverkamp

powerapps-docs/maker/TOC.yml

@@ -0,0 +1,152 @@
+---
+title: 
+description: 
+author: iaanw
+manager: shellha
+ms.service: powerapps
+ms.topic: conceptual
+ms.custom: canvas
+ms.reviewer: tapanm
+ms.date: 6/01/2020
+ms.author: iawilt
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+ms.custom: ceX
+---
+
+# Address input component
+
+Entering addresses can be frustrating and error prone, particularly in mobile scenarios. 
+
+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.
+
+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.
+
+To use the component, you need to [enable the geospatial features for the environment](geospatial-overview.md#enable-the-geospatial-features-for-the-environment) as well as [enable the geospatial features for each app](geospatial-overview.md#enable-the-geospatial-features-for-each-app) that you want to use it in.
+
+Make sure to also [review the prerequisites for using geospatial components](geospatial-overview.md#prerequisites).
+
+## Use the component
+
+Insert the component into your app as you normally would for any other control or component.
+
+With an app open for editing in [Power Apps Studio](https://create.powerapps.com):
+
+1. Open the **Insert** tab. 
+
+2. Expand **Input**.
+
+3. Select the component **Address input (preview)** to place it in the center of the app screen, or drag and drop it to position it anywhere on the screen.
+
+4. (Optional) Select **Allow** on the prompt that asks to know your ___location. This enables the component to bias results by the user's current ___location.
+
+    ![Allow highlighted on the window that asks to know your ___location](./media/geospatial/address-allow.png "Allow highlighted on the window that asks to know your ___location")
+
+You can modify the component with a number of properties.
+
+### Properties
+
+The following properties are on the component's **Address Input** pane on the **Properties** and **Advanced** tabs.
+
+![The properties are in the side panel](./media/geospatial/address-properties.png "The properties are in the side panel")
+
+Some properties are only available in the **Advanced** tab, under the **More options** section.
+
+Property | Description | Type | Location
+- | - | - | -
+Enable autofill | Whether the component gives address suggestions. | Boolean | Properties
+Search result limit | The number of suggested addresses the component displays. | Integer | Properties
+Search within radius | Whether the component should suggest addresses within the user-defined **Radius** of the **Latitude** and **Longitude**. | Boolean | Properties
+Latitude | The latitude of the center point used to geobias address suggestions. Requires **Search within radius** to be on. | Decimal between -180 and 180 | Properties
+Longitude | The longitude of the center point used to geobias address suggestions. Requires **Search within radius** to be on. | Decimal between -180 and 180 | Properties
+Radius | The radius in meters around the **Latitude** and **Longitude** to constrain the address suggestions. Requires **Search within radius** to be on. | Decimal | Properties
+Language | The language the address suggestions are returned in | String | Properties
+Country set | Comma separate list of countries to constrain the address suggestions to, in ISO 3166 alpha-2 country codes, for example, "US, FR, KW". | String | Properties
+
+### Additional properties
+
+**[Default](./controls/properties-core.md)** – The initial value of a control before it is changed by the user.
+
+**[Text](./controls/properties-core.md)** – Text that appears on a control or that the user types into a control.
+
+**[BorderColor](./controls/properties-color-border.md)** – The color of a control's border.
+
+**BorderRadius** – The radius of a control's border.
+
+**[BorderStyle](./controls/properties-color-border.md)** – Whether a control's border is **Solid**, **Dashed**, **Dotted**, or **None**.
+
+**[BorderThickness](./controls/properties-color-border.md)** – The thickness of a control's border.
+
+**[Color](./controls/properties-color-border.md)** – The color of text in a control.
+
+**[DisplayMode](./controls/properties-core.md)** – Whether the control allows user input (**Edit**), only displays data (**View**), or is disabled (**Disabled**).
+
+**[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**.
+
+**[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**.
+
+**[DisabledFill](./controls/properties-color-border.md)** – The background color of a control if its **[DisplayMode](./controls/properties-core.md)** property is set to **Disabled**.
+
+**[Fill](./controls/properties-color-border.md)** – The background color of a control.
+
+**[FocusedBorderColor](./controls/properties-color-border.md)** – The color of a control's border when the control is focused.
+
+**[FocusedBorderThickness](./controls/properties-color-border.md)** – The thickness of a control's border when the control is focused.
+
+**[Font](./controls/properties-text.md)** – The name of the family of fonts in which text appears.
+
+**[FontWeight](./controls/properties-text.md)** – The weight of the text in a control: **Bold**, **Semibold**, **Normal**, or **Lighter**.
+
+**[Height](./controls/properties-size-___location.md)** – The distance between a control's top and bottom edges.
+
+**HintText** – Light-grey text that appears in an input-text control if it's empty.
+
+**[HoverBorderColor](./controls/properties-color-border.md)** – The color of a control's border when the user keeps the mouse pointer on that control.
+
+**[HoverColor](./controls/properties-color-border.md)** – The color of the text in a control when the user keeps the mouse pointer on it.
+
+**[HoverFill](./controls/properties-color-border.md)** – The background color of a control when the user keeps the mouse pointer on it.
+
+**[Italic](./controls/properties-text.md)** – Whether the text in a control is italic.
+
+**[LineHeight](./controls/properties-text.md)** – The distance between, for example, lines of text or items in a list.
+
+**[OnChange](./controls/properties-core.md)** – How the app responds when the user changes the value of a control (for example, by adjusting a slider).
+
+**[PaddingBottom](./controls/properties-size-___location.md)** – The distance between text in a control and the bottom edge of that control.
+
+**[PaddingLeft](./controls/properties-size-___location.md)** – The distance between text in a control and the left edge of that control.
+
+**[PaddingRight](./controls/properties-size-___location.md)** – The distance between text in a control and the right edge of that control.
+
+**[PaddingTop](./controls/properties-size-___location.md)** – The distance between text in a control and the top edge of that control.
+
+**[PressedBorderColor](./controls/properties-color-border.md)** – The color of a control's border when the user taps or clicks that control.
+
+**[PressedColor](./controls/properties-color-border.md)** – The color of text in a control when the user taps or clicks that control.
+
+**[PressedFill](./controls/properties-color-border.md)** – The background color of a control when the user taps or clicks that control.
+
+**[Size](./controls/properties-text.md)** – The font size of the text that appears on a control.
+
+**[Strikethrough](./controls/properties-text.md)** – Whether a line appears through the text that appears on a control.
+
+**[TabIndex](./controls/properties-accessibility.md)** – Keyboard navigation order in relation to other controls.
+
+**[Tooltip](./controls/properties-core.md)** – Explanatory text that appears when the user hovers over a control.
+
+**[Underline](./controls/properties-text.md)** – Whether a line appears under the text that appears on a control.
+
+**[Visible](./controls/properties-core.md)** – Whether a control appears or is hidden.
+
+**[Width](./controls/properties-size-___location.md)** – The distance between a control's left and right edges.
+
+**[X](./controls/properties-size-___location.md)** – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).
+
+**[Y](./controls/properties-size-___location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).
+
+## Other geospatial components
+
+- Visualize and interpret ___location data with the **[Interactive map](geospatial-component-map.md)** component.

powerapps-docs/maker/canvas-apps/geospatial-component-input-address.md

@@ -0,0 +1,112 @@
+---
+title: 
+description: 
+author: iaanw
+manager: shellha
+ms.service: powerapps
+ms.topic: conceptual
+ms.custom: canvas
+ms.reviewer: tapanm
+ms.date: 6/01/2020
+ms.author: iawilt
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+ms.custom: ceX
+---
+
+
+# Interactive map component
+
+Easily bring dynamic mapping capabilities into your canvas apps by viewing the physical position of entities from a data source, or by inputting new physical locations. 
+
+Pan, tilt, zoom, and drag to center your map view. As you zoom out, the markers will optionally cluster to represent dense groups of data. 
+
+The current ___location of the user can also be represented on the map on mobile devices or web experiences. 
+
+The map component also supports road and satellite views.
+
+![](./media/augmented-geospatial/geospatial-map-component.png)
+
+To use the component, you need to [enable the geospatial features for the environment](geospatial-overview.md#enable-the-geospatial-features-for-the-environment) as well as [enable the geospatial features for each app](geospatial-overview.md#enable-the-geospatial-features-for-each-app) that you want to use it in.
+
+Make sure to also [review the prerequisites for using geospatial components](geospatial-overview.md#prerequisites).
+
+## Use the component
+
+Insert the component into your app as you normally would for any other control or component.
+
+With an app open for editing in the [Power Apps studio](https://create.powerapps.com):
+
+1. Open the **Insert** tab.
+2. Expand **Media**.
+3. Select the component **Map** to place it in the center of the app screen, or drag and drop it to position it anywhere on the screen.
+4. (Optional) Select **Allow** on the prompt that asks to know your ___location. This enables the component to display the user's current ___location.
+
+    ![Allow highlighted on the window that asks to know your ___location](./media/geospatial/address-allow.png "Allow highlighted on the window that asks to know your ___location")
+
+You can modify the component with a number of properties.
+
+### Properties
+
+The following properties can be defined and configured in the component's **Properties** pane.
+
+![](./media/augmented-geospatial/geospatial-controls.png)
+
+Note that some properties are only available in the **Advanced** tab on the **Properties** pane, under the **More options** button.
+
+Property | Description | Type | Location
+- | - | - | -
+Data source(Items) | Data source (table) that lists a pre-defined set of longitudes and latitudes to display as map pin on the map when it's loaded. Map each of the columns in your data with the *ItemAddresses*, *ItemLongitudes*, *ItemLatitudes*, and *ItemLabels*. | Not applicable | Properties
+Use default ___location | Whether the map initializes at a default ___location set by the user or not. | Boolean | Properties
+Default longitude | Longitude at which the map would go to when it's loaded if **Use default ___location** is enabled. | Floating point number | Properties
+Default latitude | Latitude at which the map would go to when it's loaded if **Use default ___location** is enabled. | Floating point number | Properties
+Default zoom level | Zoom level at which the map would be set to when it's loaded if **Use default ___location** is enabled. | Integer | Properties
+Show current ___location | Whether the map should display the current ___location of the user (if it has permission). | Boolean | Properties
+Satellite view | Whether the style of the map is a satellite view or a road view. | Boolean | Properties
+Cluster pins | Whether the map pins are clustered or not. | Boolean | Properties
+Zoom control | Whether the zoom component appears on the map or not. | Boolean | Properties
+Compass control | Whether the compass component appears on the map or not. | Boolean | Properties
+Pitch control | Whether the pitch component appears on the map or not. | Boolean | Properties
+Pin color | The color of the pins. | Color picker | Properties
+Maximum map pins | Maximum number of pins displayed on the map. | Integer | Properties
+ItemsLabels | A column in Items with the strings you want to use as labels for the pins. | TableName.ColumnName | Advanced
+ItemsAddresses | A column in Items with the strings that represent the ___location of the pins. Does not work with **ItemsLongitudes** or **ItemsLatitudes**. | TableName.ColumnName | Advanced
+ItemsLongitudes | Name of the column in the table in your data source with floating-point numbers that represent the longitude position of the pins. Does not work with **ItemsAddresses**. | TableName.ColumnName | Advanced
+ItemsLatitudes | Name of the column in the table in your data source with floating-point numbers that represent the latitude position of the pins. Does not work with **ItemsAddresses**. | TableName.ColumnName | Advanced
+Items_Items | Name of the table in your data source that contains all the records that you want to plot in the map using pins. Each row must have an entry for the label, longitude, and latitude for each row. | TableName | Advanced
+
+### Additional properties
+
+**[BorderColor](./controls/properties-color-border.md)** - The color of a control's border.
+
+**BorderRadius** - The radius of a control's border.
+
+**[BorderStyle](./controls/properties-color-border.md)** - Whether a control's border is **Solid**, **Dashed**, **Dotted**, or **None**.
+
+**[BorderThickness](./controls/properties-color-border.md)** - The thickness of a control's border.
+
+**[Color](./controls/properties-color-border.md)** - The color of text in a control.
+
+**[DisplayMode](./controls/properties-core.md)** - Whether the control allows user input (**Edit**), only displays data (**View**), or is disabled (**Disabled**).
+
+**[Height](./controls/properties-size-___location.md)** - The distance between a control's top and bottom edges.
+
+**[TabIndex](./controls/properties-accessibility.md)** - Keyboard navigation order.
+
+**[Tooltip](./controls/properties-core.md)** - Explanatory text that appears when the user hovers over a control.
+
+**Transparency** - How transparent the component is as a percentage.
+
+**[Visible](./controls/properties-core.md)** - Whether a control appears or is hidden.
+
+**[Width](./controls/properties-size-___location.md)** - The distance between a control's left and right edges.
+
+**[X](./controls/properties-size-___location.md)** - The distance between the left edge of a control and the left edge of its parent container (or the screen if there's no parent container).
+
+**[Y](./controls/properties-size-___location.md)** - The distance between the top edge of a control and the top edge of the parent container (or the screen if there's no parent container).
+
+## Other geospatial components
+
+- See dynamic address suggestions as you type with the **[Address input](geospatial-component-input-address.md)** component.