Namespace: XPlat.Services.Maps

Provides methods to convert addresses to geographic locations (geocoding) and to convert geographic locations to addresses (reverse geocoding).

public static class MapLocationFinder

Supported platforms

Example

This example shows how to convert a geographic location to an address (reverse geocoding).

using XPlat.Services.Maps;
...
​
private async void OnReverseGeocodeButtonClick(object sender, RoutedEventArgs e)
{
    // The location to reverse geocode.
    var location = new XPlat.Device.Geolocation.BasicGeoposition { Latitude = 47.643, Longitude = -122.131 };
    var pointToReverseGeocode = new XPlat.Device.Geolocation.Geopoint(location);
​
    // Reverse geocode the specified geographic location.
    XPlat.Services.Maps.MapLocationFinderResult result =
        await XPlat.Services.Maps.MapLocationFinder.FindLocationsAtAsync(pointToReverseGeocode);
​
    // If the query returns results, display the address of the first result.
    if (result.Status == XPlat.Services.Maps.MapLocationFinderStatus.Success)
    {
    System.Diagnostics.Debug.WriteLine($"Address - {result.Locations[0].Address}");
    }
}

Static Methods

Task FindLocationsAtAsync(Geopoint)

Converts a geopoint to a collection of addresses (reverse geocoding).

public static Task<MapLocationFinderResult> FindLocationsAtAsync(Geopoint queryPoint)

Parameters

queryPoint (Geopoint)

The point for which you want to get locations.

Returns

When this method completes successfully, it returns a list of locations contained in the MapLocationFinderResult.

Task FindLocationsAtAsync(Geopoint, MapLocationDesiredAccuracy)

Converts a geopoint to a collection of addresses with the desired accuracy (reverse geocoding).

public static Task<MapLocationFinderResult> FindLocationsAtAsync(Geopoint queryPoint, MapLocationDesiredAccuracy accuracy)

Parameters

queryPoint (Geopoint)

The point for which you want to get locations.

accuracy (MapLocationDesiredAccuracy)

The desired accuracy for which you want to get locations.

Returns

When this method completes successfully, it returns a list of locations contained in the MapLocationFinderResult.

Related information

References

​Perform geocoding and reverse geocoding - Microsoft Docs​

​MapLocationFinder - Microsoft Docs​