OfflineMapPackage Kelas

Definisi

Ruang nama:

Windows.Services.Maps.OfflineMaps

Mewakili data peta untuk wilayah geografis tertentu. Data dapat diunduh dan digunakan secara 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

Warisan

Object Platform::Object IInspectable OfflineMapPackage

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Creators Update (diperkenalkan dalam 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v4.0)

Contoh

Contoh berikut menemukan paket peta dengan menggunakan lokasi geografis. Jika paket peta belum diunduh sebelumnya ke sistem lokal, kode ini secara asinkron mengunduh peta tersebut.

Nota

Titik di dekat batas atau kotak besar dan lingkaran mungkin mengembalikan beberapa kecocokan paket peta.

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

Keterangan

Penting

Bing Maps untuk penghentian layanan Enterprise

UWP mapControl dan layanan peta dari namespace Windows.Services.Maps mengandalkan Bing Maps. Bing Maps for Enterprise tidak digunakan lagi dan akan dihentikan, di mana MapControl dan layanan tidak akan lagi menerima data.

Untuk informasi selengkapnya, lihat dokumentasi Bing Maps Developer Center dan Bing Maps.

Gunakan kelas ini untuk menemukan paket peta secara asinkron yang Anda minati menggunakan offline. Anda dapat memeriksa status paket untuk menentukan apakah paket tersebut ada di sistem lokal Anda. Jika tidak, Anda dapat mengunduhnya secara asinkron ke sistem Anda.

Anda kemudian dapat mengakses data tersebut dalam kontrol sistem seperti MapControl, dan dari objek lain di namespace Windows.Services.Maps.

Penting

Menggunakan kelas ini memerlukan kemampuan Offline Maps Management (lihat deklarasi kemampuan aplikasi ).

Properti

DisplayName	Mendapatkan nama tampilan lokasi geografis untuk paket peta offline.
EnclosingRegionName	Mendapatkan wilayah sekitar atau yang berisi paket peta offline (misalnya: AS).
EstimatedSizeInBytes	Mendapatkan perkiraan ukuran dalam byte paket peta offline.
Status	Mendapatkan status paket peta (Misalnya, apakah paket diunduh ke sistem lokal Anda atau tidak).

Metode

FindPackagesAsync(Geopoint)	Memulai operasi asinkron untuk menemukan paket peta yang berisi data peta untuk lokasi geografis tertentu.
FindPackagesInBoundingBoxAsync(GeoboundingBox)	Memulai operasi asinkron untuk menemukan paket peta yang berisi data peta untuk area geografis empat sisi tertentu.
FindPackagesInGeocircleAsync(Geocircle)	Memulai operasi asinkron untuk menemukan paket peta yang berisi data peta untuk area geografis tertentu.
RequestStartDownloadAsync()	Memulai operasi asinkron untuk meminta pengunduhan paket peta ke sistem lokal Anda.

Acara

StatusChanged

Terjadi ketika status OfflineMapPackageQueryResult berubah.