OfflineMapPackage Klasse

Definition

Namespace:

Windows.Services.Maps.OfflineMaps

Stellt die Kartendaten für eine bestimmte geografische Region dar. Die Daten können heruntergeladen und offline verwendet werden.

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

Vererbung

Object Platform::Object IInspectable OfflineMapPackage

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Creators Update (eingeführt in 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v4.0)

Beispiele

Im folgenden Beispiel werden Kartenpakete mithilfe eines geografischen Standorts gefunden. Wenn das Kartenpaket noch nicht auf das lokale System heruntergeladen wurde, lädt dieser Code diese Karte asynchron herunter.

Hinweis

Die Punkte in der Nähe eines Rahmens oder große Felder und Kreise geben möglicherweise mehrere Kartenpaket-Übereinstimmungen zurück.

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

Hinweise

Verwenden Sie diese Klasse, um asynchron nach Kartenpaketen zu suchen, die Sie offline verwenden möchten. Sie können die status von Paketen überprüfen, um zu ermitteln, ob diese Pakete auf Ihrem lokalen System vorhanden sind. Andernfalls können Sie sie asynchron auf Ihr System herunterladen.

Anschließend können Sie auf diese Daten in Systemsteuerelementen wie MapControl und von anderen Objekten im Windows.Services.Maps-Namespace zugreifen.

Eigenschaften

DisplayName	Ruft den Anzeigenamen eines geografischen Standorts für das Offlinekartenpaket ab.
EnclosingRegionName	Ruft die umgebende oder enthaltende Region des Offlinekartenpakets ab (z. B. USA).
EstimatedSizeInBytes	Ruft die geschätzte Größe des Offlinezuordnungspakets in Bytes ab.
Status	Ruft die status eines Kartenpakets ab (z. B. ob das Paket auf Ihr lokales System heruntergeladen wird oder nicht).

Methoden

FindPackagesAsync(Geopoint)	Startet einen asynchronen Vorgang, um ein Kartenpaket zu finden, das Kartendaten für den angegebenen geografischen Standort enthält.
FindPackagesInBoundingBoxAsync(GeoboundingBox)	Startet einen asynchronen Vorgang, um ein Kartenpaket zu finden, das Kartendaten für den angegebenen vierseitigen geografischen Bereich enthält.
FindPackagesInGeocircleAsync(Geocircle)	Startet einen asynchronen Vorgang, um ein Kartenpaket zu finden, das Kartendaten für den angegebenen geografischen Bereich enthält.
RequestStartDownloadAsync()	Startet einen asynchronen Vorgang, um den Download eines Kartenpakets auf Ihr lokales System anzufordern.

Ereignisse

StatusChanged

Tritt auf, wenn sich die status eines OfflineMapPackageQueryResult ändert.