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 wird mithilfe eines geografischen Standorts ein Kartenpaket gefunden. Wenn das Kartenpaket noch nicht auf das lokale System heruntergeladen wurde, lädt dieser Code diese Zuordnung asynchron herunter.

Anmerkung

Die Punkte in der Nähe eines Rahmens oder großer Felder und Kreise geben möglicherweise mehrere Zuordnungspakete 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

Wichtig

Bing Maps for Enterprise-Dienst wird

Die UWP-MapControl- und Kartendienste aus den Windows.Services.Maps Namespaces basieren auf Bing Maps. Bing Maps for Enterprise ist veraltet und wird eingestellt, zu diesem Zeitpunkt empfangen mapControl und Dienste keine Daten mehr.

Weitere Informationen finden Sie im Bing Maps Developer Center und Bing Maps-Dokumentation.

Verwenden Sie diese Klasse, um asynchron Kartenpakete zu finden, die Sie für die Verwendung im Offlinemodus interessieren. Sie können den Status von Paketen überprüfen, um zu ermitteln, ob diese Pakete in Ihrem lokalen System vorhanden sind. Wenn sie dies nicht tun, können Sie sie asynchron auf Ihr System herunterladen.

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

Wichtig

Die Verwendung dieser Klasse erfordert die Offline Maps Management-Funktion (siehe App-Funktionsdeklarationen).

Eigenschaften

DisplayName	Ruft den Anzeigenamen eines geografischen Standorts für das Offlinekartenpaket ab.
EnclosingRegionName	Ruft die umgebungs- oder enthaltende Region des Offlinekartenpakets ab (z. B. USA).
EstimatedSizeInBytes	Ruft die geschätzte Größe in Byte des Offlinezuordnungspakets ab.
Status	Ruft den Status eines Kartenpakets ab (z. B. ob das Paket in 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 an Ihr lokales System anzufordern.

Ereignisse

StatusChanged

Tritt auf, wenn sich der Status eines OfflineMapPackageQueryResult ändert.