Merge pull request #269451 from stevemunk/add-shapefile-support

Added shapefile (a vector data storage format) to the list of supported file formats.

Author: prmerger-automator[bot]

articles/azure-maps/power-bi-visual-add-reference-layer.md

@@ -17,6 +17,7 @@ Reference layers enable the enhancement of spatial visualizations by overlaying
 - [GeoJSON files] with a `.json` or `.geojson` extension
 - [WKT] (Well-Known Text) files with a `.wkt` extension
 - [KML] (Keyhole Markup Language) files with a `.kml` extension
+- [SHP] (Shapefile) files with a `.shp` extension
 
 ## Add a spatial dataset as a reference layer
 
@@ -29,7 +30,7 @@ To upload a spatial dataset as a reference layer:
 1. Navigate to the **Format** pane.
 1. Expand the **Reference Layer** section.
 1. Select **File Upload** from the **Type** drop-down list.
-1. Select **Browse**. The file selection dialog opens, allowing you to choose a file with a `.json`, `.geojson`, `.wkt` or `.kml` extension.
+1. Select **Browse**. The file selection dialog opens, allowing you to choose a file with a `.json`, `.geojson`, `.wkt`, `.kml` or `.shp` extension.
 
     :::image type="content" source="./media/power-bi-visual/reference-layer-upload.png" alt-text="Screenshot showing the reference layers section when uploading a file control.":::
 
@@ -42,7 +43,7 @@ To use a hosted spatial dataset as a reference layer:
 1. Navigate to the **Format** pane.
 1. Expand the **Reference Layer** section.
 1. Select **URL** from the **Type** drop-down list.
-1. Select **Enter a URL** and enter a valid URL pointing to your hosted file. Hosted files must be a valid spatial datasets with a `.json`, `.geojson`, `.wkt` or `.kml` extension.
+1. Select **Enter a URL** and enter a valid URL pointing to your hosted file. Hosted files must be a valid spatial dataset with a `.json`, `.geojson`, `.wkt`, `.kml` or `.shp` extension.
 
     :::image type="content" source="./media/power-bi-visual/reference-layer-hosted.png" alt-text="Screenshot showing the reference layers section when hosting a file control.":::
 
@@ -58,13 +59,13 @@ The following are all settings in the **Format** pane that are available in the
 
 | Setting              | Description   |
 |----------------------|---------------|
-| Reference layer data | The data file to upload to the visual as another layer within the map. Selecting **Browse** shows a list of files with a `.json`, `.geojson`, `.wkt` or `.kml` file extension that can be opened. |
+| Reference layer data | The data file to upload to the visual as another layer within the map. Selecting **Browse** shows a list of files with a `.json`, `.geojson`, `.wkt`, `.kml` or `.shp` file extension that can be opened. |
 
 ## Styling data in a reference layer
 
 Properties can be added to each feature within the GeoJSON file to customize styling. This feature uses the simple data layer feature in the Azure Maps Web SDK. For more information, see this document on [supported style properties]. Custom icon images aren't supported within the Azure Maps Power BI visual as a security precaution.
 
-The following are examples showing how to set a point features `color` property to red.
+The following are examples showing how to set a point features `color` property to `red`.
 
 **GeoJSON**
 
@@ -118,6 +119,7 @@ Add more context to the map:
 [GeoJSON files]: https://wikipedia.org/wiki/GeoJSON
 [WKT]: https://wikipedia.org/wiki/Well-known_text_representation_of_geometry
 [KML]: https://wikipedia.org/wiki/Keyhole_Markup_Language
+[SHP]: https://en.wikipedia.org/wiki/Shapefile
 [2016 census tracts for Colorado]: https://github.com/Azure-Samples/AzureMapsCodeSamples/tree/master/Static/data/geojson
 [supported style properties]: spatial-io-add-simple-data-layer.md#default-supported-style-properties
 [Add a tile layer]: power-bi-visual-add-tile-layer.md