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

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

[comment]: # ({0fca4fb7-279559e4})
### Descripción

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

Este método permite crear nuevos mapas.

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos
para llamar al método se pueden revocar en la configuración de roles de usuario. Ver [Roles de
usuario](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::

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

[comment]: # ({5e5a27fe-73d879ea})
### Parámetros

`(objeto/matriz)` Mapas para crear.

Además de las [propiedades de mapa estándar] (object#map), el método
acepta los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|links|matriz|[Enlaces de mapa](/manual/api/reference/map/object#map_link) que se crearán en el mapa.|
|selements|matriz|[Elementos de mapa](/manual/api/reference/map/object#map_element) que se crearán en el mapa.|
|urls|matriz|[URL de mapa](/manual/api/reference/map/object#map_url) que se crearán en el mapa.|
|users|matriz|[Usuario del mapa](/manual/api/reference/map/object#map_user) que pueden compartir el mapa y que se crearán en el mapa.|
|userGroups|matriz|Asignar recursos compartidos de [grupo de usuarios](/manual/api/reference/map/object#map_user_group) que se crearán en el mapa.|
|shapes|matriz|[Formas del mapa](/manual/api/reference/map/object#map_shapes) que se crearán en el mapa.|
|lines|matriz|[Líneas de mapa](/manual/api/reference/map/object#map_lines) que se crearán en el mapa.|

::: notetip
Para crear enlaces de mapas, deberá configurar un elemento de mapa.
`selementid` a un valor arbitrario y luego usar este valor para hacer referencia a
este elemento en las propiedades de los enlaces `selementid1` o `selementid2`.
Cuando se crea el elemento, este valor será reemplazado por la
ID correcta generada por Zabbix. [Ver
ejemplo.](create#create_a_host_map)
:::

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

[comment]: # ({2e617567-2e617567})
### Valores de retorno

`(objeto)` Devuelve un objeto que contiene los ID de los mapas creados
bajo la propiedad `sysmapids`. El orden de los ID devueltos coincide.
el orden de los mapas pasados.

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

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

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

[comment]: # ({0b0f72b1-584ef8f6})
#### Crear un mapa vacío

Crea un mapa sin elementos.

[Solicitud](/manual/api#performing-requests):

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

Respuesta:

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

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

[comment]: # ({80c143be-e32540ab})
#### Crear un mapa de equipo

Cree un mapa con dos elementos de equipo y un vínculo entre ellos. Observe el
uso de valores temporales "selementid1" y "selementid2" en el objeto de enlace del mapa para referirse a elementos del mapa.

[Solicitud](/manual/api#performing-requests):

```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"
            }
        ]
    },
    "id": 1
}
```

Respuesta:

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

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

[comment]: # ({3ba12e07-9a8ffa0d})
#### Crear un mapa de iniciadores

Crear un mapa con elemento de iniciador, que contienen dos iniciadores.

[Solicitud](/manual/api#performing-requests):

```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"
            }
        ]
    },
    "id": 1
}
```

Respuesta:

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

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

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

Cree un mapa con dos tipos de uso compartido (usuario y grupo de usuarios).

[Solicitud](/manual/api#performing-requests):


```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"
            }
        ]
    },
    "id": 1
}
```

Respuesta:

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

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

[comment]: # ({5865612b-2fa44a8b})
#### Formas del mapa

Cree un mapa con el título del nombre del mapa.

[Solicitud](/manual/api#performing-requests):

```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}"
            }
        ]
    },
    "id": 1
}
```

Respuesta:

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

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

[comment]: # ({0fa9ab90-5aa58242})
#### Líneas del mapa

Crea una línea de mapa.

[Solicitud](/manual/api#performing-requests):

```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"
            }
        ]
    },
    "id": 1
}
```

Respuesta:

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

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

[comment]: # ({436079d5-436079d5})
### Ver también

-   [Elemento del mapa](object#map_element)
-   [Enlace del mapa](object#map_link)
-   [URL del mapa](object#map_url)
-   [Usuario del mapa]((object#map_user)
-   [Grupo de usuarios del mapa ](object#map_user_group)
-   [Forma del mapa](object#map_shapes)
-   [Línea del mapa](object#map_lines)

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

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

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

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