地理编码

浏览示例

本文介绍如何使用 .NET Multi-platform App UI (.NET MAUI) IGeocoding 接口。 该接口提供的 API 可以将地理标记编码为位置坐标，还可以将地理代码坐标反向编码为位置标记。

IGeocoding 接口的默认实现通过 Geocoding.Default 属性提供。 IGeocoding 接口和 Geocoding 类都包含在 Microsoft.Maui.Devices.Sensors 命名空间中。

开始使用

要访问地理编码功能，需要以下特定于平台的设置。

Android

无需设置。

iOS/Mac Catalyst

无需设置。

Windows

需要必应地图 API 密钥才能使用地理编码功能。 注册免费的必应地图帐户。 在“我的帐户”>“我的密钥”下，创建一个新密钥并根据您的应用程序类型填写信息，应该是“Windows 应用程序”。

要在应用中启用地理编码功能，请对 MauiProgram.cs 文件中的 MauiAppBuilder 对象调用 ConfigureEssentials 方法。 然后，在 IEssentialsBuilder 对象上调用 UseMapServiceToken 方法，并将必应地图 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 类定义了可用于计算两个位置之间的距离的方法。 有关获取两个位置之间的距离的示例，请参阅两个位置之间的距离。