Skip to content

Commit 7d1d77a

Browse files
committed
end-links
1 parent d90ff4c commit 7d1d77a

File tree

4 files changed

+69
-85
lines changed

4 files changed

+69
-85
lines changed

articles/azure-maps/how-to-dev-guide-csharp-sdk.md

Lines changed: 27 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -12,16 +12,16 @@ services: azure-maps
1212

1313
# C# REST SDK Developers Guide
1414

15-
The Azure Maps C# SDK supports functionality available in the [Azure Maps Rest API][Rest API], like searching for an address, routing between different coordinates, and getting the geo-location of a specific IP address. This article introduces the C# REST SDK with examples to help you get started building location-aware applications in C# that incorporates the power of Azure Maps.
15+
The Azure Maps C# SDK supports functionality available in the Azure Maps [Rest API], like searching for an address, routing between different coordinates, and getting the geo-location of a specific IP address. This article introduces the C# REST SDK with examples to help you get started building location-aware applications in C# that incorporates the power of Azure Maps.
1616

1717
> [!NOTE]
18-
> Azure Maps C# SDK supports any .NET version that is compatible with [.NET standard 2.0][.NET standard]. For an interactive table, see [.NET Standard versions][.NET Standard versions].
18+
> Azure Maps C# SDK supports any .NET version that is compatible with [.NET standard] version 2.0 or higher. For an interactive table, see [.NET Standard versions].
1919
2020
## Prerequisites
2121

22-
- [Azure Maps account][Azure Maps account].
23-
- [Subscription key][Subscription key] or other form of [authentication][authentication].
24-
- [.NET standard][.NET standard] version 2.0 or higher.
22+
- [Azure Maps account].
23+
- [Subscription key] or other form of [Authentication with Azure Maps].
24+
- [.NET standard] version 2.0 or higher.
2525

2626
> [!TIP]
2727
> You can create an Azure Maps account programmatically, Here's an example using the Azure CLI:
@@ -61,7 +61,7 @@ dotnet add package Azure.Maps.Geolocation --prerelease
6161

6262
## Create and authenticate a MapsSearchClient
6363

64-
The client object used to access the Azure Maps Search APIs require either an `AzureKeyCredential` object to authenticate when using an Azure Maps subscription key or a `TokenCredential` object with the Azure Maps client ID when authenticating using Azure Active Directory (Azure AD). For more information on authentication, see [Authentication with Azure Maps][authentication].
64+
The client object used to access the Azure Maps Search APIs require either an `AzureKeyCredential` object to authenticate when using an Azure Maps subscription key or a `TokenCredential` object with the Azure Maps client ID when authenticating using Azure Active Directory (Azure AD). For more information on authentication, see [Authentication with Azure Maps].
6565

6666
### Using an Azure AD credential
6767

@@ -71,7 +71,7 @@ You can authenticate with Azure AD using the [Azure Identity library][Identity l
7171
dotnet add package Azure.Identity
7272
```
7373

74-
You need to register the new Azure AD application and grant access to Azure Maps by assigning the required role to your service principal. For more information, see [Host a daemon on non-Azure resources][Host daemon]. The Application (client) ID, a Directory (tenant) ID, and a client secret are returned. Copy these values and store them in a secure place. You need them in the following steps.
74+
You need to register the new Azure AD application and grant access to Azure Maps by assigning the required role to your service principal. For more information, see [Host a daemon on non-Azure resources]. The Application (client) ID, a Directory (tenant) ID, and a client secret are returned. Copy these values and store them in a secure place. You need them in the following steps.
7575

7676
Set the values of the Application (client) ID, Directory (tenant) ID, and client secret of your Azure AD application, and the map resource’s client ID as environment variables:
7777

@@ -167,7 +167,7 @@ foreach (var result in searchResult.Results)
167167
}
168168
```
169169

170-
The above code snippet demonstrates how to create a `MapsSearchClient` object using your Azure credentials, then uses its [FuzzySearch][FuzzySearch] method, passing in the point of interest (POI) name "_Starbucks_" and coordinates _GeoPosition(-122.31, 47.61)_. The SDK packages and sends the results to the Azure Maps REST endpoints. When the search results are returned, they're written out to the screen using `Console.WriteLine`.
170+
The above code snippet demonstrates how to create a `MapsSearchClient` object using your Azure credentials, then uses its [FuzzySearch] method, passing in the point of interest (POI) name "_Starbucks_" and coordinates _GeoPosition(-122.31, 47.61)_. The SDK packages and sends the results to the Azure Maps REST endpoints. When the search results are returned, they're written out to the screen using `Console.WriteLine`.
171171

172172
The following libraries are used:
173173

@@ -361,31 +361,28 @@ void printReverseBatchAddresses(ReverseSearchAddressBatchResult batchResult)
361361

362362
## Additional information
363363

364-
The [Azure.Maps Namespace][Azure.Maps Namespace] in the .NET documentation.
364+
The [Azure.Maps Namespace] in the .NET documentation.
365365

366-
[Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
367-
[Subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
368-
369-
[authentication]: azure-maps-authentication.md
370-
[Host daemon]: ./how-to-secure-daemon-app.md#host-a-daemon-on-non-azure-resources
366+
[.NET Standard versions]: https://dotnet.microsoft.com/platform/dotnet-standard#versions
371367
[.NET standard]: /dotnet/standard/net-standard?tabs=net-standard-2-0
368+
[Authentication with Azure Maps]: azure-maps-authentication.md
369+
[Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
370+
[Azure.Maps Namespace]: /dotnet/api/azure.maps
371+
[defaultazurecredential.NET]: /dotnet/api/overview/azure/identity-readme?view=azure-dotnet#defaultazurecredential
372+
[FuzzySearch]: /dotnet/api/azure.maps.search.mapssearchclient.fuzzysearch
373+
[geolocation readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Geolocation/README.md
374+
[geolocation sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Geolocation/samples
375+
[geolocation package]: https://www.nuget.org/packages/Azure.Maps.geolocation
376+
[Host a daemon on non-Azure resources]: ./how-to-secure-daemon-app.md#host-a-daemon-on-non-azure-resources
377+
[Identity library .NET]: /dotnet/api/overview/azure/identity-readme?view=azure-dotnet
378+
[rendering package]: https://www.nuget.org/packages/Azure.Maps.Rendering
379+
[rendering readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Rendering/README.md
380+
[rendering sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Rendering/samples
372381
[Rest API]: /rest/api/maps/
373-
[.NET Standard versions]: https://dotnet.microsoft.com/platform/dotnet-standard#versions
374-
[search package]: https://www.nuget.org/packages/Azure.Maps.Search
375-
[search readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Search/README.md
376-
[search sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Search/samples
377382
[routing package]: https://www.nuget.org/packages/Azure.Maps.Routing
378383
[routing readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Routing/README.md
379384
[routing sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Routing/samples
380-
[rendering package]: https://www.nuget.org/packages/Azure.Maps.Rendering
381-
[rendering readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Rendering/README.md
382-
[rendering sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Rendering/samples
383-
[geolocation package]: https://www.nuget.org/packages/Azure.Maps.geolocation
384-
[geolocation readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Geolocation/README.md
385-
[geolocation sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Geolocation/samples
386-
[FuzzySearch]: /dotnet/api/azure.maps.search.mapssearchclient.fuzzysearch
387-
[Azure.Maps Namespace]: /dotnet/api/azure.maps
388-
[search-api]: /dotnet/api/azure.maps.search
389-
[Identity library .NET]: /dotnet/api/overview/azure/identity-readme?view=azure-dotnet
390-
[defaultazurecredential.NET]: /dotnet/api/overview/azure/identity-readme?view=azure-dotnet#defaultazurecredential
391-
[NuGet]: https://www.nuget.org/
385+
[search package]: https://www.nuget.org/packages/Azure.Maps.Search
386+
[search readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Search/README.md
387+
[search sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Search/samples
388+
[Subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account

articles/azure-maps/how-to-dev-guide-java-sdk.md

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -392,33 +392,32 @@ public class Demo{
392392
}
393393
```
394394

395-
[Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
396-
[Subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
397395
[authentication]: azure-maps-authentication.md
398-
396+
[Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
397+
[defaultazurecredential]: /azure/developer/java/sdk/identity-azure-hosted-auth#default-azure-credential
398+
[Host daemon]: ./how-to-secure-daemon-app.md#host-a-daemon-on-non-azure-resources
399+
[Identity library]: /java/api/overview/azure/identity-readme?source=recommendations&view=azure-java-stable
399400
[Java Standard Versions]: https://www.oracle.com/java/technologies/downloads/
400401
[Java Version 8]: /azure/developer/java/fundamentals/?view=azure-java-stable
401402
[maven]: /azure/developer/java/sdk/get-started-maven
402-
[Identity library]: /java/api/overview/azure/identity-readme?source=recommendations&view=azure-java-stable
403-
[defaultazurecredential]: /azure/developer/java/sdk/identity-azure-hosted-auth#default-azure-credential
404-
[Host daemon]: ./how-to-secure-daemon-app.md#host-a-daemon-on-non-azure-resources
403+
[Subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
405404

406405
<!-- Java SDK Developers Guide --->
407-
[java search package]: https://repo1.maven.org/maven2/com/azure/azure-maps-search
408-
[java search readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-search/README.md
409-
[java search sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-search/src/samples/java/com/azure/maps/search/samples
410-
[java routing package]: https://repo1.maven.org/maven2/com/azure/azure-maps-route
411-
[java routing readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-route/README.md
412-
[java routing sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-route/src/samples/java/com/azure/maps/route/samples
406+
[java elevation package]: https://repo1.maven.org/maven2/com/azure/azure-maps-elevation
407+
[java elevation readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-elevation/README.md
408+
[java elevation sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-elevation/src/samples/java/com/azure/maps/elevation/samples
409+
[java geolocation readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-geolocation/README.md
410+
[java geolocation sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-geolocation/src/samples/java/com/azure/maps/geolocation/samples
411+
[java geolocation package]: https://repo1.maven.org/maven2/com/azure/azure-maps-geolocation
413412
[java rendering package]: https://repo1.maven.org/maven2/com/azure/azure-maps-render
414413
[java rendering readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-render/README.md
415414
[java rendering sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-render/src/samples/java/com/azure/maps/render/samples
416-
[java geolocation package]: https://repo1.maven.org/maven2/com/azure/azure-maps-geolocation
417-
[java geolocation readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-geolocation/README.md
418-
[java geolocation sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-geolocation/src/samples/java/com/azure/maps/geolocation/samples
419-
[java timezone package]: https://repo1.maven.org/maven2/com/azure/azure-maps-timezone
415+
[java routing package]: https://repo1.maven.org/maven2/com/azure/azure-maps-route
416+
[java routing readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-route/README.md
417+
[java routing sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-route/src/samples/java/com/azure/maps/route/samples
418+
[java search package]: https://repo1.maven.org/maven2/com/azure/azure-maps-search
419+
[java search readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-search/README.md
420+
[java search sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-search/src/samples/java/com/azure/maps/search/samples
420421
[java timezone readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-timezone/README.md
421422
[java timezone sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-timezone/src/samples/java/com/azure/maps/timezone/samples
422-
[java elevation package]: https://repo1.maven.org/maven2/com/azure/azure-maps-elevation
423-
[java elevation readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/maps/azure-maps-elevation/README.md
424-
[java elevation sample]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-elevation/src/samples/java/com/azure/maps/elevation/samples
423+
[java timezone package]: https://repo1.maven.org/maven2/com/azure/azure-maps-timezone

articles/azure-maps/how-to-dev-guide-js-sdk.md

Lines changed: 21 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The Azure Maps JavaScript/TypeScript REST SDK (JavaScript SDK) supports searchin
2020
## Prerequisites
2121

2222
- [Azure Maps account].
23-
- [Subscription key] or other form of [authentication].
23+
- [Subscription key] or other form of [Authentication with Azure Maps].
2424
- [Node.js].
2525

2626
> [!TIP]
@@ -69,7 +69,7 @@ mapsDemo
6969

7070
## Create and authenticate a MapsSearchClient
7171

72-
You need a `credential` object for authentication when creating the `MapsSearchClient` object used to access the Azure Maps search APIs. You can use either an Azure Active Directory (Azure AD) credential or an Azure subscription key to authenticate. For more information on authentication, see [Authentication with Azure Maps][authentication].
72+
You need a `credential` object for authentication when creating the `MapsSearchClient` object used to access the Azure Maps search APIs. You can use either an Azure Active Directory (Azure AD) credential or an Azure subscription key to authenticate. For more information on authentication, see [Authentication with Azure Maps].
7373

7474
> [!TIP]
7575
> The`MapsSearchClient` is the primary interface for developers using the Azure Maps search library. See [Azure Maps Search client library][JS-SDK] to learn more about the search methods available.
@@ -377,42 +377,30 @@ main().catch(console.error);
377377

378378
- The [Azure Maps Search client library for JavaScript/TypeScript][JS-SDK].
379379

380-
[JS-SDK]: /javascript/api/@azure-rest/maps-search
381-
380+
[Authentication with Azure Maps]: azure-maps-authentication.md
381+
[Azure Core Authentication Package]: /javascript/api/@azure/core-auth/
382+
[Azure Identity library]: /javascript/api/overview/azure/identity-readme
383+
[Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
382384
[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-js/tree/@azure/maps-search_1.0.0-beta.1/sdk/identity/identity#defaultazurecredential
383-
384-
[searchAddress]: /javascript/api/@azure-rest/maps-search/searchaddress
385-
385+
[dotenv]: https://github.com/motdotla/dotenv#readme
386386
[FuzzySearchRequest]: /javascript/api/@azure-rest/maps-search/fuzzysearch
387-
388387
[FuzzySearchResult]: /javascript/api/@azure-rest/maps-search/searchfuzzysearch200response
389-
390-
391-
[Search service]: /rest/api/maps/search
388+
[Host a daemon on non-Azure resources]: ./how-to-secure-daemon-app.md#host-a-daemon-on-non-azure-resources
389+
[js geolocation package]: https://www.npmjs.com/package/@azure-rest/maps-geolocation
390+
[js geolocation readme]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/maps/maps-geolocation-rest/README.md
391+
[js geolocation sample]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-geolocation-rest/samples/v1-beta
392+
[js render package]: https://www.npmjs.com/package/@azure-rest/maps-render
393+
[js render readme]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/maps/maps-render-rest/README.md
394+
[js render sample]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-render-rest/samples/v1-beta
395+
[js route package]: https://www.npmjs.com/package/@azure-rest/maps-route
396+
[js route readme]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/maps/maps-route-rest/README.md
397+
[js route sample]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-route-rest/samples/v1-beta
398+
[JS-SDK]: /javascript/api/@azure-rest/maps-search
392399
[Node.js Release Working Group]: https://github.com/nodejs/release#release-schedule
393400
[Node.js]: https://nodejs.org/en/download/
394-
[Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
395-
[Subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
396-
397-
[authentication]: azure-maps-authentication.md
398-
[Azure Identity library]: /javascript/api/overview/azure/identity-readme
399-
[Azure Core Authentication Package]: /javascript/api/@azure/core-auth/
400-
401-
[Host a daemon on non-Azure resources]: ./how-to-secure-daemon-app.md#host-a-daemon-on-non-azure-resources
402-
[dotenv]: https://github.com/motdotla/dotenv#readme
403-
404401
[search package]: https://www.npmjs.com/package/@azure-rest/maps-search
405402
[search readme]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/maps/maps-search-rest/README.md
406403
[search sample]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-search-rest/samples/v1-beta
407-
408-
[js route readme]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/maps/maps-route-rest/README.md
409-
[js route package]: https://www.npmjs.com/package/@azure-rest/maps-route
410-
[js route sample]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-route-rest/samples/v1-beta
411-
412-
[js render readme]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/maps/maps-render-rest/README.md
413-
[js render package]: https://www.npmjs.com/package/@azure-rest/maps-render
414-
[js render sample]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-render-rest/samples/v1-beta
415-
416-
[js geolocation readme]: https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/maps/maps-geolocation-rest/README.md
417-
[js geolocation package]: https://www.npmjs.com/package/@azure-rest/maps-geolocation
418-
[js geolocation sample]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-geolocation-rest/samples/v1-beta
404+
[Search service]: /rest/api/maps/search
405+
[searchAddress]: /javascript/api/@azure-rest/maps-search/searchaddress
406+
[Subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account

0 commit comments

Comments
 (0)