Skip to content

Commit a47e598

Browse files
committed
Grammatical improvements and end link creation for the overview article
1 parent c3c39d3 commit a47e598

File tree

1 file changed

+49
-29
lines changed

1 file changed

+49
-29
lines changed

articles/azure-maps/about-azure-maps.md

Lines changed: 49 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -53,23 +53,23 @@ Azure Maps consists of the following services that can provide geographic contex
5353

5454
### Data service
5555

56-
Data is imperative for maps. Use the Data service to upload and store geospatial data for use with spatial operations or image composition. Bringing customer data closer to the Azure Maps service will reduce latency, increase productivity, and create new scenarios in your applications. For details on this service, see [Data service].
56+
Data is imperative for maps. Use the Data service to upload and store geospatial data for use with spatial operations or image composition. By bringing customer data closer to the Azure Maps service, you reduce latency and increase productivity. For more information on this service, see [Data service].
5757

5858
### Geolocation service
5959

6060
Use the Geolocation service to retrieve the two-letter country/region code for an IP address. This service can help you enhance user experience by providing customized application content based on geographic location.
6161

62-
For more details, read the [Geolocation service documentation](/rest/api/maps/geolocation).
62+
For more information, see the [Geolocation service] documentation.
6363

6464
### Render service
6565

66-
[Render service V2](/rest/api/maps/render-v2) introduces a new version of the [Get Map Tile V2 API](/rest/api/maps/render-v2/get-map-tile) that supports using Azure Maps tiles not only in the Azure Maps SDKs but other map controls as well. It includes raster and vector tile formats, 256x256 or 512x512 (where applicable) tile sizes and numerous map types such as road, weather, contour, or map tiles created using Azure Maps Creator. For a complete list, see [TilesetID] in the REST API documentation. It's recommended that you use Render service V2 instead of Render service V1. You're required to display the appropriate copyright attribution on the map anytime you use the Azure Maps Render service V2, either as basemaps or layers, in any third-party map control. For more information, see [How to use the Get Map Attribution API](how-to-show-attribution.md).
66+
[Render service V2] introduces a new version of the [Get Map Tile V2 API] that supports using Azure Maps tiles not only in the Azure Maps SDKs but other map controls as well. It includes raster and vector tile formats, 256x256 or 512x512 tile sizes (where applicable) and numerous map types such as road, weather, contour, or map tiles. For a complete list, see [TilesetID] in the REST API documentation. It's recommended that you use Render service V2 instead of Render service V1. You're required to display the appropriate copyright attribution on the map anytime you use the Azure Maps Render service V2, either as basemaps or layers, in any third-party map control. For more information, see [How to use the Get Map Attribution API].
6767

6868
:::image type="content" source="./media/about-azure-maps/intro_map.png" border="false" alt-text="Example of a map from the Render service V2":::
6969

7070
### Route service
7171

72-
The route services can be used to calculate the estimated arrival times (ETAs) for each requested route. Route APIs consider factors, such as real-time traffic information and historic traffic data, like the typical road speeds on the requested day of the week and time of day. The APIs return the shortest or fastest routes available to multiple destinations at a time in sequence or in optimized order, based on time or distance. The service allows developers to calculate directions across several travel modes, such as car, truck, bicycle, or walking, and electric vehicle. The service also considers inputs, such as departure time, weight restrictions, or hazardous material transport.
72+
The route service is used to calculate the estimated arrival times (ETAs) for each requested route. Factors such as real-time traffic information and historic traffic data, like the typical road speeds on the requested day of the week and time of day are considered. The route service returns the shortest or fastest routes available to multiple destinations at a time in sequence or in optimized order, based on time or distance. The service allows developers to calculate directions across several travel modes, such as car, truck, bicycle, or walking, and electric vehicle. The service also considers inputs, such as departure time, weight restrictions, or hazardous material transport.
7373

7474
:::image type="content" source="./media/about-azure-maps/intro_route.png" border="false" alt-text="Example of a map from the Route service":::
7575

@@ -79,11 +79,11 @@ The Route service offers advanced set features, such as:
7979
* Matrices of travel time and distance between a set of origins and destinations.
8080
* Finding routes or distances that users can travel based on time or fuel requirements.
8181

82-
For details on the routing capabilities, read the [Route service documentation](/rest/api/maps/route).
82+
For more information on routing capabilities, see the [Route service] documentation.
8383

8484
### Search service
8585

86-
The Search service helps developers search for addresses, places, business listings by name or category, and other geographic information. Also, services can [reverse geocode](https://en.wikipedia.org/wiki/Reverse_geocoding) addresses and cross streets based on latitudes and longitudes.
86+
The Search service helps developers search for addresses, places, business listings by name or category, and other geographic information. Also, services can [reverse geocode] addresses and cross streets based on latitudes and longitudes.
8787

8888
:::image type="content" source="./media/about-azure-maps/intro_search.png" border="false" alt-text="Example of a search on a map":::
8989

@@ -94,17 +94,17 @@ The Search service also provides advanced features such as:
9494
* Batch a group of search requests.
9595
* Search electric vehicle charging stations and Point of Interest (POI) data by brand name.
9696

97-
For more details on search capabilities, read the [Search service documentation](/rest/api/maps/search).
97+
For more information on search capabilities, see the [Search service] documentation.
9898

9999
### Spatial service
100100

101101
The Spatial service quickly analyzes location information to help inform customers of ongoing events happening in time and space. It enables near real-time analysis and predictive modeling of events.
102102

103-
The service enables customers to enhance their location intelligence with a library of common geospatial mathematical calculations. Common calculations include closest point, great circle distance, and buffers. To learn more about the service and the various features, read the [Spatial service documentation](/rest/api/maps/spatial).
103+
The service enables customers to enhance their location intelligence with a library of common geospatial mathematical calculations. Common calculations include closest point, great circle distance, and buffers. For more information about the Spatial service and its various features, see the [Spatial service] documentation.
104104

105105
### Timezone service
106106

107-
The Time zone service enables you to query current, historical, and future time zone information. You can use either latitude and longitude pairs or an [IANA ID](https://www.iana.org/) as an input. The Time zone service also allows for:
107+
The Time zone service enables you to query current, historical, and future time zone information. You can use either latitude and longitude pairs or an [IANA ID] as an input. The Time zone service also allows for:
108108

109109
* Converting Microsoft Windows time-zone IDs to IANA time zones.
110110
* Fetching a time-zone offset to UTC.
@@ -138,7 +138,7 @@ A typical JSON response for a query to the Time zone service looks like the foll
138138
}
139139
```
140140

141-
For details on this service, read the [Time zone service documentation](/rest/api/maps/timezone).
141+
For MORE INFORMATION, see the [Time zone service] documentation.
142142

143143
### Traffic service
144144

@@ -149,15 +149,15 @@ The Traffic service is a suite of web services that developers can use for web o
149149

150150
![Example of a map with traffic information](media/about-azure-maps/intro_traffic.png)
151151

152-
For more information, see the [Traffic service documentation](/rest/api/maps/traffic).
152+
For more information, see the [Traffic service] documentation.
153153

154-
### Weather services
154+
### Weather service
155155

156-
Weather services offer APIs that developers can use to retrieve weather information for a particular location. The information contains details such as observation date and time, brief description of the weather conditions, weather icon, precipitation indicator flags, temperature, and wind speed information. Other details such as RealFeel™ Temperature and UV index are also returned.
156+
The Weather service offers API to retrieve weather information for a particular location. This information includes observation date and time, weather conditions, precipitation indicator flags, temperature, and wind speed information. Other details such as RealFeel™ Temperature and UV index are also returned.
157157

158-
Developers can use the [Get Weather along route API](/rest/api/maps/weather/getweatheralongroute) to retrieve weather information along a particular route. Also, the service supports the generation of weather notifications for waypoints that are affected by weather hazards, such as flooding or heavy rain.
158+
Developers can use the [Get Weather along route API] to retrieve weather information along a particular route. Also, the service supports the generation of weather notifications for waypoints affected by weather hazards, such as flooding or heavy rain.
159159

160-
The [Get Map Tile V2 API](/rest/api/maps/render-v2/get-map-tile) allows you to request past, current, and future radar and satellite tiles.
160+
The [Get Map Tile V2 API] allows you to request past, current, and future radar and satellite tiles.
161161

162162
![Example of map with real-time weather radar tiles](media/about-azure-maps/intro_weather.png)
163163

@@ -183,17 +183,17 @@ Maps Creator provides the following services:
183183

184184
## Programming model
185185

186-
Azure Maps is built for mobility and can help you develop cross-platform applications. It uses a programming model that's language agnostic and supports JSON output through [REST APIs](/rest/api/maps/).
186+
Azure Maps is built for mobility and can help you develop cross-platform applications. It uses a programming model that's language agnostic and supports JSON output through [REST APIs].
187187

188-
Also, Azure Maps offers a convenient [JavaScript map control](/javascript/api/azure-maps-control) with a simple programming model. The development is quick and easy for both web and mobile applications.
188+
Also, Azure Maps offers a convenient [JavaScript map control] with a simple programming model. The development is quick and easy for both web and mobile applications.
189189

190190
## Power BI visual
191191

192192
The Azure Maps Power BI visual provides a rich set of data visualizations for spatial data on top of a map. It's estimated that over 80% of business data has a location context. The Azure Maps Power BI visual offers a no-code solution for gaining insights into how this location context relates to and influences your business data.
193193

194194
:::image type="content" source="./media/about-azure-maps/intro-power-bi.png" border="false" alt-text="Power BI desktop with the Azure Maps Power BI visual displaying business data":::
195195

196-
For more information, see the [Get started with Azure Maps Power BI visual](power-bi-visual-get-started.md) article.
196+
For more information, see [Get started with Azure Maps Power BI visual].
197197

198198
## Usage
199199

@@ -219,28 +219,48 @@ Verify that the location of your current IP address is in a supported country/re
219219

220220
Try a sample app that showcases Azure Maps:
221221

222-
[Quickstart: Create a web app](quick-demo-map-app.md)
222+
[Quickstart: Create a web app]
223223

224224
Stay up to date on Azure Maps:
225225

226226
[Azure Maps blog]
227227

228-
[Data service]: /rest/api/maps/data-v2
229-
[Dataset service]: creator-indoor-maps.md#datasets
228+
<!--------- learn.microsoft.com links --------------->
230229
[Conversion service]: creator-indoor-maps.md#convert-a-drawing-package
231-
[Tileset service]: creator-indoor-maps.md#tilesets
232230
[Custom styling service]: creator-indoor-maps.md#custom-styling-preview
233-
[style service]: /rest/api/maps/v20220901preview/style
234-
[visual style editor]: https://azure.github.io/Azure-Maps-Style-Editor
231+
[Dataset service]: creator-indoor-maps.md#datasets
235232
[Feature State service]: creator-indoor-maps.md#feature-statesets
236-
[WFS service]: creator-indoor-maps.md#web-feature-service-api
233+
[Get started with Azure Maps Power BI visual]: power-bi-visual-get-started.md
234+
[How to use the Get Map Attribution API]: how-to-show-attribution.md
235+
[Quickstart: Create a web app]: quick-demo-map-app.md
236+
[Tileset service]: creator-indoor-maps.md#tilesets
237237
[Wayfinding service]: creator-indoor-maps.md#wayfinding-preview
238-
[wayfinding API]: /rest/api/maps/v20220901preview/wayfinding
238+
[WFS service]: creator-indoor-maps.md#web-feature-service-api
239+
<!--------- REST API Links --------------->
240+
[Data service]: /rest/api/maps/data-v2
241+
[Geolocation service]: /rest/api/maps/geolocation
242+
[Get Map Tile V2 API]: /rest/api/maps/render-v2/get-map-tile
243+
[Get Weather along route API]: /rest/api/maps/weather/getweatheralongroute
244+
[Render service V2]: /rest/api/maps/render-v2
245+
[REST APIs]: /rest/api/maps/
246+
[Route service]: /rest/api/maps/route
239247
[routeset API]: /rest/api/maps/v20220901preview/routeset
240-
[Open Geospatial Consortium API]: https://docs.opengeospatial.org/is/17-069r3/17-069r3.html
241-
[Azure portal]: https://portal.azure.com
242-
[Azure Maps account]: https://azure.microsoft.com/services/azure-maps/
248+
[Search service]: /rest/api/maps/search
249+
[Spatial service]: /rest/api/maps/spatial
250+
[style service]: /rest/api/maps/v20220901preview/style
243251
[TilesetID]: /rest/api/maps/render-v2/get-map-tile#tilesetid
252+
[Time zone service]: /rest/api/maps/timezone
253+
[Traffic service]: /rest/api/maps/traffic
254+
[wayfinding API]: /rest/api/maps/v20220901preview/wayfinding
255+
<!--------- JavaScript API Links --------------->
256+
[JavaScript map control]: /javascript/api/azure-maps-control
257+
<!--------- External Links --------------->
258+
[Azure Maps account]: https://azure.microsoft.com/services/azure-maps/
244259
[Azure Maps blog]: https://azure.microsoft.com/blog/topics/azure-maps/
260+
[Azure portal]: https://portal.azure.com
261+
[IANA ID]: https://www.iana.org/
245262
[Microsoft Trust Center]: https://www.microsoft.com/trust-center/privacy
263+
[Open Geospatial Consortium API]: https://docs.opengeospatial.org/is/17-069r3/17-069r3.html
264+
[reverse geocode]: https://en.wikipedia.org/wiki/Reverse_geocoding
246265
[Subprocessor List]: https://servicetrust.microsoft.com/DocumentPage/aead9e68-1190-4d90-ad93-36418de5c594
266+
[visual style editor]: https://azure.github.io/Azure-Maps-Style-Editor

0 commit comments

Comments
 (0)