Xamarin.Essentials: geocodico

La classe Geocoding fornisce le API sia per eseguire la codifica geografica di un indicatore di posizione in coordinate posizionali che per riconvertire le coordinate posizionali in un indicatore di posizione.

Introduzione

Per iniziare a usare questa API, leggere la guida introduttiva per assicurarsi che la libreria sia installata e configurata correttamente nei progetti.

Per accedere alla funzionalità Geocoding, è necessaria la configurazione seguente specifica della piattaforma.

Non è necessaria alcuna configurazione aggiuntiva.

Uso di Geocoding

Aggiungere un riferimento Xamarin.Essentials a nella classe :

using Xamarin.Essentials;

Acquisizione delle coordinate geografiche per un indirizzo:

try
{
    var address =  "Microsoft Building 25 Redmond WA USA";
    var locations = await Geocoding.GetLocationsAsync(address);

    var location = locations?.FirstOrDefault();
    if (location != null)
    {
        Console.WriteLine($"Latitude: {location.Latitude}, Longitude: {location.Longitude}, Altitude: {location.Altitude}");
    }
}
catch (FeatureNotSupportedException fnsEx)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Handle exception that may have occurred in geocoding
}

L'altitudine non è sempre disponibile. Se non è disponibile, la proprietà Altitude potrebbe essere null o il valore potrebbe essere pari a zero. Se l'altitudine è disponibile, il valore è espresso in metri sopra il livello del mare.

Uso della geocodifica inversa

La geocodifica inversa è il processo di acquisizione degli indicatori di posizione per un set esistente di coordinate:

try
{
    var lat = 47.673988;
    var lon = -122.121513;

    var placemarks = await Geocoding.GetPlacemarksAsync(lat, lon);

    var placemark = placemarks?.FirstOrDefault();
    if (placemark != null)
    {
        var geocodeAddress =
            $"AdminArea:       {placemark.AdminArea}\n" +
            $"CountryCode:     {placemark.CountryCode}\n" +
            $"CountryName:     {placemark.CountryName}\n" +
            $"FeatureName:     {placemark.FeatureName}\n" +
            $"Locality:        {placemark.Locality}\n" +
            $"PostalCode:      {placemark.PostalCode}\n" +
            $"SubAdminArea:    {placemark.SubAdminArea}\n" +
            $"SubLocality:     {placemark.SubLocality}\n" +
            $"SubThoroughfare: {placemark.SubThoroughfare}\n" +
            $"Thoroughfare:    {placemark.Thoroughfare}\n";

        Console.WriteLine(geocodeAddress);
    }
}
catch (FeatureNotSupportedException fnsEx)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Handle exception that may have occurred in geocoding
}

Distanza tra due località

Le classi Location e LocationExtensions definiscono i metodi per calcolare la distanza tra due località. Vedere l'articolo Xamarin.Essentials: Geolocation per un esempio.

API

Altri video di Xamarin sono disponibili su Channel 9 e YouTube.