[comment]: # translation:outdated

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

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

[comment]: # ({40c16871-279559e4})
### Description

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

Cette méthode permet de créer de nouvelles cartes.

::: noteclassic
Cette méthode est disponible à tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

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

[comment]: # ({5e5a27fe-73d879ea})
### Paramètres

`(object/array)` Cartes à créer.

En plus des [propriétés de l'objet carte standard](object#map), la méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|links|array|[Liens de carte](/manual/api/reference/map/object#map_link) à créer sur la carte.|
|selements|array|[Éléments de carte](/manual/api/reference/map/object#map_element) à créer sur la carte.|
|urls|array|[URLs de carte](/manual/api/reference/map/object#map_url) à créer sur la carte.|
|users|array|[Partages d'utilisateur](/manual/api/reference/map/object#map_user) de carte à créer sur la carte.|
|userGroups|array|[Partages de groupe d'utilisateurs](/manual/api/reference/map/object#map_user_group) de carte à créer sur la carte.|
|shapes|array|[Formes de carte](/manual/api/reference/map/object#map_shapes) à créer sur la carte.|
|lines|array|[Lignes de carte](/manual/api/reference/map/object#map_lines) à créer sur la carte.|

::: notetip
Pour créer des liens de carte, il est nécessaire de définir un élément de carte `selementid` sur une valeur arbitraire, puis d'utiliser cette valeur pour référencer cet élément dans les propriétés des liens `selementid1` ou `selementid2`. Lors de la création de l'élément, cette valeur sera 
 remplacée par l'ID correct généré par Zabbix. [Voir l'exemple](create#create_a_host_map).
:::

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

[comment]: # ({2e617567-2e617567})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des cartes créées sous la propriété `sysmapids`. L'ordre des ID retournés correspond à l'ordre des cartes transmises.

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

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

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

[comment]: # ({572a750e-584ef8f6})
#### Créer une carte vide

Créer une carte sans élément.

Requête :

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

Réponse :

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

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

[comment]: # ({29c7501c-e32540ab})
#### Créer une carte d'hôte

Créer une carte avec deux éléments hôtes et un lien entre eux. A noter : l'utilisation de valeurs temporaires "selementid1" et "selementid2" dans l'objet de lien de carte pour faire référence à des éléments de carte.

Requête :

```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
}
```

Réponse :

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

[comment]: # ({/29c7501c-e32540ab})

[comment]: # ({98c17c06-9a8ffa0d})
#### Créer une carte de déclencheurs

Créer une carte avec un élément déclencheur, qui contient deux déclencheurs.

Requête :

```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
}
```

Réponse :

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

[comment]: # ({/98c17c06-9a8ffa0d})

[comment]: # ({0e7f89f6-d8024143})
#### Partager une carte

Créer une carte avec deux types de partage (utilisateur et groupe d'utilisateurs).

Requête :

```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
}
```

Réponse :

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

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

[comment]: # ({1ce73c70-2fa44a8b})
#### Formes de carte

Créer une carte avec un titre.

Requête :

```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
}
```

Réponse :

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

[comment]: # ({/1ce73c70-2fa44a8b})

[comment]: # ({26a2ed33-5aa58242})
#### Ligne de carte

Créer une ligne de carte.

Requête :

```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
}
```

Réponse :

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

[comment]: # ({/26a2ed33-5aa58242})

[comment]: # ({436079d5-436079d5})
### Voir également

- [Elément de carte](object#element_de_carte)
- [Lien de carte](object#lien_de_carte)
- [URL de carte](object#url_de_carte)
- [Utilisateur de carte](object#utilisateur_de_carte)
- [Groupe d'utilisateurs de carte](object#groupe_d_utilisateurs_de_carte)
- [Forme de carte](object#forme_de_carte)
- [Ligne de carte](object#ligne_de_carte)

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

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

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

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