地図モジュール

ノート

Dynamics 365 Commerce の小売利子グループは、Yammer から Viva Engage に移行しました。新しいViva Engage コミュニティにアクセスできない場合は、追加するフォーム (https://aka.ms/JoinD365commerceVivaEngageCommunity) に入力し、最新のディスカッションに参加してください。

この記事では、マップモジュールと、Microsoft Dynamics 365 Commerce でそれらを構成する方法について説明します。

重要

Bing Maps for Enterprise は非推奨となり、廃止されます。 Bing Maps for Enterprise のエンタープライズライセンスをお持ちの場合は、2028 年 6 月 30 日まで使用できます。 Bing Maps for Enterprise の無料または基本ライセンスをお持ちの場合は、2025 年 6 月 30 日まで使用できます。
Azure Maps e-Commerce バージョン 10.0.45 でモジュールとして使用できるようになるまで、Dynamics365Commerce.Solutions GitHub リポジトリに記載されている手順に従ってAzure Mapsを手動で有効にすることができます。

マップモジュールは、Bing Maps V8 Web コントロールを使用する対話型マップ上の店舗の場所を示します。 Bing Maps API キーが必要です。このキーは、コマース本社の共有パラメーターページに追加します。マップモジュールには、マップの場所を表示するためにユーザーが選択できる、道路、航空写真、路上などのさまざまなビューが用意されています。また、ズームやユーザーの位置の使用などの操作も可能になります。

マップモジュールは、店舗セレクターモジュールと連携して、マップに表示される店舗の地理的な場所を決定します。店舗セレクターとマップモジュールは、ユーザーがサイトページのいずれかのモジュールで店舗を選択したときに相互作用します。マップモジュールは、ストアセレクターモジュールとの対話以外の他のシナリオに対して拡張できます。ただし、モジュールのカスタマイズは必須です。

ノート

マップモジュールは、Dynamics 365 Commerce 10.0.13 リリースで入手できます。

以下の図は、店舗ロケーションページで使用されるマップモジュールの例を示しています。

ストアの場所ページのストアセレクターモジュールのスクリーンショット。

モジュールプロパティ

プロパティ名	金額	内容
ヘッダー	テキスト	モジュールのヘッダー。
押しピンオプション: 既定のアイコン	Image	マップに表示される店舗に使用する押しピンのシンボルイメージ。
押しピンオプション: アクティブアイコン	Image	マップで選択された店舗に使用する押しピンのシンボルイメージ。
押しピンオプション: 既定のアイコン色	文字列	マップ上の押しピンシンボル色のテキストまたは 16 進値。
押しピンオプション: アクティブアイコン色	文字列	マップ上の選択された押しピンシンボル色のテキストまたは 16 進値。
インデックスの表示	True または False	このプロパティを True に設定すると、ストアを示すすべてのプッシュピンシンボルにインデックスが表示されます。このインデックスは、ストアセレクターモジュールに表示されるリストビュー内のインデックスと一致します。

サイトのコンテンツセキュリティポリシーディレクティブに許可されたマッピング URLを追加する

マップモジュールがBing Mapsと対話するには、サイトのコンテンツセキュリティポリシー (CSP) ごとに次のマッピング URL が許可されていることを確認する必要があります。コマースサイトビルダーでは、この構成を設定します。許可されている URL をさまざまなサイト CSP ディレクティブ ( img-src など) に追加します。詳細については、コンテンツセキュリティポリシーを参照してください。