geospat updates

Author: Iaan D'Souza-Wiltshire

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

@@ -48,6 +48,42 @@ With an app open for editing in [Power Apps Studio](https://create.powerapps.com
 
 You can modify the component by using a number of properties.
 
+### Set a default search radius
+
+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.
+
+1. On the **Properties** pane, set the **Search within radius** switch to **On**.
+
+1. Enter a longitude, latitude, and radius (in meters).
+
+The component will start searching at the latitude and longitude, out to the distance specified in the radius field.
+
+### Use the map component with the input address component
+
+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.
+
+1. App the map component and the input address component to your app.
+2. On the **Insert** menu, select **Button** and move it into your app.
+3. Go to the **Advanced** tab on the **Properties** pane. Under **OnSelect**, enter the following:
+
+    ```json
+    If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))
+    ```
+
+    This causes the button to save the current latitude and longitude to a collection named *locations*, as long as the search results are not blank
+
+    ![](./media/geospatial/input-code.png)
+
+4. Select the map component, and go to the **Advanced** tab on the **Properties** pane.
+
+5. Set the following properties:
+
+    - **ItemsLabels** as *locations*
+    - **ItemLatitudes** as *locations.Latitude*
+    - **ItemsLongitudes** as *locations.Longitude*
+
+Each time a user selects the button, the result from the address input component will be added to the map as a new pin.
+
 ### Properties
 
 The following properties are on the component's **Address Input** pane on the **Properties** and **Advanced** tabs.

powerapps-docs/maker/canvas-apps/geospatial-component-map.md

@@ -50,6 +50,77 @@ With an app open for editing in the [Power Apps studio](https://create.powerapps
 
 You can modify the component by using a number of properties.
 
+### Use the map component with data from Excel
+
+You can load a table that contains existing data from an Excel workbook into the map component. The component will then plot each row in your table as a map pin.
+
+Your workbook needs to contain a named table with the following columns that should then be mapped to the associated property in the component's **Advanced** pane.
+
+Column description | Maps to property
+-- | -- 
+Label for the pin | ItemsLabels
+Longitude of the pin | ItemsLongitudes
+Latitude of the pin | ItemsLattitudes
+
+You can also use a string to denote the address, in which case ItemsLongitudes and ItemsLatitudes won't work.
+
+
+The following is an example of an Excel table with the required columns:
+
+![Sample excel file with a table named TestData and containing Name, Longitude, and Latitude columns](./media/geospatial/sample-excel.png)
+
+You can copy the following sample data to test this functionality:
+
+Name | Longitude | Latitude
+-- | -- | --
+Fourth Coffee (sample) | -98.29277 | 26.2774
+Litware, Inc. (sample) | -96.85572 | 32.55253
+Adventure Works (sample) | -96.99952 | 32.72058
+Fabrikam, Inc. (sample) | -118.30746 | 34.86543
+Blue Yonder Airlines (sample) | -118.66184 | 34.17553
+City Power & Light (sample) | -113.46184 | 37.15363
+Contoso Pharmaceuticals (sample) | -80.26711 | 40.19918
+Alpine Ski House (sample) | -102.63908 | 35.20919
+A. Datum Corporation (sample) | -89.39433 | 40.71025
+Coho Winery (sample) | -116.97751 | 32.87466
+
+
+
+
+1. Copy and paste the table into a new Excel workbook.
+
+1. Select one of the cells, and then on the Home tab in the ribbon, select **Format as Table** and choose any style, and then **OK**.
+
+    ![](./media/geospatial/convert-table.png)
+
+1. Select the table, and then go to the **Table Design** tab on the ribbon. Enter a name for the table under **Table Name:**, for example *TestData*.
+
+    ![](./media/geospatial/table-name.png)
+
+1. Save the workbook.
+
+1. Open or create a new app in Power Apps, and insert the map component.
+
+1. On the **Properties** pane, select the **Data source(Items)** field and then search for *excel* and select **Import from Excel**.
+
+    ![](./media/geospatial/select-excel.png)
+
+1. Locate the Excel workbook and then select **Open**. Select the table that contains the information, **TestData**, and then **Connect**.
+
+    ![](./media/geospatial/select-table.png)
+
+1. On the **Properties** pane, go to the **Advanced** tab, and select **More options**.
+
+1. Set the following properties:
+
+    - **ItemsLabels** as *TestData.Name*
+    - **ItemLatitudes** as *TestData.Latitude*
+    - **ItemsLongitudes** as *TestData.Longitude*
+
+1. The map component will now show the each row in the table as a pin, labeled with its *Name* as defined in the Excel table.
+
+    ![](./media/geospatial/map-expanded.png)
+
 ### Properties
 
 The following properties can be defined and configured in the component's **Properties** pane.