マップ
概要
Avonni マップコンポーネントは、インタラクティブな地図を統合することで Salesforce Experience Cloud のウェブサイトを強化します。本書は、マップコンポーネントをカスタマイズするために利用できるさまざまな設定を概説します。
Avonni マップは リアクティブデータコンポーネント
🎥 チュートリアル
Avonni マップを使用して Experience Cloud にレコードを表示する方法を学びます。
マップの設定
特にデータソースとデータマッピングのセクションでの構成プロセスを理解することは、このコンポーネントを効果的に使用するために重要です。
データソースの設定
データソースのセクションは、Avonni マップを Salesforce のデータに接続する場所です。オプションは2つあります。

手動データソース
データを手動でデータテーブルに入力します。
非動的なデータ、テスト、デモに最適です。
クエリ
クエリを作成して、Salesforce データでテーブルを自動的に埋めます。
動的、リアルタイム、大規模なデータセットに適しています。
データマッピングの構成
データマッピングのセクションでは、フィールドのマッピング方法を指定してマップコンポーネントを有効にできます。これは、データソース設定の位置座標などのフィールドを関連するマップ属性と整合させる作業を含みます。
データマッピングが正しく設定されていること、特にロケーションのマッピングに関しては、Location セクションに注力する必要があります。その理由は次のとおりです:
データマッピングの設定: マップコンポーネントが正しい情報を表示するように、Salesforce のデータフィールドを対応するロケーションラベルにマッピングする必要があります。たとえば、住所を含む Salesforce フィールドをマップコンポーネントの「street」ラベルに、都市名を「city」ラベルにマッピングする、といった作業です。
正確性の重要性: 正確なマッピングが不可欠です。誤った Salesforce フィールドをロケーションラベルにマッピングすると、マップが不正確な情報を表示する可能性があります。たとえば、「city」フィールドが誤って「postal code」ラベルにマッピングされていると、マップはまったく別の都市や場合によっては別の国の位置を表示することがあります。

フィルター
Filters 属性では、マップコンポーネントに表示されるマーカーをフィルタリングおよび絞り込むために使用できる特定のフィールドを選択できます。

その他の設定
リスト表示
この機能はロケーションのリストを表示または非表示にします。有効な値は visible、hidden、または auto です。この値のデフォルトは auto で、複数のマーカーが存在する場合にのみリストを表示します。
ズームレベル
マップコンポーネントでは、世界全体から個別の建物まで、さまざまな領域にフォーカスするためにズームレベルを調整できます。ズームレベルを設定しない場合、マップは配置したすべてのマーカーを表示するように自動的に調整されます。

プロパティパネルにはズームを手動で設定するオプションがあります。ズームレベルはデスクトップブラウザでは 1〜22、モバイルデバイスでは 1〜20 の範囲です。
以下は各ズームレベルがおおむね何を表示するかの簡単なガイドです:
レベル 1: 世界全体
レベル 5: 大陸または広大な陸地
レベル 10: 都市
レベル 15: 路面レベルの詳細
レベル 20: 個々の建物
詳細については Google Maps API のドキュメントを参照してください( ズームレベル )。
マップコンポーネントの UI 動作

これらの設定により、ユーザーがマップとどのように対話するかを制御でき、より効率的で焦点を絞ったユーザー体験を提供します。特定のズームやドラッグ機能を無効にすることから、検索バーやフッターのような便利な機能を追加することまで、各設定には明確な目的があります:
ドラッグを無効化
クリックしてドラッグによるマップの移動を防ぎ、固定された位置に保ちます。
ズームコントロールを非表示
ズームイン/ズームアウトのコントロールを削除し、マップのズームレベルを一定に保ちます。
スクロールホイールズームを無効化
マウスホイールでのズームイン/ズームアウトを停止し、ズームレベルを安定させます。
ダブルクリックズームを無効化
マップ上でのダブルクリックによるズームインを無効にし、ズームレベルを固定します。
デフォルト UI を無効化
ストリートビュー切替など標準のマップインターフェース要素を削除し、よりすっきりしたマップ表示にします。
フッターを表示
マップにフッターを表示し、マップのデータソースや凡例などの追加情報を示します。
検索可能
マップに検索バーを追加し、ユーザーが特定の場所やポイントを簡単に検索してズームできるようにします。
マップ中心位置
複数のマーカーをマップ上で使用する場合、マップはすべてのマーカーのほぼ中央付近の中心点に自動的にフォーカスします。これはマーカーの位置に基づいてその点を計算します。

インタラクション
マップコンポーネントには「on Select」インタラクションが備わっています。この機能により、ユーザーがマップマーカーをクリックしたときにどのアクションを実行するかを指定できます。

マップマーカーをクリックした後に画面上に短いポップアップ通知を表示し、迅速なフィードバックや情報を提供します。
ユーザーをサイト内の別のページや URL にリダイレクトし、クリックされた場所に関する詳細情報へ案内します。
選択した場所に関する重要な情報や警告を示すアラートメッセージを含むモーダルウィンドウを開きます。
参加確認など、追加のユーザー確認が必要なアクションに使用される確認ダイアログボックスをトリガーします。
Salesforce フローを実行するダイアログを開き、クリックされた場所に関連するワークフローやプロセスを開始します。
設定
リストタイトル
マップリストのタイトルを設定します。
リストビュー
この機能は、ユーザーがマップ上の場所やアイテムの詳細なリストを見るのに特に役立ちます。
自動: 最適なビューを自動的に決定します。
表示: リストビューを常に表示します。
非表示: リストビューを隠します。
ズームレベル
ズームレベルはデスクトップブラウザでは 1〜22、モバイルデバイスでは 1〜20 の範囲です。
以下は各ズームレベルがおおむね何を表示するかの簡単なガイドです:
レベル 1: 世界全体
レベル 5: 大陸または広大な陸地
レベル 10: 都市
レベル 15: 路面レベルの詳細
レベル 20: 個々の建物
ドラッグを無効化
ユーザーがマップビューをドラッグするのを防ぎます。
ズームコントロールを非表示
マップからズームイン/ズームアウトのコントロールを削除します
スクロールホイールズームを無効化
マウスのスクロールホイールによるズームをオフにします
ダブルクリックを無効化
ダブルクリックによるマップのズームインを防ぎます
デフォルト UI を無効化
よりクリーンな外観のために標準の Google Maps インターフェースを削除します
フッターを表示
マップコンポーネントにフッターセクションを追加します
検索可能
マップ内で検索機能を有効にします
データソース
手動: マップマーカーを手動で追加します。
クエリ: データマッピングを使用して Salesforce のデータで自動的にマーカーを配置します
マップの中心位置
マップの初期中心点を指定します
フィルタリングオプション
ポップオーバーとして表示されるマップ用のフィルターを設定します
検索エンジンオプション
プレースホルダー: 入力前に検索バーに表示されるテキスト。
位置: 検索バーの位置を left、right、center、または fill から選択します
サイズ
幅と高さ: マップコンポーネントの寸法を指定します。
"オーバーフロー
「オーバーフロー」は、コンテナの境界を超えるコンテンツがどのように処理または表示されるかを指します。レイアウトコンポーネント内のコンテンツが割り当てられた寸法(高さと幅)に収まらない場合、オーバーフロー設定は余分なコンテンツに対して何が起こるかを決定します。
オーバーフロー: オーバーフローコンテンツの管理方法を制御します。
最終更新
役に立ちましたか?