要求地圖驗證金鑰

重要

針對企業用 Bing 地圖服務淘汰

UWP MapControl 和 Windows.Services.Maps 命名空間的地圖服務都是依賴 Bing 地圖服務。針對企業用 Bing 地圖服務已遭到取代且即將淘汰，屆時 MapControl 及服務將不再接收資料。

警告

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

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

取得金鑰

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

若要建立新的金鑰

在瀏覽器中，瀏覽至 Bing 地圖開發人員中心 (https://www.bingmapsportal.com)。
如果系統要求您登入，請輸入您的 Microsoft 帳戶，然後按一下 [登入]。
選擇要與您的 Bing 地圖帳戶建立關聯的帳戶。如果您想要使用 Microsoft 帳戶，請按一下 [是]。否則，請按一下 [使用其他帳戶登入]。
如果您還沒有 Bing 地圖帳戶，請建立新的 Bing 地圖帳戶。輸入 [帳戶名稱]、[連絡人名稱]、[公司名稱]、[電子郵件地址] 和 [電話號碼]。接受使用規定之後，按一下 [建立]。
在 [我的帳戶] 功能表下，按一下 [我的金鑰]。
如果您先前已建立金鑰，請按一下連結以建立新的金鑰。否則，請繼續進行 [建立金鑰] 表單。
完成 [建立密鑰] 表單，然後按一下 [建立]。
- 應用程式名稱：您的應用程式的名稱。
- 應用程式 URL (選擇性)：您的應用程式的 URL。
- 機碼類型：選取 [基本] 或 [企業]。
- 應用程式類型：選取 [Windows 應用程式] 以用於您的通用 Windows 應用程式。
這是表單外觀的範例。
按一下 [建立] 之後，新的金鑰會出現在 [建立金鑰] 表單下方。將它複製到安全的地方，或立即將它新增至您的應用程式，如下一個步驟所述。

您必須使用地圖驗證金鑰，才能在通用 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";
```