Merge pull request #284491 from jecmenicanikola/patch-1

Update how-to-dev-guide-csharp-sdk.md

Author: ttorble

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

@@ -134,183 +134,25 @@ var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ??
 var credential = new AzureKeyCredential(subscriptionKey);
 var client = new MapsSearchClient(credential); 
 ```
+## Geocode an address
 
-### Fuzzy search an entity
-
-The following code snippet demonstrates how, in a simple console application, to import the `Azure.Maps.Search` package and perform a fuzzy search on“Starbucks” near Seattle. In `Program.cs`:
+Call the `GetGeocoding` method to get the coordinate of an address.
 
 ```csharp
-using System;
-using Azure; 
-using Azure.Core.GeoJson; 
-using Azure.Maps.Search; 
-using Azure.Maps.Search.Models; 
-
 // Use Azure Maps subscription key authentication 
 var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
 var credential = new AzureKeyCredential(subscriptionKey);
 var client = new MapsSearchClient(credential); 
 
-SearchAddressResult searchResult = client.FuzzySearch( 
-    "Starbucks", new FuzzySearchOptions 
-    { 
-        Coordinates = new GeoPosition(-122.34255, 47.61010), 
-        Language = SearchLanguage.EnglishUsa 
-    }); 
-
-
-// Print the search results 
-foreach (var result in searchResult.Results) 
-{ 
-    Console.WriteLine($""" 
-        * {result.Address.StreetNumber} {result.Address.StreetName} 
-          {result.Address.Municipality} {result.Address.CountryCode} {result.Address.PostalCode} 
-          Coordinate: ({result.Position.Latitude:F4}, {result.Position.Longitude:F4}) 
-        """); 
-} 
-```
-
-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`.
-
-The following libraries are used:
+Response<GeocodingResponse> searchResult = client.GetGeocoding(
+    "1 Microsoft Way, Redmond, WA 98052");
 
-1. `Azure.Maps.Search` is required for the `MapsSearchClient` class.
-1. `Azure.Maps.Search.Models` is required for the `SearchAddressResult` class.
-1. `Azure.Core.GeoJson` is required for the `GeoPosition` struct used by the `FuzzySearchOptions` class.
-
-To run your application, go to the project folder and execute `dotnet run` in PowerShell:
-
-```powershell
-dotnet run 
-```
-
-You should see a list of Starbucks address and coordinate results:
-
-```text
-* 1912 Pike Place 
-  Seattle US 98101 
-  Coordinate: 47.61016, -122.34248 
-* 2118 Westlake Avenue 
-  Seattle US 98121 
-  Coordinate: 47.61731, -122.33782 
-* 2601 Elliott Avenue 
-  Seattle US 98121 
-  Coordinate: 47.61426, -122.35261 
-* 1730 Howell Street 
-  Seattle US 98101 
-  Coordinate: 47.61716, -122.3298 
-* 220 1st Avenue South 
-  Seattle US 98104 
-  Coordinate: 47.60027, -122.3338 
-* 400 Occidental Avenue South 
-  Seattle US 98104 
-  Coordinate: 47.5991, -122.33278 
-* 1600 East Olive Way 
-  Seattle US 98102 
-  Coordinate: 47.61948, -122.32505 
-* 500 Mercer Street 
-  Seattle US 98109 
-  Coordinate: 47.62501, -122.34687 
-* 505 5Th Ave S 
-  Seattle US 98104 
-  Coordinate: 47.59768, -122.32849 
-* 425 Queen Anne Avenue North 
-  Seattle US 98109 
-  Coordinate: 47.62301, -122.3571 
+Console.WriteLine($"The Coordinate: ({searchResult.Value.Features[0].Geometry.Coordinates})"); 
 ```
 
-## Search an address
-
-Call the `SearchAddress` method to get the coordinate of an address. Modify the Main program from the sample as follows:
-
-```csharp
-// Use Azure Maps subscription key authentication 
-var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
-var credential = new AzureKeyCredential(subscriptionKey);
-var client = new MapsSearchClient(credential); 
-
-SearchAddressResult searchResult = client.SearchAddress(
-    "1301 Alaskan Way, Seattle, WA 98101, US");
-
-if (searchResult.Results.Count > 0) 
-{
-    SearchAddressResultItem result = searchResult.Results.First(); 
-    Console.WriteLine($"The Coordinate: ({result.Position.Latitude:F4}, {result.Position.Longitude:F4})"); 
-}
-```
-
-The `SearchAddress` method returns results ordered by confidence score and since `searchResult.Results.First()` is used, only the coordinates of the first result are returned.
-
-## Batch reverse search
-
-Azure Maps Search also provides some batch query methods. These methods return Long Running Operations (LRO) objects. The requests might not return all the results immediately, so users can choose to wait until completion or query the result periodically. The following example demonstrates how to call the batched reverse search methods:
-
-```csharp
-var queries = new List<ReverseSearchAddressQuery>() 
-{ 
-    new ReverseSearchAddressQuery(new ReverseSearchOptions() 
-    { 
-        Coordinates = new GeoPosition(2.294911, 48.858561) 
-    }), 
-    new ReverseSearchAddressQuery(new ReverseSearchOptions() 
-    { 
-        Coordinates = new GeoPosition(-122.127896, 47.639765), 
-        RadiusInMeters = 5000 
-    }) 
-};
-```
+## Batch reverse geocode a set of coordinates
 
-In the above example, two queries are passed to the batched reverse search request. To get the LRO results, you have few options. The first option is to pass `WaitUntil.Completed` to the method. The request waits until all requests are finished and return the results:
-
-```csharp
-// Wait until the LRO return batch results 
-Response<ReverseSearchAddressBatchOperation> waitUntilCompletedResults = client.ReverseSearchAddressBatch(WaitUntil.Completed, queries); 
-
-// Print the result addresses 
-printReverseBatchAddresses(waitUntilCompletedResults.Value); 
-```
-
-Another option is to pass `WaitUntil.Started`. The request returns immediately, and you need to manually poll the results:
-
-```csharp
-// Manual polling the batch results 
-Response<ReverseSearchAddressBatchOperation> manualPollingOperation = client.ReverseSearchAddressBatch(WaitUntil.Started, queries);
-
-// Keep polling until we get the results
-while (true)
-{
-    manualPollingOperation.Value.UpdateStatus();
-    if (manualPollingOperation.Value.HasCompleted) break;
-    Task.Delay(1000);
-}
-printReverseBatchAddresses(manualPollingOperation);
-```
-
-We can also call `WaitUntilCompletion()` to explicitly wait for the result:
-
-```csharp
-Response<ReverseSearchAddressBatchOperation> manualPollingResult = manualPollingResults.WaitUntilCompleted();
-
-printReverseBatchAddresses(manualPollingResult.Value);
-```
-
-The third method requires the operation ID to get the results, which is cached on the server side for 14 days:
-
-```csharp
-  ReverseSearchAddressBatchOperation longRunningOperation = client.ReverseSearchAddressBatch(WaitUntil.Started, queries);
-
-  // Get batch results by ID 
-  string operationId = longRunningOperation.Value.Id;
-
-  // After the LRO completes, create a new operation
-  // to get the results from the server
-  ReverseSearchAddressBatchOperation newOperation = new ReverseSearchAddressBatchOperation(client, operationId);
-  Response<ReverseSearchAddressBatchOperation> newOperationResult = newOperation.WaitForCompletion();
-
-printReverseBatchAddresses(newOperationResult);
-```
-
-The complete code for reverse address batch search with operation ID:
+Azure Maps Search also provides some batch query APIs. The Reverse Geocoding Batch API sends batches of queries to [Reverse Geocoding API](/rest/api/maps/search/get-reverse-geocoding) using just a single API call. The API allows caller to batch up to **100** queries.
 
 ```csharp
 using system;
@@ -322,46 +164,23 @@ using Azure.Maps.Search.Models;
 // Use Azure Maps subscription key authentication 
 var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
 var credential = new AzureKeyCredential(subscriptionKey);
-var client = new MapsSearchClient(credential); 
+var client = new MapsSearchClient(credential);
 
-var queries = new List<ReverseSearchAddressQuery>()
+List<ReverseGeocodingQuery> items = new List<ReverseGeocodingQuery>
 {
-    new ReverseSearchAddressQuery(new ReverseSearchOptions()
+    new ReverseGeocodingQuery()
     {
-        Coordinates = new GeoPosition(2.294911, 48.858561)
-    }),
-    new ReverseSearchAddressQuery(new ReverseSearchOptions()
+        Coordinates = new GeoPosition(-122.34255, 47.0)
+    },
+    new ReverseGeocodingQuery()
     {
-        Coordinates = new GeoPosition(-122.127896, 47.639765),
-        RadiusInMeters = 5000
-    })
+        Coordinates = new GeoPosition(-122.34255, 47.0)
+    },
 };
-
-// Manual polling the batch results
-ReverseSearchAddressBatchOperation longRunningOperation = client.ReverseSearchAddressBatch(WaitUntil.Started, queries);
-
-// Get batch results by ID
-string operationId = longRunningOperation.Id;
-
-// A few days later, create a new operation and get the result from server
-ReverseSearchAddressBatchOperation newOperation = new ReverseSearchAddressBatchOperation(client, operationId);
-Response<ReverseSearchAddressBatchResult> newOperationResult = newOperation.WaitForCompletion();
-printReverseBatchAddresses(newOperationResult.Value);
-void printReverseBatchAddresses(ReverseSearchAddressBatchResult batchResult)
-{
-    // Print the search results
-    for (int i = 0; i < batchResult.Results.Count; i++)
-    {
-        Console.WriteLine($"Possible addresses for query {i}:");
-        var result = batchResult.Results[i];
-        foreach (var address in result.Addresses)
-        {
-            Console.WriteLine($"{address.Address.FreeformAddress}");
-        }
-    }
-}
+Response<GeocodingBatchResponse> = client.GetReverseGeocodingBatch(items);
 ```
 
+
 ## Additional information
 
 The [Azure.Maps Namespace] in the .NET documentation.
@@ -372,7 +191,6 @@ The [Azure.Maps Namespace] in the .NET documentation.
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
 [Azure.Maps Namespace]: /dotnet/api/azure.maps
 [defaultazurecredential.NET]: /dotnet/api/overview/azure/identity-readme#defaultazurecredential
-[FuzzySearch]: /dotnet/api/azure.maps.search.mapssearchclient.fuzzysearch
 [geolocation readme]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/maps/Azure.Maps.Geolocation/README.md
 [geolocation sample]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Geolocation/samples
 [geolocation package]: https://www.nuget.org/packages/Azure.Maps.geolocation