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

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

[comment]: # ({0fca4fb7-279559e4})
### Beschrijving

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

Deze methode maakt het mogelijk om nieuwe kaarten te maken.

::: noteclassic
Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles) voor meer informatie.
:::

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

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

`(object/array)` Kaarten om te maken.

Naast de [standaard kaarteigenschappen](object#kaart), is de methode
accepteert de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|links|array|Kaart [links](/manual/api/reference/map/object#map_link) die op de kaart moet worden gemaakt.|
|selements|array|Kaart [elementen](/manual/api/reference/map/object#map_element) die op de kaart moet worden gemaakt.|
|urls|array|Kaart [URL's](/manual/api/reference/map/object#map_url) die op de kaart moet worden gemaakt.|
|users|array|Map [gebruiker](/manual/api/reference/map/object#map_user) aandelen die op de kaart moeten worden gemaakt.|
|userGroups|array|Map [gebruikersgroep](/manual/api/reference/map/object#map_user_group) aandelen die op de kaart moeten worden gemaakt.|
|shapes|array|Kaart [vormen](/manual/api/reference/map/object#map_shapes) die op de kaart moet worden gemaakt.|
|lines|array|Kaart [lijnen](/manual/api/reference/map/object#map_lines) die op de kaart moet worden gemaakt.|

::: notetip
Om kaartkoppelingen te maken, moet je een kaartelement instellen
`selementid` naar een willekeurige waarde en gebruik dan deze waarde om te verwijzen
dit element in de eigenschappen van de koppelingen `selementid1` of `selementid2`.
Wanneer het element is gemaakt, wordt deze waarde vervangen door de
juiste ID gegenereerd door Zabbix. [Zien
voorbeeld.](create#create_a_host_map)
:::

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

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

`(object)` Retourneert een object dat de ID's van de gemaakte kaarten bevat
onder de eigenschap `sysmapids`. De volgorde van de geretourneerde ID's komt overeen
de volgorde van de doorgegeven kaarten.

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

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

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

[comment]: # ({0b0f72b1-584ef8f6})
#### Maak een lege kaart aan

Maak een kaart aan zonder elementen.

[Aanvraag](/manual/api#het-uitvoeren-van-aanvragen):

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

Antwoord:

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

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

[comment]: # ({80c143be-e32540ab})
#### Maak een hostkaart aan

Maak een kaart aan met twee hostelementen en een link tussen hen. Let op het gebruik van tijdelijke waarden "selementid1" en "selementid2" in het kaartlinkobject om te verwijzen naar kaartelementen.

[Aanvraag](/manual/api#het-uitvoeren-van-aanvragen):

```json
{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Hostkaart",
        "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"
            }
        ]
    },
    "id": 1
}
```

Antwoord:

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

[comment]: # ({/80c143be-e32540ab})

[comment]: # ({3ba12e07-9a8ffa0d})
#### Maak een triggervisualisatiekaart aan

Maak een kaart aan met een triggerelement dat twee triggers bevat.

[Aanvraag](/manual/api#het-uitvoeren-van-aanvragen):

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

Antwoord:

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

[comment]: # ({/3ba12e07-9a8ffa0d})

[comment]: # ({02133606-d8024143})
#### Kaart delen

Maak een kaart aan met twee soorten delen (gebruiker en gebruikersgroep).

[Aanvraag](/manual/api#het-uitvoeren-van-aanvragen):

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

Antwoord:

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

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

[comment]: # ({5865612b-2fa44a8b})
#### Kaartvormen

Maak een kaart aan met de kaartnaam als titel.

[Aanvraag](/manual/api#het-uitvoeren-van-aanvragen):

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

Antwoord:

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

[comment]: # ({/5865612b-2fa44a8b})

[comment]: # ({0fa9ab90-5aa58242})
#### Kaartlijnen

Maak een kaartlijn aan.

[Aanvraag](/manual/api#het-uitvoeren-van-aanvragen):

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

Antwoord:

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

[comment]: # ({/0fa9ab90-5aa58242})

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

- [Kaartelement](object#map_element)
- [Kaartlink](object#map_link)
- [Kaart-URL](object#map_url)
- [Kaartgebruiker](object#map_user)
- [Map gebruikersgroep](object#map_user_group)
- [Kaartvorm](object#map_shapes)
- [Kaartlijn](object#map_lines)

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

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

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

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