地理編碼

流覽範例

本文說明如何使用 .NET 多平臺應用程式 UI （.NET MAUI） IGeocoding 介面。 此介面提供 API，將地標記地理編碼為位置座標，並將地理編碼座標反向編碼為地標記。

介面的預設實作 IGeocoding 可透過 Geocoding.Default 屬性取得。 IGeocoding介面和Geocoding類別都包含在 命名空間中Microsoft.Maui.Devices.Sensors。

開始使用

若要存取 地理編碼 功能，需要下列平臺特定設定。

Android

不需要任何設定。

iOS/Mac Catalyst

不需要任何設定。

Windows

需要 Bing 地圖服務 API 金鑰，才能使用地理編碼功能。 註冊免費的 Bing 地圖服務帳戶。 在 [我的帳戶>我的密鑰] 下，建立新的密鑰，並根據您的應用程式類型填寫資訊，這應該是 Windows 應用程式。

若要在應用程式中啟用地理編碼功能，請在MauiProgram.cs檔案中的物件上MauiAppBuilder叫ConfigureEssentials用 方法。 然後，在 IEssentialsBuilder 物件上，呼叫 UseMapServiceToken 方法，並將 Bing 地圖 API 金鑰當做 自變數傳遞：

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();

    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
        })
        .ConfigureEssentials(essentials =>
        {
            essentials.UseMapServiceToken("YOUR-API-TOKEN");
        });

    return builder.Build();
}

使用地理編碼

下列範例示範如何取得位址的位置座標：

string address = "Microsoft Building 25 Redmond WA USA";
IEnumerable<Location> locations = await Geocoding.Default.GetLocationsAsync(address);

Location location = locations?.FirstOrDefault();

if (location != null)
    Console.WriteLine($"Latitude: {location.Latitude}, Longitude: {location.Longitude}, Altitude: {location.Altitude}");

高度不一定可用。 如果無法使用， Altitude 則屬性可能是 null，或值可能是 0。 如可使用高度，此值 (公尺) 會高於海平面。

反向地理編碼

反向地理編碼是取得現有座標集的尺規程式。 下列範例示範取得印記：

private async Task<string> GetGeocodeReverseData(double latitude = 47.673988, double longitude = -122.121513)
{
    IEnumerable<Placemark> placemarks = await Geocoding.Default.GetPlacemarksAsync(latitude, longitude);

    Placemark placemark = placemarks?.FirstOrDefault();

    if (placemark != null)
    {
        return
            $"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";

    }

    return "";
}

取得兩個位置之間的距離

Location 和 LocationExtensions 類別會定義方法，以計算兩個位置之間的距離。 如需取得兩個位置之間距離的範例，請參閱 兩個位置之間的距離。