Skip to content

Commit 3a22c60

Browse files
authored
Merge pull request #5817 from MicrosoftDocs/pjramirez-ms-patch-1
Update to geospatial controls overview 2596580
2 parents 4443e3b + d393b70 commit 3a22c60

File tree

2 files changed

+29
-27
lines changed

2 files changed

+29
-27
lines changed

powerapps-docs/maker/canvas-apps/geospatial-overview.md

Lines changed: 29 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.service: powerapps
66
ms.topic: overview
77
ms.custom: canvas, ce06122020
88
ms.reviewer: tapanm
9-
ms.date: 1/19/2021
9+
ms.date: 02/14/2022
1010
ms.subservice: canvas-maker
1111
ms.author: anuitz
1212
search.audienceType:
@@ -16,6 +16,7 @@ search.app:
1616
contributors:
1717
- tapanm-msft
1818
- anuitz
19+
- pjramirez-ms
1920
---
2021

2122

@@ -32,17 +33,17 @@ The following prebuilt controls can be used for geospatial and mapping scenarios
3233
- [Address input](geospatial-component-input-address.md)
3334

3435
## Prerequisites
35-
36-
1. An admin must [enable the geospatial features in the Power Platform admin center](#enable-the-geospatial-features-for-the-environment) for the environment. This requires reviewing and agreeing to specific terms of service.
37-
2. An admin must [ensure the geospatial controls will not be blocked by the environment's data loss prevention policies](#review-the-environments-data-loss-prevention-policies).
36+
1. An admin must [add a Microsoft Dataverse database](/power-platform/admin/create-database) to the environment.
37+
3. An admin must [enable the geospatial features in the Power Platform admin center](#enable-the-geospatial-features-for-the-environment) for the environment. This requires reviewing and agreeing to specific terms of service.
38+
3. An admin must [ensure the geospatial controls will not be blocked by the environment's data loss prevention policies](#review-the-environments-data-loss-prevention-policies).
3839

3940
>[!IMPORTANT]
4041
>The controls require the default **Organizations** data source to be present. This data source is included whenever you insert the controls into an app, but if you manually delete it you'll need to add it before the controls will work:
4142
>
4243
>1. With the control selected, go to the **Data sources** tab on the side navigation menu.
4344
>2. In the search field, enter **Organizations**, and then select the data source that appears. This will add it to the control.
4445
45-
### Enable the geospatial features for the environment
46+
## Enable the geospatial features for the environment
4647

4748
Before you can use geospatial features in your apps, an admin must enable access to the features for the environment where you want to create your app.
4849

@@ -60,39 +61,40 @@ The geospatial features require additional terms of use that must be reviewed an
6061

6162
1. Under **Geospatial services**, set the toggle switch to **On**. A terms of service notice will appear. Read through the terms of service, and if you agree, select the checkbox **I agree to the terms of service**, and then select **Enable**.
6263

63-
![Screenshot of the terms of service.](./media/geospatial/ppac-tos.png "Screenshot of the terms of service")
64+
:::image type="content" source="./media/geospatial/ppac-terms.png" alt-text="Screenshot of the terms of service.":::
6465

6566
>[!IMPORTANT]
6667
>You must read and agree to the terms of service before you can use geospatial features.
67-
>
68-
>The following are the terms of service:
69-
>
70-
>These features use mapping capabilities that are powered by a third party, TomTom(tm), and operate outside your tenant's geographic region, compliance boundary, or national cloud instance.
71-
>
72-
>Microsoft shares the address and ___location queries with TomTom(tm). The name of the customer or end user who entered the query is not shared.
73-
>
74-
>This feature is non-regional and the queries you provide may be stored and processed in the United States or any other country in which Microsoft or its subprocessors operate.
75-
>
76-
>Additional licensing requirements might be required to enable this feature.
77-
78-
>[!NOTE]
79-
>Requests sent between TomTom(tm) and the Azure Maps service are not exposed over the public Internet.
80-
>
81-
>Requests between apps you create with the control and the Azure Maps service are sent over HTTPS.
82-
8368
8469
1. Select **Save** at the bottom of the settings page.
8570

8671
![Screenshot of the Save button.](./media/geospatial/ppac-save.png "Screenshot of the Save button")
8772

88-
### Review the environment's data loss prevention policies
73+
## Review the environment's data loss prevention policies
8974

9075
The geospatial controls require the Microsoft Dataverse and Spatial Services connectors. This connector is used by the Power Apps Maps and Address Input controls to connect to Microsoft’s Azure Maps service. It is used to fetch map tiles and satellite imagery, geocode addresses, and search for addresses. Thus, it is required for the Interactive Map and Address Input controls to function.
9176

92-
For the controls to function properly, these connectors must not have conflicting data loss prevention policies. An admin must review the environment's data loss prevention policies and ensure that these connectors are classified under the same data group, typically the **Business** data group. [Learn more about data loss prevention policies for Power Platform](/power-platform/admin/prevent-data-loss).
93-
94-
95-
### Next steps
77+
For the controls to function properly, these connectors must not have conflicting data loss prevention policies. An admin must review the environment's data loss prevention policies and ensure that these connectors are classified under the same data group, typically the **Business** data group. [Learn more about data loss prevention policies for Power Platform](/power-platform/admin/prevent-data-loss).
78+
79+
## Privacy and security considerations
80+
81+
- Power Apps doesn’t link search queries to any user when shared with TomTom, and the shared search queries can’t be used to identify individuals.
82+
- Azure Maps doesn't store the request information sent by you. For more information about Azure Maps compliance, see [Azure global compliance](https://azure.microsoft.com/blog/new-azure-maps-make-identifying-local-compliance-options-easy/)
83+
- Requests sent between TomTom and Azure Maps are not exposed over the public Internet.
84+
- Requests sent between apps you create with the geospatial controls and Azure Maps are sent over HTTPS.
85+
- Power Apps doesn't send any user identifiers or tracking data to Azure Maps, Bing Maps, or TomTom.
86+
- The following table describes the user data that Power Apps sends to Azure Maps, Bing Maps, and TomTom:
87+
88+
| Control | Feature | Data | Sent to Azure Maps | Sent to Bing Maps | Sent to TomTom | Purpose |
89+
| ------- | ------- | ---- | ------------------ | ----------------- | -------------- | ------- |
90+
| Map | Show map tiles | Coordinates in and around the map view | Yes | No | Yes | To show the map tiles in the map view. |
91+
| Map | Show pins and route waypoints | Pins and route waypoint addresses | No | Yes | Yes | To translate addresses to latitude/longitude coordinates, and show them on the map. |
92+
| Map | Show routes | Route waypoint coordinates | Yes | No | Yes | To calculate routes between waypoints. |
93+
| Map | Show pins and shapes from coordinates | Pin and shape coordinates | No | No | No | Feature does not require sending coordinate data. |
94+
| Address Input | Address Search | Address search query string | No | Yes | Yes | To show address search results. |
95+
| Address Input | Address Search | Current device ___location | No | Yes | Yes | To bias address search results around the device ___location. |
96+
97+
## Next steps
9698

9799
Start installing the controls in your apps:
98100

Loading

0 commit comments

Comments
 (0)