AX - マップ
概要
AX - マップ Experience Cloud コンポーネントで、Experience Sites ページ上に Salesforce レコードを対話型の位置マーカーとして地図に表示します。
住所フィールドや緯度/経度座標に基づいてポータルユーザに場所を表示するために使用します。例：近くのサービス拠点、顧客サイト、店舗検索結果、イベント会場など。ユーザはマーカーをクリックしてレコードの詳細を確認し、レコードへ移動できます。Experience Builder の任意の標準オブジェクトまたはカスタムオブジェクトから位置データを取得できます。
店舗検索、サービス地域マップ、イベント会場検索、顧客の近接表示、またはポータルユーザが地理データを視覚化する必要があるあらゆる用途に最適です。
Avonni Map は リアクティブデータコンポーネントです
🎥 チュートリアル
Avonni Map を使用して Experience Cloud にレコードを表示する方法を学びます。
マップの設定
特に「データソース」と「データマッピング」セクションの設定手順を理解することは、このコンポーネントを効果的に使用する上で重要です。
データソースの設定
データソースセクションは Avonni Map をあなたの Salesforce データと接続する場所です。選択肢は二つあります。
手動データソース
データテーブルにデータを手動で入力します。
動的でないデータ、テスト、デモに最適です。
クエリ
Salesforce データでテーブルを自動的に入力するクエリを作成します。
動的、リアルタイム、大規模データセットに適しています。
データマッピングの設定
データマッピングセクションでは、フィールドのマッピング方法を指定してマップコンポーネントを有効にできます。これには、データソース設定の位置座標などのフィールドをマップコンポーネントの該当する属性に合わせる作業が含まれます。
データマッピングが正しく設定されていること、特に位置のマッピングに注意を払う必要があります。理由は次のとおりです：
データマッピングの設定：マップコンポーネントが正しい情報を表示するように、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 Flow を実行するダイアログを開き、クリックした場所に関連するワークフローやプロセスを開始します。
設定
リストタイトル
マップのリストにタイトルを設定します。
リストビュー
この機能は、ユーザがマップ上の場所やアイテムの詳細なリストを見るのに特に役立ちます。
自動：最適な表示を自動的に決定します。
表示：リストビューを常に表示します。
非表示：リストビューを非表示にします。
ズームレベル
ズームレベルはデスクトップブラウザで 1 から 22、モバイルデバイスで 1 から 20 の範囲です。
一般的に各ズームレベルが何を示すかの簡単なガイドはこちらです：
レベル 1：世界全体
レベル 5：大陸や大きな陸塊
レベル 10：都市
レベル 15：通りレベルの詳細
レベル 20：個々の建物
ドラッグを無効にする
ユーザがマップビューをドラッグするのを防ぎます。
ズームコントロールを非表示にする
マップからズームイン/ズームアウトのコントロールを削除します。
スクロールホイールズームを無効にする
マウスのスクロールホイールによるズームをオフにします。
ダブルクリックを無効にする
ダブルクリックによるマップのズームインを防ぎます。
デフォルト UI を無効にする
よりクリーンな外観のために標準の Google Maps インターフェースを削除します。
フッターを表示
マップコンポーネントにフッターセクションを追加します。
検索可能
マップ内で検索機能を有効にします。
データソース
手動：マップマーカーを手動で追加します。
クエリ：データマッピングで Salesforce データを使用してマーカーを自動配置します。
マップ中心位置
マップの初期中心点を指定します。
フィルタリングオプション
ポップオーバーとして表示されるマップ用フィルターを設定します。
検索エンジンオプション
プレースホルダ：入力前に検索バーに表示されるテキスト。
位置：検索バーの位置を left、right、center、または fill から選択します。
サイズ
幅と高さ：マップコンポーネントの寸法を指定します。
"オーバーフロー「オーバーフロー」とは、コンテナの境界を超えたコンテンツがどのように扱われ表示されるかを指します。レイアウトコンポーネント内のコンテンツが割り当てられた寸法（高さと幅）に収まらない場合、オーバーフロー設定が余剰コンテンツに対して何が起こるかを決定します。
オーバーフロー：オーバーフローコンテンツの管理方法を制御します。
最終更新
役に立ちましたか？