[comment]: # ({5d9c8f6f-36d63c25})
# 13 Mapa
[comment]: # ({/5d9c8f6f-36d63c25})
[comment]: # ({7168bc3f-5d3b49a4})
### Descrição
Estes parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget de dashboard permitem configurar o [*Map*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) nos métodos `dashboard.create` e `dashboard.update` .
::: noteimportant
As propriedades do widget`fields` não são validadas durante a criação ou atualização de um dashboard.
Isso permite que os usuários modifiquem os Widgets integrados [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) e criem Widgets personalizados [custom widgets](/manual/modules#developing-modules), mas também introduz o risco de criar e atualizar Widgets de forma incorreta.
Para garantir a criação ou atualização bem-sucedida do widget *Mapa*, consulte os requisitos de parâmetros delineados nas tabelas abaixo.
:::
[comment]: # ({/7168bc3f-5d3b49a4})
[comment]: # ({490eaaac-e91ef9af})
### Parâmetros
Os seguintes parâmetros são suportados para o Widget *Map*.
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|*Intervalo de atualização*|0|rf_rate|0 - Sem atualização;
10 - 10 segundos;
30 - 30 segundos;
60 - 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - *(padrão)* 15 minutos.|
|*Tipo de fonte*|0|source_type|1 - *(padrão)* Mapa;
2 - Árvore de navegação do mapa.|
|*Mapa*|8|sysmapid|ID do [Map](/manual/api/reference/map/get) .
Parâmetro *Map* necessário se *Tipo de fonte* estiver configurado como "Mapa".|
|*Referência do widget vinculado*|1|filter_widget_reference|Valor válido do parâmetro *Referência do widget* [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree) .
Parâmetro *Referência do widget vinculado* necessário se *Tipo de fonte* estiver configurado como "Árvore de navegação do mapa".|
[comment]: # ({/490eaaac-e91ef9af})
[comment]: # ({1509d89a-85e84f33})
### Exemplos
Os seguintes exemplos têm como objetivo apenas descrever a configuração dos objetos de campo do widget de dashboard para o widget *Mapa*. Para obter mais informações sobre a configuração de um dashboard, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/1509d89a-85e84f33})
[comment]: # ({56430e8e-ce6f770b})
#### Configurando um widget *Map*
Configure um widget *Map* que exibe o mapa "1".
Solicitação:
```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
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Resposta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/56430e8e-ce6f770b})
[comment]: # ({e2deece3-a52bd53b})
#### Configurando um widget *Mapa* vinculado
Configure um widget *Mapa* vinculado a um widget [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget).
Solicitação:
```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
}
```
Resposta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/e2deece3-a52bd53b})
[comment]: # ({68e104c3-b648e5e7})
### Consulte também
- [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
- [Map navigation tree](/manual/api/reference/dashboard/widget_fields/map_tree)
[comment]: # ({/68e104c3-b648e5e7})