OfflineMapPackage Kelas

Referensi

Definisi

Ruang nama:: Windows.Services.Maps.OfflineMaps

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

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.

Catatan

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

Gunakan kelas ini untuk menemukan paket peta secara asinkron yang Anda minati untuk 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 .

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.

Berlaku untuk

Bagikan melalui