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

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

[comment]: # ({cae1d7a2-279559e4})
### Leírás

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

Ez a módszer lehetővé teszi új térképek létrehozását.

::: noteclassic
Ez a módszer bármilyen típusú felhasználó számára elérhető. Engedélyek
A metódus meghívása a felhasználói szerepkör beállításaiban visszavonható. Lásd: [User
roles](/manual/web_interface/frontend_sections/administration/user_roles)
további információért.
:::

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

[comment]: # ({5e5a27fe-73d879ea})
### Paraméterek

`(objektum/tömb)` Létrehozandó térképek.

A [standard térképtulajdonságok](object#map) mellett a metódus
elfogadja a következő paramétereket.

|Paraméter|[Típus](/manual/api/reference_commentary#data_types)|Leírás|
|--|--|------|
|links|array|Térkép [linkek](/manual/api/reference/map/object#map_link) létrehozandó a térképen.|
|selements|array|Térkép [elemek](/manual/api/reference/map/object#map_element) létrehozandó a térképen.|
|urls|array|Létrehozandó [URL-ek](/manual/api/reference/map/object#map_url) térképen.|
|users|array|Térképes [user](/manual/api/reference/map/object#map_user) megosztásokat létrehozni a térképen.|
|userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) megosztások létrehozása a térképen.|
|shapes|array|Térkép [alakzatok](/manual/api/reference/map/object#map_shapes) létrehozandó a térképen.|
|vonalak|tömb|Térkép [vonalak](/manual/api/reference/map/object#map_lines) létrehozandó a térképen.|

::: jegyzet
Térképhivatkozások létrehozásához be kell állítania egy térképelemet
`selementid` egy tetszőleges értékre, majd használja ezt az értéket a hivatkozáshoz
ez az elem a linkek `selementid1` vagy `selementid2` tulajdonságaiban.
Az elem létrehozásakor ezt az értéket a rendszer a következőre cseréli
a Zabbix által generált helyes azonosító. [Lát
példa.](create#create_a_host_map)
:::

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

[comment]: # ({2e617567-2e617567})
### Visszatérési értékek

`(object)` A létrehozott térképek azonosítóit tartalmazó objektumot ad eredményül
a `sysmapids` tulajdonság alatt. A visszaküldött azonosítók sorrendje megegyezik
az átadott térképek sorrendje.

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

[comment]: # ({b41637d2-b41637d2})
### Példák

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

[comment]: # ({3d37232d-584ef8f6})
#### Hozzon létre egy üres térképet

Készítsen térképet elemek nélkül.

Kérés:

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

Válasz:

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

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

[comment]: # ({b7d9e933-e32540ab})
#### Create a host map

Create a map with two host elements and a link between them. Note the
use of temporary "selementid1" and "selementid2" values in the map link
object to refer to map elements.

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]: # ({/b7d9e933-e32540ab})

[comment]: # ({7cfc7686-9a8ffa0d})
#### Create a trigger map

Create a map with trigger element, which contains two triggers.

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]: # ({/7cfc7686-9a8ffa0d})

[comment]: # ({4ad215d4-d8024143})
#### Map sharing

Create a map with two types of sharing (user and user group).

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]: # ({/4ad215d4-d8024143})

[comment]: # ({1df5fc2f-2fa44a8b})
#### Map shapes

Create a map with map name 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]: # ({/1df5fc2f-2fa44a8b})

[comment]: # ({5d76c251-5aa58242})
#### Map lines

Create a map line.

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]: # ({/5d76c251-5aa58242})

[comment]: # ({436079d5-436079d5})
### Lásd még

- [Térképelem](object#map_element)
- [Térképlink](object#map_link)
- [Térkép URL](object#map_url)
- [Térképfelhasználó](object#map_user)
- [Térkép felhasználói csoport](object#map_user_group)
- [Térkép alakzat](objektum#térkép_alakzatok)
- [Térképvonal](object#map_lines)

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

[comment]: # ({a9533b09-a9533b09})
### Forrás

CMap::create() az *ui/include/classes/api/services/CMap.php*-ban.

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