AX - Map

AX - Map Experience Sites ページ上で Salesforce レコードをインタラクティブな位置マーカーとして表示する Experience Cloud コンポーネントです。

ポータル ユーザーに、住所フィールドまたは緯度/経度座標に基づく場所を表示するために使用します。たとえば、近くのサービス拠点、顧客サイト、店舗検索結果、イベント会場などです。ユーザーはマーカーをクリックしてレコード詳細を表示し、レコードに移動できます。Experience Builder では、任意の標準オブジェクトまたはカスタムオブジェクトから位置データを取得できます。

店舗検索、サービス地域マップ、イベント会場検索、顧客近接ビューなど、またはポータル ユーザーが地理データを可視化する必要があるあらゆる場面に最適です。

この簡単なチュートリアルで Map コンポーネントの基本を学び、ユースケースの作成を始めましょう。

設定プロセス、特に Data Source と Data Mappings のセクションを理解することは、このコンポーネントを効果的に使用するうえで重要です。

Data Source セクションでは、Avonni Map を Salesforce データに接続します。2 つの選択肢があります。

Data Mappings セクションでは、フィールドのマッピング方法を指定して Map コンポーネントを有効化できます。これには、Data Source 設定からの位置座標などのフィールドを、関連するマップ属性に対応付けることが含まれます。

Data Mappings を正しく設定するためには、特に位置をマッピングする際に、Location セクションに注目する必要があります。その理由は次のとおりです:

Filters 属性では、Map コンポーネントに表示されるマーカーを絞り込むための特定のフィールドを選択できます。

データソースを使うと、 手動 追加する各マーカー行にそれぞれのフィールドが表示されます:

種類 マップ エンジンを選択します — Google Maps （デフォルト）または Leaflet。選択してください Google Maps おなじみの Salesforce Lightning マップを使う場合は、最も簡単なオプションですが、表示は 1,000 マーカーに制限されます。選択してください Leaflet より大きなデータセット（マーカー数の上限なし）、カスタム マップ タイル、または高度な形状マーカー（円、ポリゴン、四角形）を使う場合は。

リストタイトル 位置リストのタイトルを設定します。また リストビュー そのリストを表示するかどうかを制御します: 表示 （常に表示） 非表示、または 自動 （デフォルト — 複数のマーカーがある場合のみ表示）。

ズームレベル 初期ズームを設定します。未設定の場合、マップは配置したすべてのマーカーが表示されるよう自動的に調整されます。

ズームレベルは、デスクトップ ブラウザでは 1 から 22、モバイル デバイスでは 1 から 20 です。各レベルで一般的に何が表示されるかの簡単なガイドです:

Google Maps API のドキュメントの ズームレベル を参照してください。詳細な情報が得られます。

ズーム コントロールを非表示 ズームイン/アウト コントロールを削除します。また ズーム コントロールの位置 それらのコントロールをマップ上のどこに表示するかを設定します — 左上, 右上, 左下 または 右下。未設定の場合、コントロールは選択したマップ エンジンが配置する場所に表示されます。

以下のトグルで、ユーザーがマップとどのようにやり取りするかを制御し、より洗練された集中しやすい体験を実現します:

ドラッグを無効化 クリック＆ドラッグによるマップ移動を防ぎます。 スクロールホイールによるズームを無効化 マウスホイールでのズームを停止します。 ダブルクリックズームを無効化 ダブルクリックでのズームを無効にします。 デフォルト UI を無効化 よりすっきりした表示のために、標準のマップ インターフェース要素（ストリートビュー切り替えなど）を削除します。

ドラッグ可能なマーカー ユーザーがマーカーをドラッグして位置を変更できるようにします。また 自動パンによるマーカー追従を無効化 マーカーを表示し続けるためにマップが自動的にパンするのを停止します。

フッターを表示 マップにフッターを表示します（データソースや凡例に便利です）。また 検索を表示 ユーザーが特定の場所を見つけてズームできるよう検索バーを追加します。

ヘッダー タイトル と ヘッダー キャプション マップ上部のテキストを設定します。また ヘッダー タイトルのテキストスタイル と ヘッダー キャプションのテキストスタイル サイトのテキストスタイルをそれぞれに適用します。各スタイルにはそのテキストが必要です。

ヘッダー アイコン名 ヘッダーにアイコンを追加します。また ヘッダー アイコンのサイズ サイズを設定します（デフォルト: 中）。必要です ヘッダー アイコン名.

ヘッダーを連結 ヘッダーをマップにぴったり接続し、下部の角丸や影をなくします。

ヘッダー アクション マップのヘッダーにアクションボタンを追加します。

デフォルトでは、マップ上に複数のマーカーがある場合、その位置から計算された中心点にフォーカスします。 中心位置 設定がこれを上書きします:

クラスタ属性 近くのマーカーをグループ化して、密集したマップでも読みやすくします:

ルーティング属性 サイト ユーザーがマップ上のマーカーから複数停止のドライブルートを作成できるようにします。Leaflet のみ。

ルーティングは、管理者が組織ごとに独自のルーティングプロバイダー API キーを使って 1 回だけ有効化します。それまで、このセクションでは設定の代わりに有効化ガイダンスが表示されます — を参照してください ルーティング設定.

パネルでは、サイト ユーザーはマーカーをクリックして停止地点（最大 25 件）を追加するか、複数を囲むように長方形または投げ縄を描画して追加します。ただし 複数停止の選択を無効化 が設定されている場合は除きます。次に選択するのは 出発点 — マップ上の任意のレコード、または 現在地 をブラウザーの位置情報から選び、停止地点を訪問順にドラッグします。 最適化 最短の走行時間になるように順序を並べ替えます。最初の停止地点、または設定されている場合は出発点はそのまま維持されます。Mapbox では、管理者がこれをオフにしない限り、ルーティングプロバイダーが順序を決定します。 ルーティング設定、一方で他のプロバイダーや 12 停止地点を超えるルートでは、近接順にフォールバックします。 元に戻す, やり直し、そして クリア パネル ヘッダーにあり、各停止地点は削除するか、Waze で開くことができます Google Maps または Waze.

設定 含まれます タイミング (今すぐ出発, 出発時刻、または 到着時刻、および 日付 と 時刻 （後者 2 つ用）と フェリーを避ける, 高速道路を避ける、そして 有料道路を避ける。交通状況をモデル化できるのは Mapbox のみであるため、タイミングは Mapbox がアクティブなプロバイダーのときにのみ表示されます。

また、サイト ユーザー自身のスケジュールも保持します: 滞在時間 （各停止地点での滞在時間。これにより、その後のすべての停止地点が遅れます。最初と最後は遅れません） 昼食開始 と 昼食終了 （その時間枠の開始時にルートが進行中で、走行中または停止中の場合、その時間枠の間は全体が一時停止します）、そして 1日の終了 （サイト ユーザーがまだ道路上にいたい最終時刻）。

その後に到着した停止地点はすべて 1日の終了 ルートが計算されるとマークされます。マップ マーカーとそこへ向かう走行はオレンジ色になり、パネル内の行には 1日の終了時刻を過ぎた と一致するオレンジ色の番号が付き、概要の下の注記にはルートが遅れて終了することが示されます。ルートから除外されるものはありません。マークは収まりきらないものを示しています。

ルートを計算 道路形状を描画し、各停止地点の距離と走行時間を表示します。Mapbox では、パネルに出発→到着、合計所要時間、および各停止地点の到着時刻も表示されます。これらはすべて 滞在時間 各停止地点での滞在時間と任意の 昼食 休憩を含みます。計算後、ダウンロード ボタンで旅程を route_<date>.csv 停止番号、レコード名、都市、到着時刻、距離 (km)、所要時間 (分)、Google マップ、Waze 列を含む CSV として書き出します。

ルート全体の単一リンクはありません。道順 URL に含められるウェイポイントは最大 9 件、モバイル ブラウザーでは 3 件までなので、ナビゲーションは 1 つずつ停止地点ごとに引き継がれます。

フィルター （上記の Data Mappings で設定）ユーザーがマーカーを絞り込めるフィールドを選択し、 フィルターメニュー属性 フィルターメニューを制御します — その 種類 (横, ポップオーバー、または パネル）、 選択リストフィルターの並び順、空の選択リスト値を非表示にするかどうか（レコードの選択リスト値を使用）、と、フィルター値を連動させるかどうか（連動フィルター値を使用). マップ上に重ねて表示 表示します 横 または ポップオーバー ヘッダーではなくマップの上部にフィルターを表示します。オーバーレイ表示するには パネル フィルターのオーバーレイ表示には、次を使用します サイドパネル属性.

検索エンジン属性 検索バーを設定します（必要です 検索を表示）: その プレースホルダー テキストと 位置 — 左, 右, 中央、または 塗りつぶし ヘッダー内、 パネル サイドパネル内、または マップ上に重ねて表示 マップの上部に重ねて表示します。狭いマップでは、重ねた検索はヘッダーに戻ります。

サイドパネル属性 フィルターまたは検索が設定されているときに表示されるサイドパネルを設定します パネル。スマートフォンのような狭いマップでは、フィルターはポップオーバーとして表示され、検索は代わりにヘッダーへ移動します。

サイドパネルと Route パネルの両方がマップ上に重ねて表示されている場合、同時に開けるのはどちらか一方だけです。

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

ユーザーの選択に即座に反応するインタラクティブなマップで、アカウントデータを生き生きと見せましょう。Map コンポーネントを Accounts Data Table に接続することで、担当者が任意のアカウントレコードをクリックした瞬間に、正確な請求先住所を表示できます。

顧客に、注文が今どこにあるかをリアルタイムで可視化しましょう。Order オブジェクトからジオロケーションデータを直接マッピングすることで、顧客に各段階で情報を届ける、透明性の高い直感的な追跡体験を構築できます。