OfflineMapPackage Clase

Definición

Espacio de nombres:

Windows.Services.Maps.OfflineMaps

Representa los datos de mapa de una región geográfica determinada. Los datos se pueden descargar y usar sin conexión.

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

Herencia

Object Platform::Object IInspectable OfflineMapPackage

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)

Ejemplos

En el ejemplo siguiente se busca un paquete de mapa mediante una ubicación geográfica. Si el paquete de mapa no se ha descargado previamente en el sistema local, este código descarga de forma asincrónica ese mapa.

Nota

Los puntos cerca de un borde o cuadros grandes y círculos pueden devolver varias coincidencias del paquete 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.
                }
            }
        }
    }
}

Comentarios

Importante

de retirada del servicio Bing Maps for Enterprise

Los mapControl de UWP y los servicios de asignación de los espacios de nombres de Windows.Services.Maps se basan en Mapas de Bing. Bing Maps for Enterprise está en desuso y se retirará, momento en el que los servicios y MapControl ya no recibirán datos.

Para obtener más información, consulte la del Centro para desarrolladores de Mapas de Bing y documentación de Mapas de Bing.

Use esta clase para buscar de forma asincrónica paquetes de mapa que le interesen usar sin conexión. Puede comprobar el estado de los paquetes para determinar si esos paquetes existen en el sistema local. Si no lo hacen, puede descargarlos de forma asincrónica en el sistema.

A continuación, puede acceder a esos datos en controles del sistema, como el MapControl, y desde otros objetos del espacio de nombres Windows.Services.Maps.

Importante

El uso de esta clase requiere la funcionalidad Offline Maps Management (consulte Declaraciones de funcionalidad de la aplicación).

Propiedades

DisplayName	Obtiene el nombre para mostrar de una ubicación geográfica para el paquete de mapa sin conexión.
EnclosingRegionName	Obtiene la región circundante o contenedora del paquete de mapa sin conexión (por ejemplo: EE. UU.).
EstimatedSizeInBytes	Obtiene el tamaño estimado en bytes del paquete de mapa sin conexión.
Status	Obtiene el estado de un paquete de mapa (por ejemplo, si el paquete se descarga en el sistema local o no).

Métodos

FindPackagesAsync(Geopoint)	Inicia una operación asincrónica para buscar un paquete de mapa que contenga datos de mapa para la ubicación geográfica especificada.
FindPackagesInBoundingBoxAsync(GeoboundingBox)	Inicia una operación asincrónica para buscar un paquete de mapa que contenga datos de mapa para el área geográfica especificada de cuatro lados.
FindPackagesInGeocircleAsync(Geocircle)	Inicia una operación asincrónica para buscar un paquete de mapa que contenga datos de mapa para el área geográfica especificada.
RequestStartDownloadAsync()	Inicia una operación asincrónica para solicitar la descarga de un paquete de asignación al sistema local.

Eventos

StatusChanged

Se produce cuando cambia el estado de un OfflineMapPackageQueryRes ult.