OfflineMapPackage 類別

定義

命名空間:

Windows.Services.Maps.OfflineMaps

代表特定地理區域的地圖數據。 數據可以下載並離線使用。

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

繼承

Object Platform::Object IInspectable OfflineMapPackage

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 Creators Update (已於 10.0.15063.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v4.0 引進)

範例

下列範例會使用地理位置尋找地圖套件。 如果地圖套件先前尚未下載到本機系統，此程式代碼會以異步方式下載該對應。

注意

框線或大型方塊和圓形附近的點可能會傳回多個地圖套件相符專案。

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

備註

重要

Bing 地圖服務企業版服務淘汰

來自 Windows.Services.Maps 命名空間的 UWP MapControl 和地圖服務依賴 Bing 地圖服務。 Bing Enterprise 地圖服務已被取代，且將會淘汰，此時 MapControl 和服務將不再接收數據。

如需詳細資訊，請參閱 Bing 地圖服務開發人員中心 和 Bing 地圖服務檔。

使用此類別以異步方式尋找您有興趣離線使用的對應套件。 您可以檢查套件的狀態，以判斷這些套件是否存在於本機系統上。 如果沒有，您可以以異步方式將其下載到您的系統。

然後，您可以在系統控件中存取該數據，例如 MapControl，以及從 Windows.Services.Maps 命名空間中的其他物件存取該數據。

重要

使用此類別需要 Offline Maps Management 功能（請參閱 應用程式功能宣告）。

屬性

DisplayName	取得離線地圖套件的地理位置顯示名稱。
EnclosingRegionName	取得離線地圖套件的周圍或包含區域（例如：USA）。
EstimatedSizeInBytes	取得離線對應套件位元組的估計大小。
Status	取得對應套件的狀態（例如，套件是否已下載至本機系統）。

方法

FindPackagesAsync(Geopoint)	啟動異步操作，以尋找包含指定地理位置之地圖數據的地圖套件。
FindPackagesInBoundingBoxAsync(GeoboundingBox)	啟動異步操作，以尋找包含指定四面地理區域的地圖數據的地圖套件。
FindPackagesInGeocircleAsync(Geocircle)	啟動異步操作，以尋找包含指定地理區域的地圖數據的地圖套件。
RequestStartDownloadAsync()	啟動異步操作，以要求將地圖套件下載至本機系統。

事件

StatusChanged

發生於 OfflineMapPackageQueryResult 的狀態 變更時。