マップ モジュール

Note

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

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

Important

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

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

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

Note

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

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

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

モジュール プロパティ

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

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

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

  • *.bing.comconnect-src ディレクティブに追加します。
  • img-src ディレクティブに *.virtualearth.net を追加します。
  • *.bing.com、*.virtualearth.netscript-src ディレクティブに追加します。
  • *.bing.comscript style-src ディレクティブに追加します。

マップ モジュールをページに追加する

ページにマップ モジュールを構成する方法の詳細については、店舗セレクター モジュール を参照してください。

その他のリソース

モジュール ライブラリの概要

購入ボックス モジュール

カート モジュール

店舗セレクター モジュール

組織の Bing 地図の管理

Bing Maps V8 Web コントロール