本文說明地圖模組及如何在 Microsoft Dynamics 365 Commerce 中配置它們。
Important
- Bing 地圖服務企業版會被取代，將停用。 如果你持有 Bing 地圖服務 for Enterprise 的企業授權，可以使用到 2028 年 6 月 30 日。 如果您擁有 Bing 地圖服務 for Enterprise 的免費或基本授權，可以使用至 2025 年 6 月 30 日。
- 在 Azure 地圖服務在電子商務版本 10.0.45 中成為模組可供使用之前，您可以按照 Dynamics365Commerce.Solutions GitHub 存放庫中提供的步驟，手動啟用 Azure 地圖服務。
地圖模組透過 Bing 地圖服務 V8 網頁控制，在互動地圖上顯示商店位置。 你必須擁有一個 Bing 地圖服務 API 金鑰，然後將其添加到商務總部的共享參數頁面。 地圖模組提供不同的視圖，例如道路、空中和街景，使用者可以選取來查看地圖位置。 它們還允許互動，例如縮放和使用使用者的位置。
地圖模組與商店選擇模組合作，以判斷地圖上商店的地理位置。 當使用者在網站頁面上的其中一個模組中選取商店時，商店選取器和地圖模組會進行互動。 你可以將地圖模組擴展到其他情境，不只是與商店選擇模組互動。 但是，需要模組自訂。
Note
地圖模組在 Dynamics 365 Commerce 10.0.13 發行版本中可用。
下圖顯示在商店位置頁面上使用的地圖模組範例。
模組屬性
| 屬性名稱 | Value | Description |
|---|---|---|
| 標題 | 文字 | 屬性的標頭。 |
| 圖釘選項：預設圖示 | 影像 | 圖釘符號圖像用於顯示在地圖上的商店。 |
| 圖釘選項：使用中圖示 | 影像 | 圖釘符號圖像用於在地圖上選定的商店。 |
| 圖釘選項：預設圖示色彩 | 字元字串 | 地圖上圖釘符號色彩的文字或十六進位值。 |
| 圖釘選項：使用中圖示色彩 | 字元字串 | 地圖上選定圖釘符號色彩的文字或十六進位值。 |
| 顯示索引 | True 或 False | 如果你把這個屬性設為 True，每個表示商店的圖釘符號都會顯示一個索引。 此索引與儲存選擇器模組在清單檢視中顯示的索引相符。 |
新增允許的對應網址至網站的內容安全性原則指令中
若要使地圖模組與 Bing 地圖服務互動，您必須確定網站的內容安全性原則 (CSP) 允許以下對應 URL。 商業網站建置器就是你可以設定這種設定的地方。 為各種網站 CSP 指令（例如 img-src）新增允許的網址。 如需詳細資訊，請參閱內容安全性原則。
- 在 connect-src 指令中加入 *.bing.com。
- 在 img-src 指令中加上 *.virtualearth.net。
- 在腳本指令中加入 *.bing.com、*.virtualearth.net。
- 在腳本 style-src 指令中加入 *.bing.com。
新增地圖模組到頁面
有關如何在頁面上設定地圖模組的詳細資訊，請參閱商店選取器。