[comment]: # ({5d9c8f6f-36d63c25})
# 13 Mapa
[comment]: # ({/5d9c8f6f-36d63c25})
[comment]: # ({7168bc3f-5d3b49a4})
### Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget del tablero permiten configurar
el widget [*Mapa*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) en los métodos `dashboard.create` y `dashboard.update`.
::: noteimportant
Las propiedades de los "campos" del widget no se validan durante la creación o actualización de un tablero.
Esto permite a los usuarios modificar [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) y crear [widgets personalizados](/manual/modules#developing-modules), pero también introduce el riesgo de crear o actualizar widgets incorrectamente.
Para garantizar la creación o actualización exitosa del widget *Mapa*, consulte el comportamiento de los parámetros descritos en las tablas siguientes.
:::
[comment]: # ({/7168bc3f-5d3b49a4})
[comment]: # ({490eaaac-e91ef9af})
### Parámetros
Los siguientes parámetros son compatibles con el widget *Mapa*.
|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Intervalo de actualización*|0|rf_rate|0 - Sin actualización;
10 - 10 segundos;
30 - 30 segundos;
60 - 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - *(predeterminado)* 15 minutos.|
|*Tipo de fuente*|0|source_type|1 - *(predeterminado)* Mapa;
2 - Árbol de navegación del mapa.|
|*Mapa*|8|sysmapid|[Mapa](/manual/api/reference/map/get) ID.
Parámetro *Mapa* requerido si *Tipo de fuente* está configurado en "Mapa".|
|*Referencia del widget vinculado*|1|filter_widget_reference|Valor del parametro válido *Referencia* del [*árbol de navegación del mapa*](/manual/api/reference/dashboard/widget_fields/map_tree).
Parámetro *Widget vinculado referencia* requerida si *Tipo de fuente* está configurado en "Árbol de navegación del mapa".|
[comment]: # ({/490eaaac-e91ef9af})
[comment]: # ({1509d89a-85e84f33})
### Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del dashboard para el widget *Graph*.
Para obtener más información sobre la configuración de un dashboard, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/1509d89a-85e84f33})
[comment]: # ({56430e8e-ce6f770b})
#### Configuración de un widget *Mapa*
Configure un widget *Mapa* que muestre el mapa "1".
Solicitud:
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "map",
"name": "Mapa",
"x": 0,
"y": 0,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 8,
"name": "sysmapid",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/56430e8e-ce6f770b})
[comment]: # ({e2deece3-a52bd53b})
#### Configuración de un widget *Mapa* vinculado
Configure un widget *Mapa* que esté vinculado a un widget [*árbol de navegación del mapa*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget).
Solicitud:
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "map",
"name": "Map",
"x": 0,
"y": 5,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "source_type",
"value": 2
},
{
"type": 1,
"name": "filter_widget_reference",
"value": "ABCDE"
}
]
},
{
"type": "navtree",
"name": "Map navigation tree",
"x": 0,
"y": 0,
"width": 6,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "navtree.name.1",
"value": "Element A"
},
{
"type": 1,
"name": "navtree.name.2",
"value": "Element B"
},
{
"type": 1,
"name": "navtree.name.3",
"value": "Element C"
},
{
"type": 1,
"name": "navtree.name.4",
"value": "Element A1"
},
{
"type": 1,
"name": "navtree.name.5",
"value": "Element A2"
},
{
"type": 1,
"name": "navtree.name.6",
"value": "Element B1"
},
{
"type": 1,
"name": "navtree.name.7",
"value": "Element B2"
},
{
"type": 0,
"name": "navtree.parent.4",
"value": 1
},
{
"type": 0,
"name": "navtree.parent.5",
"value": 1
},
{
"type": 0,
"name": "navtree.parent.6",
"value": 2
},
{
"type": 0,
"name": "navtree.parent.7",
"value": 2
},
{
"type": 0,
"name": "navtree.order.1",
"value": 1
},
{
"type": 0,
"name": "navtree.order.2",
"value": 2
},
{
"type": 0,
"name": "navtree.order.3",
"value": 3
},
{
"type": 0,
"name": "navtree.order.4",
"value": 1
},
{
"type": 0,
"name": "navtree.order.5",
"value": 2
},
{
"type": 0,
"name": "navtree.order.6",
"value": 1
},
{
"type": 0,
"name": "navtree.order.7",
"value": 2
},
{
"type": 8,
"name": "navtree.sysmapid.6",
"value": 1
},
{
"type": 1,
"name": "reference",
"value": "ABCDE"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/e2deece3-a52bd53b})
[comment]: # ({68e104c3-b648e5e7})
### Ver también
- [Campo del widget del tablero](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
- [Árbol de navegación del mapa](/manual/api/reference/dashboard/widget_fields/map_tree)
[comment]: # ({/68e104c3-b648e5e7})