共用方式為


要求地圖驗證金鑰

重要

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

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

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

警告

舊版 Windows 10 上可能無法使用線上地圖服務。 在以下版本中,MapControl 可能不再顯示地圖,而 Windows.Services.Maps 命名空間中的 API 可能不會傳回結果:

  • Windows 10,版本 1607 和更早版本:自 2020 年 10 月起,全球將停止提供地圖服務。
  • Windows 10,版本 1703 及更早版本:部分在中國銷售的裝置上無法使用地圖服務

您的應用程式必須經過驗證,才能使用 MapControlWindows.Services.Maps 命名空間中的地圖服務。 若要驗證您的應用程式,則必須指定地圖驗證金鑰。 本主題說明如何從 Bing 地圖服務開發人員中心要求地圖驗證金鑰,然後將金鑰新增到您的應用程式。

取得金鑰

使用 Bing 地圖服務開發人員中心,為您的通用 Windows 應用程式建立和管理地圖驗證金鑰。

若要建立新的金鑰

  1. 在瀏覽器中,瀏覽至 Bing 地圖開發人員中心 (https://www.bingmapsportal.com)。

  2. 如果系統要求您登入,請輸入您的 Microsoft 帳戶,然後按一下 [登入]。

  3. 選擇要與您的 Bing 地圖帳戶建立關聯的帳戶。 如果您想要使用 Microsoft 帳戶,請按一下 []。 否則,請按一下 [使用其他帳戶登入]。

  4. 如果您還沒有 Bing 地圖帳戶,請建立新的 Bing 地圖帳戶。 輸入 [帳戶名稱]、[連絡人名稱]、[公司名稱]、[電子郵件地址] 和 [電話號碼]。 接受使用規定之後,按一下 [建立]。

  5. 在 [我的帳戶] 功能表下,按一下 [我的金鑰]。

  6. 如果您先前已建立金鑰,請按一下連結以建立新的金鑰。 否則,請繼續進行 [建立金鑰] 表單。

  7. 完成 [建立密鑰] 表單,然後按一下 [建立]。

    • 應用程式名稱:您的應用程式的名稱。
    • 應用程式 URL (選擇性):您的應用程式的 URL。
    • 機碼類型:選取 [基本] 或 [企業]。
    • 應用程式類型:選取 [Windows 應用程式] 以用於您的通用 Windows 應用程式。

    這是表單外觀的範例。

    建立索引鍵表單的範例。

  8. 按一下 [建立] 之後,新的金鑰會出現在 [建立金鑰] 表單下方。 將它複製到安全的地方,或立即將它新增至您的應用程式,如下一個步驟所述。

將金鑰新增至應用程式

您必須使用地圖驗證金鑰,才能在通用 Windows 應用程式中使用 MapControl 和地圖服務 (Windows.Services.Maps)。 視需要將它新增至地圖控制項和地圖服務物件。

若要將金鑰新增至地圖控制項

若要驗證 MapControl,請將 MapServiceToken 屬性設定為驗證金鑰值。 您可以根據喜好設定,在程式碼或 XAML 標記中設定此屬性。 如需使用 MapControl 的詳細資訊,請參閱 顯示地圖的 2D、3D 和 Streetside 檢視

  • 本範例會將 MapServiceToken 設定為程式碼中驗證金鑰的值。

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
    
  • 本範例會將 MapServiceToken 設定為 XAML 標記中驗證金鑰的值。

    <Maps:MapControl x:Name="MapControl1"
                     MapServiceToken="abcdef-abcdefghijklmno"/>
    

若要將金鑰新增至地圖服務

若要在 Windows.Services.Maps 命名空間中使用服務,請將 ServiceToken 屬性設定為驗證金鑰值。 如需使用地圖服務的詳細資訊,請參閱顯示路線和路線指引,以及執行地理編碼和反向地理編碼

  • 本範例會將 ServiceToken 設定為程式碼中驗證金鑰的值。

    MapService.ServiceToken = "abcdef-abcdefghijklmno";