要求地圖驗證金鑰

警告

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

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

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

提示 若要深入了解如何在應用程式中使用地圖和位置,請從 GitHub 上的 Windows-universal-samples 存放庫下載下列範例:

取得金鑰

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

若要建立新的金鑰

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

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

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

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

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

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

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

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

    這是表單外觀的範例。

    an example of the create key form.

  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";