> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-map.md).

# AX - 地図

## 概要

**AX - マップ** Salesforce のレコードを、標準オブジェクトまたはカスタムオブジェクトにかかわらず、住所または緯度・経度で配置された Experience Sites ページ上のマーカーとして表示します。サイトユーザーはマーカーをクリックしてレコードの詳細を表示したり、開いたりできます。店舗検索、サービス地域、イベント会場、顧客サイトに使用できます。

{% hint style="success" %}
Avonni Map は [リアクティブデータコンポーネントです](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/reactive-components.md)
{% endhint %}

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FtDbABxjI9E87N8Ee1UPB%2Fxp-quickstart-selected.png?alt=media" alt="An Experience Sites page titled Find a certified installer. Pikes Peak Power is selected in an AX - Data Table of six certified installers, its name and phone number sit above an AX - Map, and the map shows that installer&#x27;s installations around Colorado Springs."><figcaption><p>リアクティブなマップです。AX - Data Table でインストーラーを選択すると、AX - Map がそのインストーラーが設置した住宅へ移動します。</p></figcaption></figure>

## はじめに

基本を学ぶ短いインタラクティブチュートリアルです。

{% @arcade/embed url="<https://app.arcade.software/share/ZiiaXHHeJ3PWe6UcgYBN>" flowId="ZiiaXHHeJ3PWe6UcgYBN" %}

## 設定

Experience Builder でマップを選択し、プロパティパネルでその設定を開きます。

### データソース

マップを Salesforce データに接続します。

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FRiatWpqiK5o3Yl9Fb5Np%2Fxp-quickstart-map-query.png?alt=media" alt="The AX - Map Data Source set to Query on Contact, with a filter Account ID equals {{installers.selectedRecord.Id}} and Maximum Number of Records 100, and the Data Mappings below it: Title mapped to the Title field, Description to the contact&#x27;s mailing city and department." width="340"><figcaption><p>Contact のクエリデータソースで、installers という名前の AX - Data Table で選択された行でフィルタリングされています。</p></figcaption></figure>

| データソースタイプ | マーカー                       | 最適用途                 |
| --------- | -------------------------- | -------------------- |
| **手動**    | 手入力。                       | 固定データ、テスト、デモ。        |
| **クエリ**   | Salesforce クエリによって読み込まれます。 | ライブのリアルタイム大容量データセット。 |

### データマッピング

で **データマッピング**、各マーカー要素の背後にあるフィールドを選択します。 **値** それを識別します（既定 `{{Record.Id}}`). **位置** はエンジンによって異なります:

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F6goX71CXYFwCOEdlvpjA%2Fax-map-panel-location.png?alt=media" alt="Data Mappings of a Leaflet AX - Map that queries Accounts, in the Experience Builder panel. Title is mapped to Account Name, Description and Icon Name are empty, Type is Default. The Location group holds three fields only: Latitude mapped to Billing Latitude, Longitude to Billing Longitude and City to Billing City." width="320"><figcaption><p>Leaflet では、位置は緯度と経度、さらに任意で市区町村を取ります。</p></figcaption></figure>

| エンジン           | 位置フィールド                                                             |
| -------------- | ------------------------------------------------------------------- |
| **Google マップ** | 住所（**番地**, **市区町村**, **都道府県**, **郵便番号**, **国**）または **緯度** と **経度**. |
| **Leaflet**    | **緯度** と **経度**、必須です。 **市区町村** 任意。ルートの停車地リストと CSV 用です。              |

<details>

<summary>Avonni Map とのデータモデル共有</summary>

Avonni コンポーネントは、組織の共有設定とユーザー権限に従い、共有ルールを変更することはありません。サイトユーザーは、アクセスできるレコードのみを表示・操作できます。

</details>

#### フィルター

**フィルター**: サイトユーザーがマーカーを絞り込むフィールド（メニュー: 「Filtering & Search」を参照）。

#### 検索フィールド

**検索フィールド**: 検索バーが検索するフィールド。必要条件: **検索を表示**.

#### マーカーごとの設定

〜を使用すると **手動** データソースでは、各マーカー行に独自のフィールドがあります:

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FtKc6obZkqA8xOPYHvAPg%2Fmap-marker-types.png?alt=media" alt="A Leaflet map of the west side of Chicago with six markers in two rows. Top row, left to right: a red pin, a blue pin and a blue circle. Bottom row: a blue rectangle, a blue pentagon and an orange star."><figcaption><p>1つのマップ上の6種類のマーカー。上段: Default、Pin、Circle。下段: Rectangle、Polygon、Custom Icon。ここでは SVG パスから描画した星です。</p></figcaption></figure>

| 設定                                                        | 機能                                                                               |
| --------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **タイトル**, **説明**                                          | マーカーとポップアップのラベル。                                                                 |
| **アイコン名**                                                 | マーカーアイコン。                                                                        |
| **タイプ**                                                   | **既定**, **円**, **長方形**, **多角形**, **ピン** または **カスタムアイコン**。どちらのエンジンでも6種類すべて使用できます。 |
| **半径**, **境界**, **パス**                                    | 図形の形状: 円の半径（メートル、既定 25）、長方形の辺、多角形の頂点。                                            |
| **塗りつぶし色**, **塗りつぶしの不透明度**, **線の色**, **線の不透明度**, **線の太さ** | 図形の色。                                                                            |
| **SVG パス**, **スケール**, **アンカー**                            | その **カスタムアイコン** 描画で、独自の塗りつぶしと線を持ちます。                                             |
| **位置**, **選択時**, **ドラッグ時**                                | 上の位置テーブル、および下のインタラクションと同様です。                                                     |

### マップ設定

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FuHJIaqRn5kpBR94LWCKu%2Fax-map-panel-leaflet.png?alt=media" alt="AX - Map Settings panel in Experience Builder for a map whose Type is Leaflet. From the top: API Name serviceMap, Type Leaflet, then Hide Zoom Controls, Zoom Controls Position, Zoom Level, Disable Dragging, Disable Scrollwheel Zooming, Disable Double Click Zoom, Draggable Markers, Disable Auto Pan Markers, Show Search, Header Title Service visits, the header text style, caption and icon settings, Header Is Joined. Below them eight folded sections: Header Actions, Center Location, Marker Clustering, Draw, Route, Filter, Search, Side panel." width="320"><figcaption><p>Type が Leaflet に設定された AX - Map パネル: マップ設定、その後に残りの設定を含むセクションが続きます。</p></figcaption></figure>

**タイプ** エンジンを選択します。 **Google マップ** （既定）: おなじみの Lightning マップ。最もシンプルで、最大 1,000 個のマーカーに対応します。 **Leaflet**: マーカー数の上限なし。クラスタリング、描画、ルートを追加し、マーカーは座標のみで配置します。また、 `https://tile.openstreetmap.org` を組織の信頼済みサイトに追加してタイルを読み込む必要があります。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FFC8ZUL0CFyjmbkZ90N8k%2Fmap-type-google.png?alt=media" alt="Five Chicago customer sites on Google Maps: four red pins near the lakeshore, from Edgewater in the north to just southwest of the Loop, and a blue circle over Hyde Park. The Map and Satellite buttons sit at the top left, the Street View and zoom controls on the right."><figcaption><p>Type を Google Maps に設定。ハイドパーク上の円は、図形マーカーが Google マップでも機能することを示しています。</p></figcaption></figure>

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FtWdN4jxzZr1NVkarrN5Y%2Fmap-type-leaflet.png?alt=media" alt="The same five Chicago customer sites on a Leaflet map with OpenStreetMap tiles: four red pins near the lakeshore and a blue circle over Hyde Park. The popup of the northern pin is open and reads Northwind Traders, Andersonville office. Zoom buttons sit at the bottom right."><figcaption><p>Type を Leaflet に設定。同じレコードに対して。マーカーをクリックするとポップアップが開きます。</p></figcaption></figure>

| 設定                      | エンジン       | 機能                                               |
| ----------------------- | ---------- | ------------------------------------------------ |
| **リストタイトル**             | Google マップ | 位置リストのタイトル。                                      |
| **リストビュー**              | Google マップ | **表示**, **非表示** または **自動** （既定: 複数のマーカーがあると表示）。  |
| **ズームコントロールを非表示**       | 両方         | ズームボタンを削除します。                                    |
| **ズームコントロールの位置**        | Leaflet    | マップの角。未設定: マップが決定します。非表示にするには **ズームコントロールを非表示**. |
| **ズームレベル**              | 両方         | 初期ズーム。未設定: すべてのマーカーに合わせます。                       |
| **ドラッグを無効化**            | 両方         | クリック＆ドラッグによるパンを無効にします。                           |
| **スクロールホイールによるズームを無効化** | 両方         | マウスホイールズームを無効にします。                               |
| **ダブルクリックによるズームを無効化**   | 両方         | ダブルクリックズームを無効にします。                               |
| **既定 UI を無効化**          | Google マップ | Street View などの標準コントロールを非表示にします。                 |
| **ドラッグ可能なマーカー**         | Leaflet    | サイトユーザーはマーカーを移動できます。ドラッグ操作で **ドラッグ時**.           |
| **マーカーの自動パンを無効化**       | Leaflet    | マーカーを表示内に保つための自動パンを行いません。                        |
| **フッターを表示**             | Google マップ | データソースまたは凡例用のフッターです。                             |
| **検索を表示**               | 両方         | 位置を検索してズームするための検索バーです。                           |

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FCJ1OQFSHfq9r6TnEZK4J%2Fmap-list-view.png?alt=media" alt="A Google map of Chicago with five red pins and, on its right, a list titled Customer Sites (5). Each entry has a green location icon, the site name as a link and its address: Atlas Logistics, 300 W Adams St, Chicago, IL; Blue Finch Retail, 2200 N Clark St; Northwind Traders, 5300 N Clark St; Redwood Supply Co, 1800 S Halsted St; Juniper Health, 1500 E 53rd St."><figcaption><p>Google マップで List View を Visible に設定。リストの各項目にはマーカーのタイトルと住所が表示されます。</p></figcaption></figure>

<details>

<summary>ズームレベル</summary>

デスクトップでは 1～22、モバイルでは 1～20。おおよそ:

* レベル 1: 世界全体
* レベル 5: 大陸または大きな陸地
* レベル 10: 都市
* レベル 15: 通りレベルの詳細
* レベル 20: 個々の建物

Google のドキュメントで詳しく見る [ズームレベル](https://developers.google.com/maps/documentation/javascript/overview#zoom-levels).

</details>

### ヘッダー

| 設定                                             | 機能                                                                                                                                                                          |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ヘッダータイトル**, **ヘッダーキャプション**                   | マップ上部のテキスト。                                                                                                                                                                 |
| **ヘッダータイトルのテキストスタイル**, **ヘッダーキャプションのテキストスタイル** | テキストが設定されると、それぞれにサイトのテキストスタイルが適用されます。                                                                                                                                       |
| **ヘッダーアイコン名**, **ヘッダーアイコンのサイズ**                | ヘッダーアイコンとそのサイズ（既定は中、アイコンが必要です）。                                                                                                                                             |
| **ヘッダーを一体化**                                   | マップと面一にします。下部の角の丸みや影はありません。                                                                                                                                                 |
| **ヘッダーアクション**                                  | ヘッダーボタンです。各エントリは **アクション**: **ラベル**, **名前**, **アイコン名**, **タイトル** （ホバー テキスト）、 **代替テキスト**, **クリック時** （下記の「Open Flow Panel」以外の任意のインタラクション）。 **表示するアクションボタン**: メニューの前にいくつ表示するか。 |

### 中心位置

既定では、マップはマーカーの中央に表示されます。 **中心位置** これで上書きします:

* **緯度**, **経度**: 正確な中心。住所より優先されます。
* **番地**, **市区町村**, **都道府県**, **郵便番号**, **国**: 住所で中心を設定します。Google マップのみ。
* **マーカーとして表示**: 中心をマーカーとして表示します。その **タイプ** で形状を設定します。

### クラスタリング

Leaflet のみ。 **マーカークラスタリング** 近くのマーカーをグループ化し、密集したマップでも見やすくします。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FCSlNYXxJQZiTY50FnaSZ%2Fmap-clustering.png?alt=media" alt="A Leaflet map of the Chicago area with forty customer sites grouped into clusters. Green circles read 4, 6, 5, 5 and 2, a yellow circle over downtown Chicago reads 17, and one site near Naperville, with no neighbour close enough, shows as a plain marker."><figcaption><p>マーカークラスタリングは、近くのマーカーを 1 つの円にまとめ、その中にいくつあるかを表示します。近くに隣接マーカーがないマーカーは、そのまま通常のマーカーになります。</p></figcaption></figure>

* **マーカークラスタリングを有効化**: 下の設定を使って有効にします。
* **ホバー時にカバー範囲を表示**: ホバー時にクラスタ内のマーカーの輪郭を表示します。
* **最大クラスタ半径**: 中央マーカーからの到達距離（ピクセル）。既定 80。
* **クラスタリングを無効にするズームレベル**: このズームとそれ以下ではクラスタリングしません。

### 描画

Leaflet のみ。サイトユーザーは図形を描画し、Salesforce ファイルとして保存できます。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FlawIXGnU1tl9HznXusXO%2Fmap-draw.png?alt=media" alt="A Leaflet map titled Sales territories with five red markers in Chicago. A polygon outlined and filled in blue covers the north side and two of the markers. At the bottom right, the drawing toolbar shows Line, Polygon, Circle and Marker buttons, then Edit and Delete, above the zoom buttons, and a Save button sits in the bottom right corner of the map."><figcaption><p>Leaflet マップ上での描画: マップを開くと GeoJSON から読み込まれるテリトリー、右下の描画ツールバー、保存ボタン。</p></figcaption></figure>

| 設定                        | 機能                                                                  |
| ------------------------- | ------------------------------------------------------------------- |
| **描画を有効化**                | 描画ツールバーを追加します。下の設定にはこれが必要です。                                        |
| **描画 GeoJSON 値**          | 読み込む図形: GeoJSON オブジェクトまたは配列。次の間は非表示: **ContentDocument として保存** がオン。 |
| **ツールバー**                 | **線**, **多角形**, **円**, **マーカー**, **編集**, **削除**。既定: 6 種類すべて。        |
| **ツールバーの位置**              | マップの角。既定 **右下**.                                                    |
| **ContentDocument として保存** | 描画をファイル（ContentDocument）として保存します。 **保存** ボタン。                       |

〜で **ContentDocument として保存** オン:

| 設定                                 | 機能                                           |
| ---------------------------------- | -------------------------------------------- |
| **ContentDocument を自動保存**          | すべての変更を保存し、 **保存** クリック不要。                   |
| **ContentDocument ID**             | 更新するファイル。空の場合: 最初の保存で作成され、その後の訪問中の保存で更新されます。 |
| **ContentDocument タイトル**           | 既定は「Avonni Map Drawing Document」。            |
| **ContentDocument のリンク先エンティティ ID** | ファイルがリンクされるレコード。                             |
| **保存ボタンのラベル**                      | 既定は「Save」。                                   |

### ルート

Leaflet のみ。サイトユーザーはマーカーから複数地点の運転ルートを作成できます。

{% hint style="info" %}
管理者は、パッケージごとに 1 回、独自のルーティングプロバイダー API キーを使ってルーティングを有効化します。それまでは、このセクションに代わりに案内が表示されます。参照: [マップルーティングを有効化](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-map/enable-map-routing.md).
{% endhint %}

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FNZBFPrsQq5oiOZOv0kKF%2Fax-map-panel-route.png?alt=media" alt="The Route section of the AX - Map panel in Experience Builder, open between the folded Draw and Filter sections. Show Route Panel is on. Below it: Disable Multi-Stop Selection off, Position with Left and Right buttons and Right selected, Display Overlaid on the Map off, Opened by Default off." width="320"><figcaption><p>Show Route Panel がオンのときの Route セクション。</p></figcaption></figure>

| 設定              | 機能                                                           | 必要条件          |
| --------------- | ------------------------------------------------------------ | ------------- |
| **ルートパネルを表示**   | 1つの **ルート** ボタン（ルートアイコン）で、Route パネルを開きます。                    | なし            |
| **複数停車地選択を無効化** | 範囲選択は行わず、停車地は 1 つずつマーカーを追加します。                               | **ルートパネルを表示** |
| **位置**          | パネルの位置: **右** （既定）または **左**.                                 | **ルートパネルを表示** |
| **マップ上に重ねて表示**  | マップの横ではなく、マップの上にパネルを表示します。 **ルート** マップ上のボタン（スマートフォンではヘッダー内）。 | **ルートパネルを表示** |
| **既定で開く**       | 読み込み時にパネルを開きます。                                              | **ルートパネルを表示** |

既定では、パネルはマップの横に開きます:

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fjsa2irMeJL1cXCdasBeJ%2Fmap-route-beside.png?alt=media" alt="A Leaflet map titled Customer visits with the Route panel as a column on its right, outside the map. In the header, the Route button is selected. Five numbered stops in Chicago are joined by straight lines in the order of the list, and the panel lists them under Starting point, with Settings and the Calculate route button below."><figcaption><p>Route パネルがマップ上に重なっていない場合、横の列として開き、ヘッダーの Route ボタンで表示/非表示を切り替えます。ルートはまだ計算されていないため、停車地は直線で結ばれます。</p></figcaption></figure>

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FZWbTLCY1Rtq0NDPRlPmy%2Frouting-route-panel.png?alt=media" alt="A map of Chicago with five numbered stops joined by a driving route. The Route panel on the right lists the five stops in order with an arrival time for each stop after the first, and shows the departure and arrival times, the total duration, and the Optimize and Clear actions."><figcaption><p>ルーティングが有効になると、Route パネルはマップ上で選択した停車地を運転ルートに変換します。Mapbox では、各停車地に到着する時刻も表示されます。</p></figcaption></figure>

パネル内でサイトユーザーは:

{% stepper %}
{% step %}

#### **停車地を追加します**

マーカーをクリックする（最大 25 件）か、複数のマーカーを囲むように長方形または投げ縄を描画します（ただし **複数停車地選択を無効化**).

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FeDY2EJS1F0AvpKHuHFcY%2Fmap-route-multi-stop.png?alt=media" alt="Part of a Leaflet map with the Route panel open. At the top of the map, Add Multiple Stops has opened into two buttons, a rectangle tool, selected, and a lasso tool. Two stops, Atlas Logistics and Blue Finch Retail, are numbered 1 and 2 on the map and listed in the panel above Settings and Calculate route. Three markers not yet in the route are still red pins."><figcaption><p>Add Multiple Stops を有効にすると、長方形ツールと投げ縄ツールが開きます。マップ上に図形を描くと、その中にあるすべてのマーカーがルートに追加されます。</p></figcaption></figure>
{% endstep %}

{% step %}

#### **出発地点を選択します**

マップ上の任意のレコード、または **自分の位置** （ブラウザーの位置）。
{% endstep %}

{% step %}

#### **順序を設定します**

停車地をドラッグするか、クリックします **最適化** 最短の移動時間に（最初の停車地、または出発地点はそのまま）。 **元に戻す**, **やり直し**, **クリア** パネルヘッダー内。各停車地は削除したり、 **Google マップ** または **Waze**.
{% endstep %}

{% step %}

#### **ルートを計算します**

**ルートを計算** 道路を描画し、各停車地の距離と走行時間を表示します。Mapbox では、出発、到着、合計所要時間と到着時刻、訪問回数、昼食も含めて表示します。次以降の停車地は **1 日の終了** としてマークされ、削除されることはありません:

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FA3n98JijWnTy1mvQOh8R%2Fmap-route-end-of-day.png?alt=media" alt="A Leaflet map titled Customer visits with five numbered stops in Chicago and the calculated driving route. The Route panel on the right reads 11:00 AM to 3:08 PM, 4 hr 8 min, followed by a red note: This route finishes after the end of day. Remove a stop, or start earlier. Stops 1 to 4 are blue and show their arrival times. Stop 5, Juniper Health, is orange, arrives at 3:08 PM and is flagged Past end of day, and the last leg of the route, from stop 4 to stop 5, is drawn in orange."><figcaption><p>1 日の終了時刻を過ぎるルート: 遅い停車地とそこへの走行はオレンジ色になり、その行には「1 日の終了後」とフラグが立ち、パネル上部の注記にルートが遅すぎると表示されます。</p></figcaption></figure>
{% endstep %}

{% step %}

#### **行程をダウンロード**

ダウンロードボタンで計算済みルートを CSV ファイルとしてエクスポートします。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F0Nuttr0426GpPjI65xcV%2Fmap-route-stop-menu.png?alt=media" alt="The Route panel after a five-stop route is calculated: 8:00 AM to 10:49 AM, 2 hr 49 min, then the Starting point search and the five stops with their arrival times. The menu of stop 2, Blue Finch Retail, is open on three actions: Remove, Google Maps and Waze. At the bottom, the Calculate route button is greyed out and a download button sits beside it." width="320"><figcaption><p>各停車地には独自のメニューがあり、ルートから削除したり、Google マップまたは Waze で開いたりできます。ルートが計算されると、「ルートを計算」の横のダウンロードボタンで CSV ファイルとしてエクスポートできます。</p></figcaption></figure>
{% endstep %}
{% endstepper %}

パネルの **設定**と、その既定値:

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F2H6KgEjBOLjN5SDVtKMv%2Fmap-route-settings.png?alt=media" alt="The Route panel with its Settings section open. Lunch start 12:00 p.m., Lunch end 1:00 p.m., End of day 6:00 p.m., Visit duration (minutes) 30, Timing set to Leave at, Date Nov 14, 2026, Time 8:00 a.m., then three switches, Avoid ferries, Avoid highways and Avoid tolls, all off. The Calculate route button sits at the bottom of the panel." width="320"><figcaption><p>Route パネルの Settings セクション。Timing は Leave at に設定されており、Date と Time のフィールドが表示されます。日付以外はすべて既定値です。</p></figcaption></figure>

| 設定                                       | 機能                                                                                             | 既定                 |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------ |
| **昼食開始**, **昼食終了**                       | 昼食時間に走行中のルートは、その時間帯の間ずっと一時停止します。開始後に終了し、出発時刻と 1 日の終了時刻の間でなければなりません。                            | 午後 12:00 ～ 1:00    |
| **1 日の終了**                               | 最後に道路上にいる時刻。以降の停車地はフラグが立ちます。                                                                   | 午後 6:00            |
| **訪問時間（分）**                              | 各停車地での滞在時間。後続の停車地を遅らせます。最初と最後の停車地では遅延しません。                                                     | 30                 |
| **時刻設定**                                 | Mapbox のみ（交通情報をモデル化する唯一のプロバイダー）。 **今すぐ出発**, **〜に出発** または **〜までに到着**; 後者 2 つには **日付** と **時刻**. | 今すぐ出発。時刻 8:00 a.m. |
| **フェリーを避ける**, **高速道路を避ける**, **有料道路を避ける** | ルートをそこから外します。                                                                                  | オフ                 |

<details>

<summary>制限とエクスポート</summary>

* **最適化**Mapbox では、管理者が次で無効にしていない限り、プロバイダーが停車地の順序を決定します。 [マップルーティングを有効化](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-map/enable-map-routing.md)。その他のプロバイダー、および 12 件を超える停車地のルート: 近接順に並べられます。
* ルート全体へのリンクはありません。経路 URL が受け付けるウェイポイントは最大 9 件（モバイルでは 3 件）なので、ナビゲーションは停車地ごとに行われます。
* ファイルは `route_<date>.csv`、停留所ごとに1行: **停留所番号**, **レコード名** （マーカーのタイトル）、 **市区町村** （〜から **位置**), **到着時刻** （Mapboxのみ）、 **距離（km）** と **所要時間（分）** 前の停留所から、 **Google マップ** と **Waze** リンク。

</details>

### フィルターと検索

**フィルター** （Data Mappingsで）フィールドを選択し、 **フィルター** セクションでメニューを設定します。各フィルターには演算子メニューがあります。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FLQeM9jEafwn9WwXt4rEY%2Fmap-filters-overlay.png?alt=media" alt="A Leaflet map titled Customer sites with five customer sites in Chicago. A Search sites box sits at the top left of the map and two filter buttons, Industry and Account Type, at the top right. The Industry filter is open and its filter mode menu lists Equals, selected, then Not Equals, Empty and Not Empty, over the list of industries. A Clear link and 5 of 5 sit at the bottom of the filter."><figcaption><p>地図上に重ねて表示される検索とフィルター。各フィルターにはフィルターモードボタンがあります: 一致、不一致、空、または空でない。</p></figcaption></figure>

| 設定                 | 機能                                                                  |
| ------------------ | ------------------------------------------------------------------- |
| **タイプ**            | **水平** （既定）、 **ポップオーバー** または **パネル** （サイドパネル内）。                     |
| **マップ上に重ねて表示**     | ヘッダーではなく、地図上に重ねる水平フィルターまたはポップオーバーフィルター。パネルフィルター: **サイドパネル** オーバーレイ。 |
| **選択リストフィルターの並び順** | **昇順** （既定）、 **降順** または **フィールドの既定の順序**.                            |
| **レコードの選択リスト値を使用** | レコードに存在する値からオプションを使用します。空の値は非表示です。                                  |
| **連動フィルター値を使用**    | 各フィルターが他のフィルターのオプションを一致するレコードに絞り込みます。上書き **レコードの選択リスト値を使用**.        |

| フィールドの種類              | 演算子（既定が先頭）                                                                               |
| --------------------- | ---------------------------------------------------------------------------------------- |
| テキスト、選択リスト、複数選択リスト、参照 | **一致**, **不一致**, **空**, **空でない**                                                         |
| 数値、日付、時刻              | **範囲内**, **範囲外**, **一致**, **不一致**, **より小さい**, **以下**, **より大きい**, **以上**, **空**, **空でない** |
| チェックボックス              | 演算子メニューなし                                                                                |

**空** と **空でない** 値を持たない: 入力欄は非表示になります。

その **検索** セクション（要 **検索を表示**):

| 設定           | 機能                                                                                         |
| ------------ | ------------------------------------------------------------------------------------------ |
| **プレースホルダー** | 検索バーの空のテキスト。デフォルトは「Search」。                                                                |
| **位置**       | **左** （既定）、 **右**, **中央**, **フィル** （ヘッダー）、 **パネル** （サイドパネル）または **地図上に重ねて表示** （狭い地図ではヘッダー）。 |

### サイドパネル

〜に設定されたフィルターまたは検索を保持します **パネル**。スマートフォン幅の地図では、フィルターはポップオーバー、検索はヘッダーに表示されます。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fg3SM0mTs60WwTzRS4N8o%2Fmap-side-panel.png?alt=media" alt="A Leaflet map titled Customer sites with a side panel on its left. The panel holds a Search sites box, an Industry filter listing Healthcare, Manufacturing, Retail, Technology and Transportation, an Account Type filter with Customer - Direct checked and Prospect unchecked, and a Clear all selections button. Both filters show an Equals filter mode button. The header reads 3 items found, Filtered by Account Type, and carries two actions, Log Visit and Share, and the button that shows or hides the panel. Three markers remain on the map."><figcaption><p>地図の横のサイドパネルにあるフィルターと検索。Customer - Direct にチェックを入れると地図上に3つのサイトが残り、すべての選択をクリアするとすべてのフィルターがリセットされます。</p></figcaption></figure>

* **位置**: **左** （既定）または **右**.
* **リセットボタンのラベル**：クリアボタン。デフォルトは「Clear all selections」。
* **マップ上に重ねて表示**：以下の2つのレイアウトのいずれかを選択します。

{% tabs %}
{% tab title="地図の横" %}
オフ: 地図の横に列を表示し、ヘッダーから切り替えます。

* **既定では閉じる**：閉じた状態で開始します。
* **切り替えボタンを非表示**：ヘッダーの切り替えボタンを非表示にします。
  {% endtab %}

{% tab title="地図上に重ねて表示" %}
オン: 地図の上に浮かぶように表示され、地図上のボタンから開きます。

* **既定で開く**：読み込み時に開きます。

Routeパネルも重ねて表示する場合、同時に開くのは1つだけです。
{% endtab %}
{% endtabs %}

## インタラクション

マーカーごとに設定（手動）するか、 **データマッピング** （クエリ）で設定します。

**選択時** クリックで発火し、 **ドラッグ時** ドラッグでも発火（Leaflet、 **ドラッグ可能なマーカー** オン）。どちらも次を提供します:

<table><thead><tr><th width="228">インタラクションの種類</th><th>説明</th></tr></thead><tbody><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/show-toast.md"><strong>トーストを表示</strong></a></td><td>簡単な通知。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/navigate.md"><strong>移動</strong></a></td><td>別のサイトページまたはURLを開きます。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-alert-modal.md"><strong>アラートモーダルを開く</strong></a></td><td>モーダル内のアラートメッセージ。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-confirm.md"><strong>確認ダイアログを開く</strong></a></td><td>たとえばイベント参加の確認を求めます。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-dialog.md"><strong>フローダイアログを開く</strong></a></td><td>ダイアログ内でフローを実行します。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-panel.md"><strong>フローパネルを開く</strong></a></td><td>サイドパネル内でフローを実行し、マーカーは引き続き表示されます。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/execute-flow.md"><strong>フローを実行</strong></a></td><td>バックグラウンドで自動起動フローを実行し、ダイアログやパネルは表示しません。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/download.md"><strong>ダウンロード</strong></a></td><td>Salesforceファイル、公開リンク、またはURL。</td></tr><tr><td><strong>すべてのクエリを再読み込み</strong></td><td>ページ上のすべてのクエリを再実行します。</td></tr><tr><td><strong>クエリを再読み込み</strong></td><td>地図独自のクエリを再実行します。データソースはクエリのみ。</td></tr></tbody></table>

## スタイリング

〜から **スタイル** セクション。Leafletマップでは次が追加されます **マップマーカー**, **ズームコントロール**, **描画コントロール** と **ルートパネル**.

{% tabs %}
{% tab title="マージン" %}
外側の余白。
{% endtab %}

{% tab title="パディング" %}
内側の余白。
{% endtab %}

{% tab title="サイズ" %}
幅 / 高さ / 最小幅 / 最大幅 / 最小高さ / 最大高さ。
{% endtab %}

{% tab title="ボーダー" %}
サイズ / スタイル / 色 / 半径。
{% endtab %}

{% tab title="ヘッダー" %}

* **ヘッダー:** 背景色; パディング（各辺）; 下マージン。
* **ヘッダーボーダー:** 色 / サイズ / スタイル / 半径; 下ボーダーの色 / サイズ / スタイル（ **ヘッダーを一体化**).
* **ヘッダータイトル**, **ヘッダーキャプション:** 色 / フォントサイズ / フォントウェイト / フォントスタイル。
* **ヘッダーアバター:** 背景色 / 前景色 / ボーダー半径。
  {% endtab %}

{% tab title="マップマーカー" %}
マーカーポップアップ。

* **マップマーカーの背景:** 色。
* **マップマーカーのタイトル:** テキスト色 / フォントサイズ / スタイル / ウェイト。
* **マップマーカーの説明:** 色 / フォントサイズ / スタイル / ウェイト / 行数制限。
  {% endtab %}

{% tab title="ズームコントロール" %}
テキスト / 背景 / 影の色; ボーダーの色 / サイズ / スタイル / 半径。
{% endtab %}

{% tab title="描画コントロール" %}
背景 / 影の色; ボーダーの色 / サイズ / スタイル / 半径。
{% endtab %}

{% tab title="ルートパネル" %}

* **ルートパネル:** 背景色; ボーダーの色 / サイズ / スタイル / 半径。
* **ルートパネルヘッダー:** 背景色 / 色 / フォントサイズ / フォントウェイト。
  {% endtab %}

{% tab title="フィルターパネル" %}
サイドパネル。

* **フィルターパネル:** 背景色; ボーダーの色 / サイズ / スタイル / 半径。
* **フィルターパネルのラベル:** 背景、色（通常、アクティブ、ホバーそれぞれ）; 折りたたみアイコンの色; フォントサイズ / ウェイト。
* **フィルターパネルのオプション:** 色; チェックボックスのボーダー色; さらに読み込むボタンのテキスト色（通常、アクティブ、ホバー）。
* **フィルターパネルのリセットボタン:** 背景 / テキスト / ボーダー色; ボーダーサイズ / 半径; ホバー時の背景色とボーダー色; アクティブ時の背景色とボーダー色。
  {% endtab %}

{% tab title="フローダイアログ" %}

* **フローダイアログヘッダー:** 背景; 下ボーダーの色 / サイズ; ラベルの色 / フォントサイズ / フォントウェイト。
* **フローダイアログフッター:** 背景; 上ボーダーの色 / サイズ。
  {% endtab %}

{% tab title="フローパネル" %}

* **フローパネル:** 背景色; ボーダーの色 / サイズ / スタイル / 半径。
* **フローパネルヘッダー:** 背景; 下ボーダーの色 / サイズ; ラベルの色 / フォントサイズ / フォントウェイト; 閉じるアイコンの色（通常、アクティブ）。
  {% endtab %}
  {% endtabs %}

## ユースケース

| 名前                                                                                                                                                                                  | 説明                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| [**レコード詳細情報を表示するように地図を設定する**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/chtoriaru/components/map/set-up-the-map-to-show-record-details-information.md) | Avonni Mapを使用してExperience Cloudにレコードを表示する方法を学びます。 |

### 例 1: 連動するアカウント地図

{% @arcade/embed url="<https://app.arcade.software/share/Dxon9206UTTMphdamjrL>" flowId="Dxon9206UTTMphdamjrL" %}

地図には、担当者が Accounts Data Table で選択したアカウントの請求先所在地が表示されます。始める前に: ページ上の Accounts Data Table、API 名 `AccountsTable`.

{% stepper %}
{% step %}

#### **Mapコンポーネントを追加**

* AX - Mapコンポーネントを Experience Builder キャンバスにドラッグします
  {% endstep %}

{% step %}

#### **コンポーネントを設定**

* API名を `MapAccount`
* 種類を `Leaflet`
  {% endstep %}

{% step %}

#### **データソースを設定**

* Accountオブジェクトでクエリを作成
* 次のフィルターを適用: Id = `{{AccountsTable.selectedRecord.Id}}`
  {% endstep %}

{% step %}

#### **データマッピングを設定**

* Titleを `アカウント名`
* LocationでLatitudeを `請求先緯度` およびLongitudeを `請求先経度`
  {% endstep %}

{% step %}

#### **作業をプレビュー**

* プレビューで Accounts Data Table のレコードを選択し、地図にその請求先所在地が表示されることを確認します
  {% endstep %}
  {% endstepper %}

### 例 2: 顧客注文の追跡

{% @arcade/embed url="<https://app.arcade.software/share/tiVuRRBHNCbcUb5qoGQL>" flowId="tiVuRRBHNCbcUb5qoGQL" %}

顧客は注文の場所を確認できます。始める前に: 追跡座標を保持する Order 上のカスタム Geolocation フィールド。

{% stepper %}
{% step %}

#### **Mapコンポーネントを追加**

* AX - Mapコンポーネントを Experience Builder キャンバスにドラッグします
  {% endstep %}

{% step %}

#### **コンポーネントを設定**

* API名を `TrackingMap`
* 種類を `Leaflet`
  {% endstep %}

{% step %}

#### **データソースを設定**

* Orderオブジェクトでクエリを作成
  {% endstep %}

{% step %}

#### **データマッピングを設定**

* Titleを `注文番号`
* 種類を `ピン`
* LocationでLatitudeを `追跡ジオロケーション（緯度）` およびLongitudeを `追跡ジオロケーション（経度）`
  {% endstep %}

{% step %}

#### **作業をプレビュー**

* プレビューして、各注文が追跡位置にピンとして表示されることを確認します
  {% endstep %}
  {% endstepper %}

## よくある問題のトラブルシューティング

| 問題                       | 原因                                                        | 修正                                                                                                                                                                                          |
| ------------------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 地図上にRouteボタンがない          | **タイプ** ではない **Leaflet**、または **ルートパネルを表示** オフです。          | 設定 **タイプ** を **Leaflet**、 **ルートパネルを表示** で **ルート**.                                                                                                                                          |
| **ルート** 有効化の案内を表示します     | このパッケージではルーティングが有効になっていません。                               | 管理者が **Avonni Experiences** アプリで、 **設定** タブを参照: [マップルーティングを有効化](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-map/enable-map-routing.md). |
| 道路ではなく直線                 | プロバイダーに到達できないか、クォータを使い切っています。線では停留所の順序が維持されます。            | すべてのルートがフォールバックする場合: Setupで、 **Remote Site Settings**、アクティブ化 `Avonni_Route_Mapbox` と `Avonni_Route_ORS`.                                                                                    |
| Timing設定がないため、到着時刻がありません | OpenRouteServiceがプロバイダーです。TimesとCSVの **到着時刻**はMapboxのみです。 | 想定どおりです。到着時刻にはMapboxが必要です。                                                                                                                                                                  |
| Leafletマップでマーカーが表示されない   | レコードには住所がありますが、座標がありません。                                  | 地図 **緯度** と **経度** の下 **位置**、または設定 **タイプ** を **Google マップ**.                                                                                                                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-map.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
