[comment]: # ({5d9c8f6f-592a0eef})
# 13 Mapa
[comment]: # ({/5d9c8f6f-592a0eef})
[comment]: # ({8c17e79b-abd28bf0})
### Descripción
Estos parámetros y los valores de propiedad posibles para los objetos de campo del widget del tablero respectivo permiten configurar
el widget [*Mapa*](/manual/web_interface/frontend_sections/dashboards/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 los [widgets integrados](/manual/web_interface/frontend_sections/dashboards/widgets) y crear [widgets personalizados](/devel/modules/tutorials/widget), 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 descrito en las tablas siguientes.
:::
[comment]: # ({/8c17e79b-abd28bf0})
[comment]: # ({bd89d7ce-4f526f4d})
### 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 origen*|0|source_type|1 - *(predeterminado)* Mapa;
2 - Árbol de navegación del mapa.|
|*Mapa*|8|sysmapid|[Mapa](/manual/api/reference/map/get) ID.
[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatorio* si *Tipo de fuente* está configurado en "Mapa"|
|*Referencia del widget vinculado*|1|filter_widget_reference|Valor del parámetro de *Referencia* del widget [*árbol de navegación del mapa*](/manual/api/reference/dashboard/widget_fields/map_tree) válido.
[Comportamiento del parámetro] (/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si *Tipo de origen* está configurado en "Árbol de navegación del mapa"|
[comment]: # ({/bd89d7ce-4f526f4d})
[comment]: # ({1509d89a-f67daee4})
### 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-f67daee4})
[comment]: # ({027dd4a9-c0fde9a7})
#### Configuración de un widget *Mapa*
Configure un widget *Mapa* que muestre el mapa "1".
[Solicitud](/manual/api#performing-requests):
```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": 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
}
]
},
"id": 1
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/027dd4a9-c0fde9a7})
[comment]: # ({97f11bff-5ca6f7fa})
#### 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](/manual/api#performing-requests):
```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
}
]
},
"id": 1
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/97f11bff-5ca6f7fa})
[comment]: # ({68e104c3-712fb13b})
### 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-712fb13b})