[comment]: # translation:outdated

[comment]: # ({0067e4a0-0067e4a0})
# map.create

[comment]: # ({/0067e4a0-0067e4a0})

[comment]: # ({c759ac06-279559e4})
### 説明

`object map.create(object/array maps)`

このメソッドで、新しいマップを作成できます。

::: noteclassic
このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。
:::

[comment]: # ({/c759ac06-279559e4})

[comment]: # ({5e5a27fe-73d879ea})
### パラメータ

`(object/array)` マップの作成

このメソッドは[標準のマッププロパティ](object#map)に加えて、次のパラメーターを受け入れます。

|パラメータ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|links|array|マップ上に作成するマップ[リンク](/manual/api/reference/map/object#map_link)|
|selements|array|マップ上に作成するマップ[エレメント](/manual/api/reference/map/object#map_element)|
|urls|array|マップ上に作成するマップ[URLs](/manual/api/reference/map/object#map_url)|
|users|array|マップ上に作成するマップ[ユーザー](/manual/api/reference/map/object#map_user)共有|
|userGroups|array|マップ上に作成するマップ[ユーザーグループ](/manual/api/reference/map/object#map_user_group)共有|
|shapes|array|マップ上に作成するマップ[形状](/manual/api/reference/map/object#map_shapes)|
|lines|array|マップ上に作成するマップ[ライン](/manual/api/reference/map/object#map_lines)|

::: notetip
マップリンクを作成するには、マップ要素の`selementid`を任意の値に設定し、この値を使用してリンクの`selementid1`または`selementid2`プロパティでこの要素を参照する必要があります。 要素が作成されるとこの値はZabbixによって生成された正しいIDに置き換えられます。[例を参照](create#create_a_host_map)
:::

[comment]: # ({/5e5a27fe-73d879ea})

[comment]: # ({2e617567-2e617567})
### 戻り値

`(object)` `sysmapids`プロパティの下で作成されたマップのIDを含むオブジェクトを返します。 返されるIDの順序は、渡されたマップの順序と一致します。

[comment]: # ({/2e617567-2e617567})

[comment]: # ({b41637d2-b41637d2})
### 例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({b0f5d01f-584ef8f6})
#### 空のマップを作成する

要素のないマップを作成します。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Map",
        "width": 600,
        "height": 600
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "8"
        ]
    },
    "id": 1
}
```

[comment]: # ({/b0f5d01f-584ef8f6})

[comment]: # ({8354886f-e32540ab})
#### ホストマップを作成する

2つのホスト要素とそれらの間のリンクを使用してマップを作成します。 マップ要素を参照するために、マップリンクオブジェクトで一時的な「selementid1」および「selementid2」値を使用していることに注意してください。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Host map",
        "width": 600,
        "height": 600,
        "selements": [
            {
                "selementid": "1",
                "elements": [
                    {"hostid": "1033"}
                ],
                "elementtype": 0,
                "iconid_off": "2"
            },

            {
                "selementid": "2",
                "elements": [
                    {"hostid": "1037"}
                ],
                "elementtype": 0,
                "iconid_off": "2"
            }
        ],
        "links": [
            {
                "selementid1": "1",
                "selementid2": "2"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "9"
        ]
    },
    "id": 1
}
```

[comment]: # ({/8354886f-e32540ab})

[comment]: # ({054df3b2-9a8ffa0d})
#### トリガーマップを作成する

2つのトリガーを含むトリガー要素を使用してマップを作成します。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Trigger map",
        "width": 600,
        "height": 600,
        "selements": [
            {
                "elements": [
                    {"triggerid": "12345"},
                    {"triggerid": "67890"}
                ],
                "elementtype": 2,
                "iconid_off": "2"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "10"
        ]
    },
    "id": 1
}
```

[comment]: # ({/054df3b2-9a8ffa0d})

[comment]: # ({515ef1b5-d8024143})
#### 地図の共有

2種類の共有（ユーザーとユーザーグループ）マップを作成します。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Map sharing",
        "width": 600,
        "height": 600,
        "users": [
            {
                "userid": "4",
                "permission": "3"
            }
        ],
        "userGroups": [
            {
                "usrgrpid": "7",
                "permission": "2"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "9"
        ]
    },
    "id": 1
}
```

[comment]: # ({/515ef1b5-d8024143})

[comment]: # ({733cbad8-2fa44a8b})
#### マップの形状

マップ名titleでマップを作成します。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Host map",
        "width": 600,
        "height": 600,
        "shapes": [
            {
                "type": 0,
                "x": 0,
                "y": 0,
                "width": 600,
                "height": 11,
                "text": "{MAP.NAME}"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "10"
        ]
    },
    "id": 1
}
```

[comment]: # ({/733cbad8-2fa44a8b})

[comment]: # ({8f9dc2b3-5aa58242})
#### マップライン

マップラインを作成します。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Map API lines",
        "width": 500,
        "height": 500,
        "lines": [
            {
                "x1": 30,
                "y1": 10,
                "x2": 100,
                "y2": 50,
                "line_type": 1,
                "line_width": 10,
                "line_color": "009900"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "11"
        ]
    },
    "id": 1
}
```

[comment]: # ({/8f9dc2b3-5aa58242})

[comment]: # ({436079d5-436079d5})
### 参照

-   [Map element](object#map_element)
-   [Map link](object#map_link)
-   [Map URL](object#map_url)
-   [Map user](object#map_user)
-   [Map user group](object#map_user_group)
-   [Map shape](object#map_shapes)
-   [Map line](object#map_lines)

[comment]: # ({/436079d5-436079d5})

[comment]: # ({a9533b09-a9533b09})
### ソース

CMap::create() in *ui/include/classes/api/services/CMap.php*.

[comment]: # ({/a9533b09-a9533b09})