OfflineMapPackage Classe

Définition

Espace de noms:

Windows.Services.Maps.OfflineMaps

Représente les données cartographiques d’une région géographique particulière. Les données peuvent être téléchargées et utilisées hors connexion.

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

Héritage

Object Platform::Object IInspectable OfflineMapPackage

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v4.0)

Exemples

L’exemple suivant recherche des packages de carte à l’aide d’un emplacement géographique. Si le package de carte n’a pas été précédemment téléchargé sur le système local, ce code télécharge de façon asynchrone cette carte.

Note

Les points proches d’une bordure ou d’un grand rectangle et de cercles peuvent renvoyer plusieurs correspondances de package de carte.

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.
                }
            }
        }
    }
}

Remarques

Important

la mise hors service Bing Maps for Enterprise

Les services mapControl UWP et mappés à partir des espaces de noms Windows.Services.Maps s’appuient sur Bing Maps. Bing Maps for Enterprise est déconseillé et sera mis hors service, auquel cas mapControl et les services ne recevront plus de données.

Pour plus d’informations, consultez la documentation du Centre de développement Bing Maps et documentation Bing Maps.

Utilisez cette classe pour rechercher de manière asynchrone les packages de mappage qui vous intéressent à l’utilisation hors connexion. Vous pouvez vérifier l’état des packages pour déterminer si ces packages existent sur votre système local. Si ce n’est pas le cas, vous pouvez les télécharger de manière asynchrone sur votre système.

Vous pouvez ensuite accéder à ces données dans les contrôles système, tels que leMapControl , et à partir d’autres objets de l’espace de noms Windows.Services.Maps.

Important

L’utilisation de cette classe nécessite la fonctionnalité de Offline Maps Management (voir déclarations de fonctionnalité d’application).

Propriétés

DisplayName	Obtient le nom complet d’un emplacement géographique pour le package de carte hors connexion.
EnclosingRegionName	Obtient la région environnante ou contenant du package de carte hors connexion (par exemple : États-Unis).
EstimatedSizeInBytes	Obtient la taille estimée en octets du package de carte hors connexion.
Status	Obtient l’état d’un package map (par exemple, si le package est téléchargé sur votre système local ou non).

Méthodes

FindPackagesAsync(Geopoint)	Démarre une opération asynchrone pour rechercher un package de carte qui contient des données cartographiques pour l’emplacement géographique spécifié.
FindPackagesInBoundingBoxAsync(GeoboundingBox)	Démarre une opération asynchrone pour rechercher un package de carte qui contient des données cartographiques pour la zone géographique à quatre côtés spécifiée.
FindPackagesInGeocircleAsync(Geocircle)	Démarre une opération asynchrone pour rechercher un package de carte qui contient des données cartographiques pour la zone géographique spécifiée.
RequestStartDownloadAsync()	Démarre une opération asynchrone pour demander le téléchargement d’un package de carte à votre système local.

Événements

StatusChanged

Se produit lorsque l’état d’un OfflineMapPackageQueryResult change.