[comment]: # aside: 1

[comment]: # ({7bfc83a8-cdacabd4})
# Objeto de mapa

Os seguintes objetos estão diretamente relacionados à API de `map`.

[comment]: # ({/7bfc83a8-cdacabd4})

[comment]: # ({8d884944-62f73225})
### Map

O objeto map possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmapid|ID|ID do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*<br>- *obrigatório* para operações de atualização|
|height|integer|Altura do mapa em pixels.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|name|string|Nome do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|width|integer|Largura do mapa em pixels.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|backgroundid|ID|ID da imagem usada como fundo do mapa.|
|background\_scale|integer|Se a escala proporcional da imagem de fundo está habilitada.<br><br>Valores possíveis:<br>0 - desabilitar escala;<br>1 - *(padrão)* habilitar escala da imagem.|
|expand\_macros|integer|Se macros em rótulos devem ser expandidas ao configurar o mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* não expandir macros;<br>1 - expandir macros.|
|expandproblem|integer|Se o trigger de problema será exibido para elementos com um único problema.<br><br>Valores possíveis:<br>0 - sempre exibir o número de problemas;<br>1 - *(padrão)* exibir o trigger de problema se houver apenas um problema.|
|grid\_align|integer|Se o alinhamento à grade está habilitado.<br><br>Valores possíveis:<br>0 - desabilitar alinhamento à grade;<br>1 - *(padrão)* habilitar alinhamento à grade.|
|grid\_show|integer|Se a grade deve ser exibida no mapa.<br><br>Valores possíveis:<br>0 - não exibir a grade;<br>1 - *(padrão)* exibir a grade.|
|grid\_size|integer|Tamanho da grade do mapa em pixels.<br><br>Valores suportados: 20, 40, 50, 75 e 100.<br><br>Padrão: 50.|
|highlight|integer|Se o destaque de ícones está habilitado.<br><br>Valores possíveis:<br>0 - destaque desabilitado;<br>1 - *(padrão)* destaque habilitado.|
|iconmapid|ID|ID do mapa de ícones usado no mapa.|
|label\_format|integer|Se rótulos avançados estão habilitados.<br><br>Valores possíveis:<br>0 - *(padrão)* desabilitar rótulos avançados;<br>1 - habilitar rótulos avançados.|
|label\_location|integer|Localização do rótulo do elemento do mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* inferior;<br>1 - esquerda;<br>2 - direita;<br>3 - superior.|
|label\_string\_host|string|Rótulo personalizado para elementos de host.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `label_type_host` estiver definido como "custom"|
|label\_string\_hostgroup|string|Rótulo personalizado para elementos de grupo de hosts.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `label_type_hostgroup` estiver definido como "custom"|
|label\_string\_image|string|Rótulo personalizado para elementos de imagem.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `label_type_image` estiver definido como "custom"|
|label\_string\_map|string|Rótulo personalizado para elementos de mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `label_type_map` estiver definido como "custom"|
|label\_string\_trigger|string|Rótulo personalizado para elementos de trigger.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `label_type_trigger` estiver definido como "custom"|
|label\_type|integer|Tipo de rótulo do elemento do mapa.<br><br>Valores possíveis:<br>0 - rótulo;<br>1 - endereço IP;<br>2 - *(padrão)* nome do elemento;<br>3 - apenas status;<br>4 - nada.|
|label\_type\_host|integer|Tipo de rótulo para elementos de host.<br><br>Valores possíveis:<br>0 - rótulo;<br>1 - endereço IP;<br>2 - *(padrão)* nome do elemento;<br>3 - apenas status;<br>4 - nada;<br>5 - personalizado.|
|label\_type\_hostgroup|integer|Tipo de rótulo para elementos de grupo de hosts.<br><br>Valores possíveis:<br>0 - rótulo;<br>2 - *(padrão)* nome do elemento;<br>3 - apenas status;<br>4 - nada;<br>5 - personalizado.|
|label\_type\_image|integer|Tipo de rótulo para elementos de grupo de hosts.<br><br>Valores possíveis:<br>0 - rótulo;<br>2 - *(padrão)* nome do elemento;<br>4 - nada;<br>5 - personalizado.|
|label\_type\_map|integer|Tipo de rótulo para elementos de mapa.<br><br>Valores possíveis:<br>0 - rótulo;<br>2 - *(padrão)* nome do elemento;<br>3 - apenas status;<br>4 - nada;<br>5 - personalizado.|
|label\_type\_trigger|integer|Tipo de rótulo para elementos de trigger.<br><br>Valores possíveis:<br>0 - rótulo;<br>2 - *(padrão)* nome do elemento;<br>3 - apenas status;<br>4 - nada;<br>5 - personalizado.|
|markelements|integer|Se os elementos do mapa que mudaram recentemente de status devem ser destacados.<br><br>Valores possíveis:<br>0 - *(padrão)* não destacar elementos;<br>1 - destacar elementos.|
|severity\_min|integer|Severidade mínima dos triggers que serão exibidos no mapa.<br><br>Consulte a [propriedade `severity` do trigger](/manual/api/reference/trigger/object#trigger) para uma lista de severidades suportadas.|
|show\_element\_label|integer|Como exibir rótulos de elementos por padrão.<br><br>Valores possíveis:<br>0 - sempre exibir;<br>1 - *(padrão)* ocultar automaticamente.|
|show\_link\_label|integer|Como exibir rótulos de links por padrão.<br><br>Valores possíveis:<br>0 - sempre exibir;<br>1 - *(padrão)* ocultar automaticamente.|
|show\_unack|integer|Como os problemas devem ser exibidos.<br><br>Valores possíveis:<br>0 - *(padrão)* exibir a contagem de todos os problemas;<br>1 - exibir apenas a contagem de problemas não reconhecidos;<br>2 - exibir a contagem de problemas reconhecidos e não reconhecidos separadamente.|
|userid|ID|ID do usuário que é o proprietário do mapa.|
|private|integer|Tipo de compartilhamento do mapa.<br><br>Valores possíveis:<br>0 - mapa público;<br>1 - *(padrão)* mapa privado.|
|show\_suppressed|integer|Se problemas suprimidos são exibidos.<br><br>Valores possíveis:<br>0 - *(padrão)* ocultar problemas suprimidos;<br>1 - exibir problemas suprimidos.|

[comment]: # ({/8d884944-62f73225})

[comment]: # ({39c8847f-c7b92dfc})
### Elemento do mapa

O objeto de elemento do mapa define um objeto exibido em um mapa. Ele possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|selementid|ID|ID do elemento do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|elements|array|Objeto de dados [Elemento](#map-element-host).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `elementtype` estiver definido como "host", "mapa", "trigger" ou "grupo de hosts"|
|elementtype|integer|Tipo de elemento do mapa.<br><br>Valores possíveis:<br>0 - host;<br>1 - mapa;<br>2 - trigger;<br>3 - grupo de hosts;<br>4 - imagem.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|iconid\_off|ID|ID da imagem usada para exibir o elemento no estado padrão.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|areatype|integer|Como os hosts do grupo de hosts devem ser exibidos.<br><br>Valores possíveis:<br>0 - *(padrão)* o elemento do grupo de hosts ocupará todo o mapa;<br>1 - o elemento do grupo de hosts terá um tamanho fixo.|
|elementsubtype|integer|Como um elemento de grupo de hosts deve ser exibido em um mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* exibir o grupo de hosts como um único elemento;<br>1 - exibir cada host do grupo separadamente.|
|evaltype|integer|Condição de filtragem de tag do elemento do mapa [método de avaliação](/manual/config/visualization/maps/map#adding-elements).<br><br>Valores possíveis:<br>0 - *(padrão)* E/OU;<br>2 - OU.|
|height|integer|Altura do elemento de grupo de hosts de tamanho fixo em pixels.<br><br>Padrão: 200.|
|iconid\_disabled|ID|ID da imagem usada para exibir elementos de mapa desabilitados.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *suportado* se `elementtype` estiver definido como "host", "mapa", "trigger" ou "grupo de hosts"|
|iconid\_maintenance|ID|ID da imagem usada para exibir elementos de mapa em manutenção.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *suportado* se `elementtype` estiver definido como "host", "mapa", "trigger" ou "grupo de hosts"|
|iconid\_on|ID|ID da imagem usada para exibir elementos de mapa com problemas.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *suportado* se `elementtype` estiver definido como "host", "mapa", "trigger" ou "grupo de hosts"|
|label|string|Rótulo do elemento.|
|label\_location|integer|Localização do rótulo do elemento do mapa.<br><br>Valores possíveis:<br>-1 - *(padrão)* localização padrão;<br>0 - inferior;<br>1 - esquerda;<br>2 - direita;<br>3 - superior.|
|permission|integer|Tipo de nível de permissão.<br><br>Valores possíveis:<br>-1 - nenhum;<br>2 - somente leitura;<br>3 - leitura-escrita.|
|show\_label|integer|Como exibir o rótulo do elemento.<br><br>Valores possíveis:<br>-1 - *(padrão)* padrão do mapa;<br>0 - sempre exibir;<br>1 - ocultar automaticamente.|
|sysmapid|ID|ID do mapa ao qual o elemento pertence.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|urls|array|URLs do elemento do mapa.<br><br>O objeto de URL do elemento do mapa é [descrito em detalhes abaixo](object#map-element-url).|
|use\_iconmap|integer|Se o mapeamento de ícones deve ser usado para elementos de host.<br><br>Valores possíveis:<br>0 - não usar mapeamento de ícones;<br>1 - *(padrão)* usar mapeamento de ícones.|
|viewtype|integer|Algoritmo de posicionamento do elemento do grupo de hosts.<br><br>Valores possíveis:<br>0 - *(padrão)* grade.|
|width|integer|Largura do elemento de grupo de hosts de tamanho fixo em pixels.<br><br>Padrão: 200.|
|x|integer|Coordenadas X do elemento em pixels.<br><br>Padrão: 0.|
|y|integer|Coordenadas Y do elemento em pixels.<br><br>Padrão: 0.|
|zindex|integer|Valor usado para ordenar os elementos do mapa (z-index).<br><br>Padrão: 0.|

[comment]: # ({/39c8847f-c7b92dfc})

[comment]: # ({850c4220-305dd3e0})
#### Elemento de mapa Host

O objeto de elemento de mapa Host define um elemento de host.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|hostid|ID|ID do host.|

[comment]: # ({/850c4220-305dd3e0})

[comment]: # ({d8f65e8c-e1118d67})
#### Elemento de mapa Grupo de hosts

O objeto de elemento de mapa Grupo de hosts define um elemento de grupo de hosts.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|groupid|ID|ID do grupo de hosts.|

[comment]: # ({/d8f65e8c-e1118d67})

[comment]: # ({b29a15a2-2d745dcc})
#### Objeto Map do elemento do mapa

O objeto Map do elemento do mapa define um elemento de mapa.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmapid|ID|ID do mapa.|

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

[comment]: # ({d5e7bb17-0283fd46})
#### Elemento de mapa Trigger

O objeto de elemento de mapa Trigger define um ou mais elementos de trigger.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|triggerid|ID|ID do trigger.|

[comment]: # ({/d5e7bb17-0283fd46})

[comment]: # ({1ac46cd0-a7495119})
#### Tag do elemento do mapa

O objeto Tag do elemento do mapa possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|tag|string|Nome da tag do elemento do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|operator|integer|[Operador](/manual/config/visualization/maps/map#adding-elements) da condição da tag do elemento do mapa.<br><br>Valores possíveis:<br>0 - *(padrão)* Contém;<br>1 - Igual;<br>2 - Não contém;<br>3 - Diferente;<br>4 - Existe;<br>5 - Não existe.|
|value|string|Valor da tag do elemento do mapa.|

[comment]: # ({/1ac46cd0-a7495119})

[comment]: # ({2860936e-5a112b10})
#### URL do elemento do mapa

O objeto de URL do elemento do mapa define um link clicável que estará disponível para um elemento de mapa específico. Ele possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmapelementurlid|ID|ID da URL do elemento do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|name|string|Legenda do link.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|url|string|URL do link.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|selementid|ID|ID do elemento do mapa ao qual a URL pertence.|

[comment]: # ({/2860936e-5a112b10})

[comment]: # ({c95f043b-1e44fd2a})
### Link de mapa

O objeto de link de mapa define um link entre dois elementos do mapa. Ele possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|linkid|ID|ID do link do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|sysmapid|ID|ID do mapa ao qual o link pertence.|
|selementid1|ID|ID do primeiro elemento do mapa vinculado em uma extremidade.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|selementid2|ID|ID do primeiro elemento do mapa vinculado na outra extremidade.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|drawtype|integer|Estilo de desenho da linha do link.<br><br>Valores possíveis:<br>0 - *(padrão)* linha;<br>2 - linha em negrito;<br>3 - linha pontilhada;<br>4 - linha tracejada.|
|color|string|Cor da linha como um código hexadecimal.<br><br>Padrão: `000000`.|
|label|string|Rótulo do link.|
|show\_label|integer|Como exibir o rótulo do link.<br><br>Valores possíveis:<br>-1 - *(padrão)* padrão do mapa;<br>0 - sempre exibir;<br>1 - ocultar automaticamente.|
|indicator\_type|integer|Seleciona o tipo de indicador do link.<br><br>Valores possíveis:<br>0 - *(padrão)* link estático;<br>1 - trigger;<br>2 - valor do item.|
|linktriggers|array|Triggers do link do mapa a serem usadas como indicadores de status do link.<br><br>O objeto de trigger de link de mapa é [descrito em detalhes abaixo](object#map-link-trigger).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `indicator_type` estiver definido como "trigger" (1).|
|itemid|ID|ID do item.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `indicator_type` estiver definido como "valor do item" (2).|
|highlights|array|Destaques do link do mapa a serem usados como indicadores de status do link.<br><br>O objeto de indicadores de link de mapa é [descrito em detalhes abaixo](object#map-link-indicators).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `indicator_type` estiver definido como "valor do item" (2).|
|thresholds|array|Limiares do link do mapa a serem usados como indicadores de status do link.<br><br>O objeto de indicadores de link de mapa é [descrito em detalhes abaixo](object#map-link-indicators).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `indicator_type` estiver definido como "valor do item" (2).|
|permission|integer|Tipo de nível de permissão.<br><br>Valores possíveis:<br>-1 - nenhum;<br>2 - somente leitura;<br>3 - leitura e gravação.|

[comment]: # ({/c95f043b-1e44fd2a})

[comment]: # ({775623bc-219c2bce})
#### Trigger de link de mapa

O objeto de trigger de link de mapa define um indicador de status de link de mapa com base no estado de um trigger. Ele possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|triggerid|ID|ID do trigger usado como indicador de link.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|color|string|Cor do indicador como um código de cor hexadecimal.<br><br>Padrão: `DD0000`.|
|drawtype|integer|Estilo de desenho do indicador.<br><br>Valores possíveis:<br>0 - *(padrão)* linha;<br>2 - linha em negrito;<br>3 - linha pontilhada;<br>4 - linha tracejada.|

[comment]: # ({/775623bc-219c2bce})

[comment]: # ({f89ab8e1-d49698db})
#### Indicadores de link de mapa

O objeto de indicadores de link de mapa define um indicador de status de link de mapa com base no valor do item. Possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|pattern|string|Expressão regular para comparar. Disponível apenas para destaques.|
|sortorder|integer|Usado para definir a ordem de classificação dos destaques. Disponível apenas para destaques.|
|threshold|string|Valor numérico para comparar. Disponível apenas para limites.|
|drawtype|integer|Estilo de desenho do indicador.<br><br>Valores possíveis:<br>0 - *(padrão)* linha;<br>2 - linha em negrito;<br>3 - linha pontilhada;<br>4 - linha tracejada.|
|color|string|Cor do indicador como um código de cor hexadecimal.<br><br>Padrão: `DD0000`.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

[comment]: # ({/f89ab8e1-d49698db})

[comment]: # ({8b7be8a6-96c2bee0})
### URL do mapa

O objeto de URL do mapa define um link clicável que estará disponível para todos os elementos de um tipo específico no mapa. Ele possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmapurlid|ID|ID da URL do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|name|string|Legenda do link.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|url|string|URL do link.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|elementtype|integer|Tipo de elemento do mapa para o qual a URL estará disponível.<br><br>Consulte a [propriedade `type` do elemento do mapa](object#map-element) para uma lista de tipos suportados.<br><br>Padrão: 0.|
|sysmapid|ID|ID do mapa ao qual a URL pertence.|

[comment]: # ({/8b7be8a6-96c2bee0})

[comment]: # ({385d7255-942f03ad})
### Usuário do mapa

Lista de permissões de mapa com base nos usuários. Possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmapuserid|ID|ID do usuário do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|userid|ID|ID do usuário.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|permission|integer|Tipo de nível de permissão.<br><br>Valores possíveis:<br>2 - somente leitura;<br>3 - leitura-escrita.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

[comment]: # ({/385d7255-942f03ad})

[comment]: # ({adad1979-f6e63a8f})
### Grupo de usuários do mapa

Lista de permissões de mapa com base em grupos de usuários. Possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmapusrgrpid|ID|ID do grupo de usuários do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|usrgrpid|ID|ID do grupo de usuários.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|permission|integer|Tipo de nível de permissão.<br><br>Valores possíveis:<br>2 - somente leitura;<br>3 - leitura e gravação.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

[comment]: # ({/adad1979-f6e63a8f})

[comment]: # ({6cdb0526-9d0acde7})
### Formas do mapa

O objeto de forma do mapa define uma forma geométrica (com ou sem texto)
exibida em um mapa. Possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmap\_shapeid|ID|ID do elemento de forma do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|type|integer|Tipo de elemento de forma do mapa.<br><br>Valores possíveis:<br>0 - retângulo;<br>1 - elipse.<br><br>A propriedade é obrigatória quando novas formas são criadas.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|x|integer|Coordenadas X da forma em pixels.<br><br>Padrão: 0.|
|y|integer|Coordenadas Y da forma em pixels.<br><br>Padrão: 0.|
|width|integer|Largura da forma em pixels.<br><br>Padrão: 200.|
|height|integer|Altura da forma em pixels.<br><br>Padrão: 200.|
|text|string|Texto da forma.|
|font|integer|Fonte do texto dentro da forma.<br><br>Valores possíveis:<br>0 - Georgia, serif<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif<br>2 - "Times New Roman", Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - "Arial Black", Gadget, sans-serif<br>5 - "Comic Sans MS", cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - "Trebuchet MS", Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - "Courier New", Courier, monospace<br>12 - "Lucida Console", Monaco, monospace<br><br>Padrão: 9.|
|font\_size|integer|Tamanho da fonte em pixels.<br><br>Padrão: 11.|
|font\_color|string|Cor da fonte.<br><br>Padrão: `000000`.|
|text\_halign|integer|Alinhamento horizontal do texto.<br><br>Valores possíveis:<br>0 - centro;<br>1 - esquerda;<br>2 - direita.<br><br>Padrão: 0.|
|text\_valign|integer|Alinhamento vertical do texto.<br><br>Valores possíveis:<br>0 - meio;<br>1 - topo;<br>2 - inferior.<br><br>Padrão: 0.|
|border\_type|integer|Tipo da borda.<br><br>Valores possíveis:<br>0 - nenhuma;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Padrão: 0.|
|border\_width|integer|Largura da borda em pixels.<br><br>Padrão: 0.|
|border\_color|string|Cor da borda.<br><br>Padrão: `000000`.|
|background\_color|string|Cor de fundo (cor de preenchimento).<br><br>Padrão: `(vazio)`.|
|zindex|integer|Valor usado para ordenar todas as formas e linhas (z-index).<br><br>Padrão: 0.|

[comment]: # ({/6cdb0526-9d0acde7})

[comment]: # ({a3759606-b1536eee})
### Linhas do mapa

O objeto de linha do mapa define uma linha exibida em um mapa. Ele possui as seguintes propriedades:

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|sysmap\_shapeid|ID|ID do elemento de forma do mapa.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*|
|x1|integer|Coordenadas X do ponto 1 da linha em pixels.<br><br>Padrão: 0.|
|y1|integer|Coordenadas Y do ponto 1 da linha em pixels.<br><br>Padrão: 0.|
|x2|integer|Coordenadas X do ponto 2 da linha em pixels.<br><br>Padrão: 200.|
|y2|integer|Coordenadas Y do ponto 2 da linha em pixels.<br><br>Padrão: 200.|
|line\_type|integer|Tipo das linhas.<br><br>Valores possíveis:<br>0 - nenhum;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Padrão: 0.|
|line\_width|integer|Largura das linhas em pixels.<br><br>Padrão: 0.|
|line\_color|string|Cor da linha.<br><br>Padrão: `000000`.|
|zindex|integer|Valor usado para ordenar todas as formas e linhas (z-index).<br><br>Padrão: 0.|

[comment]: # ({/a3759606-b1536eee})
