OfflineMapPackage Classe

Definição

Namespace:

Windows.Services.Maps.OfflineMaps

Representa os dados do mapa para uma região geográfica específica. Os dados podem ser baixados e usados offline.

public ref class OfflineMapPackage sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class OfflineMapPackage final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class OfflineMapPackage

Public NotInheritable Class OfflineMapPackage

Herança

Object Platform::Object IInspectable OfflineMapPackage

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Exemplos

O exemplo a seguir localiza um mapa de pacotes usando uma localização geográfica. Se o pacote de mapa não tiver sido baixado anteriormente para o sistema local, esse código baixará esse mapa de forma assíncrona.

Nota

Os pontos próximos a uma borda ou caixas grandes e círculos podem retornar várias correspondências de pacote de mapa.

private async Task getMapPackages()
{
    Geopoint myPoint = new Geopoint(new BasicGeoposition()
    {
        //Geopoint for Seattle
        Latitude = 47.604,
        Longitude = -122.329
    });

    var queryResult = await OfflineMapPackage.FindPackagesAsync(myPoint);

    if (queryResult.Status == OfflineMapPackageQueryStatus.Success)
    {
        foreach (OfflineMapPackage package in queryResult.Packages)
        {
            if (package.Status != OfflineMapPackageStatus.Downloaded)
            {
                var downloadRequestResult = await package.RequestStartDownloadAsync();

                if (downloadRequestResult.Status == OfflineMapPackageStartDownloadStatus.Success)
                {
                    // do something with the offline map package.
                }
            }
        }
    }
}

Comentários

Importante

de desativação do serviço Bing Mapas para Empresas

Os serviços de MapControl da UWP e os serviços de mapa dos namespaces Windows.Services.Maps dependem do Bing Mapas. O Bing Mapas para Empresas foi preterido e será desativado, momento em que o MapControl e os serviços não receberão mais dados.

Para obter mais informações, consulte a do Centro de Desenvolvedores do Bing Mapas do e documentação do Bing Mapas.

Use essa classe para localizar de forma assíncrona os pacotes de mapa que você está interessado em usar offline. Você pode verificar o status dos pacotes para determinar se esses pacotes existem em seu sistema local. Se não o fizerem, você poderá baixá-los de forma assíncrona em seu sistema.

Em seguida, você pode acessar esses dados em controles do sistema, como o MapControl e de outros objetos no namespace Windows.Services.Maps.

Importante

Usar essa classe requer a funcionalidade Offline Maps Management (consulte declarações de funcionalidade de aplicativo).

Propriedades

DisplayName	Obtém o nome de exibição de uma localização geográfica para o pacote de mapa offline.
EnclosingRegionName	Obtém a região ao redor ou que contém o pacote de mapa offline (por exemplo: EUA).
EstimatedSizeInBytes	Obtém o tamanho estimado em bytes do pacote de mapa offline.
Status	Obtém o status de um pacote de mapa (por exemplo, se o pacote é baixado para o sistema local ou não).

Métodos

FindPackagesAsync(Geopoint)	Inicia uma operação assíncrona para localizar um pacote de mapa que contém dados de mapa para a localização geográfica especificada.
FindPackagesInBoundingBoxAsync(GeoboundingBox)	Inicia uma operação assíncrona para localizar um pacote de mapa que contém dados de mapa para a área geográfica de quatro lados especificada.
FindPackagesInGeocircleAsync(Geocircle)	Inicia uma operação assíncrona para localizar um pacote de mapa que contém dados de mapa para a área geográfica especificada.
RequestStartDownloadAsync()	Inicia uma operação assíncrona para solicitar o download de um pacote de mapa para seu sistema local.

Eventos

StatusChanged

Ocorre quando o status de um OfflineMapPackageQueryResult é alterado.