[comment]: # ({7bfc83a8-cdacabd4})
# Map object
The following objects are directly related to the `map` API.
[comment]: # ({/7bfc83a8-cdacabd4})
[comment]: # ({29fc1f83-62f73225})
### Map
The map object has the following properties.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmapid|string|*(readonly)* ID of the map.|
|**height**
(required)|integer|Height of the map in pixels.|
|**name**
(required)|string|Name of the map.|
|**width**
(required)|integer|Width of the map in pixels.|
|backgroundid|string|ID of the image used as the background for the map.|
|expand\_macros|integer|Whether to expand macros in labels when configuring the map.
Possible values:
0 - *(default)* do not expand macros;
1 - expand macros.|
|expandproblem|integer|Whether the problem trigger will be displayed for elements with a single problem.
Possible values:
0 - always display the number of problems;
1 - *(default)* display the problem trigger if there's only one problem.|
|grid\_align|integer|Whether to enable grid aligning.
Possible values:
0 - disable grid aligning;
1 - *(default)* enable grid aligning.|
|grid\_show|integer|Whether to show the grid on the map.
Possible values:
0 - do not show the grid;
1 - *(default)* show the grid.|
|grid\_size|integer|Size of the map grid in pixels.
Supported values: 20, 40, 50, 75 and 100.
Default: 50.|
|highlight|integer|Whether icon highlighting is enabled.
Possible values:
0 - highlighting disabled;
1 - *(default)* highlighting enabled.|
|iconmapid|string|ID of the icon map used on the map.|
|label\_format|integer|Whether to enable advanced labels.
Possible values:
0 - *(default)* disable advanced labels;
1 - enable advanced labels.|
|label\_location|integer|Location of the map element label.
Possible values:
0 - *(default)* bottom;
1 - left;
2 - right;
3 - top.|
|label\_string\_host|string|Custom label for host elements.
Required for maps with custom host label type.|
|label\_string\_hostgroup|string|Custom label for host group elements.
Required for maps with custom host group label type.|
|label\_string\_image|string|Custom label for image elements.
Required for maps with custom image label type.|
|label\_string\_map|string|Custom label for map elements.
Required for maps with custom map label type.|
|label\_string\_trigger|string|Custom label for trigger elements.
Required for maps with custom trigger label type.|
|label\_type|integer|Map element label type.
Possible values:
0 - label;
1 - IP address;
2 - *(default)* element name;
3 - status only;
4 - nothing.|
|label\_type\_host|integer|Label type for host elements.
Possible values:
0 - label;
1 - IP address;
2 - *(default)* element name;
3 - status only;
4 - nothing;
5 - custom.|
|label\_type\_hostgroup|integer|Label type for host group elements.
Possible values:
0 - label;
2 - *(default)* element name;
3 - status only;
4 - nothing;
5 - custom.|
|label\_type\_image|integer|Label type for host group elements.
Possible values:
0 - label;
2 - *(default)* element name;
4 - nothing;
5 - custom.|
|label\_type\_map|integer|Label type for map elements.
Possible values:
0 - label;
2 - *(default)* element name;
3 - status only;
4 - nothing;
5 - custom.|
|label\_type\_trigger|integer|Label type for trigger elements.
Possible values:
0 - label;
2 - *(default)* element name;
3 - status only;
4 - nothing;
5 - custom.|
|markelements|integer|Whether to highlight map elements that have recently changed their status.
Possible values:
0 - *(default)* do not highlight elements;
1 - highlight elements.|
|severity\_min|integer|Minimum severity of the triggers that will be displayed on the map.
Refer to the [trigger "severity" property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.|
|show\_unack|integer|How problems should be displayed.
Possible values:
0 - *(default)* display the count of all problems;
1 - display only the count of unacknowledged problems;
2 - display the count of acknowledged and unacknowledged problems separately.|
|userid|string|Map owner user ID.|
|private|integer|Type of map sharing.
Possible values:
0 - public map;
1 - *(default)* private map.|
|show\_suppressed|integer|Whether suppressed problems are shown.
Possible values:
0 - *(default)* hide suppressed problems;
1 - show suppressed problems.|
Note that for some methods (update, delete) the required/optional parameter combination is different.
[comment]: # ({/29fc1f83-62f73225})
[comment]: # ({868adba3-c7b92dfc})
### Map element
The map element object defines an object displayed on a map. It has the
following properties.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|selementid|string|*(readonly)* ID of the map element.|
|**elements**
(required)|array|Element data object. Required for host, host group, trigger and map type elements.|
|**elementtype**
(required)|integer|Type of map element.
Possible values:
0 - host;
1 - map;
2 - trigger;
3 - host group;
4 - image.|
|**iconid\_off**
(required)|string|ID of the image used to display the element in default state.|
|areatype|integer|How separate host group hosts should be displayed.
Possible values:
0 - *(default)* the host group element will take up the whole map;
1 - the host group element will have a fixed size.|
|elementsubtype|integer|How a host group element should be displayed on a map.
Possible values:
0 - *(default)* display the host group as a single element;
1 - display each host in the group separately.|
|evaltype|integer|Map element tag filtering condition evaluation method.
Possible values:
0 - *(default)* AND / OR;
2 - OR.|
|height|integer|Height of the fixed size host group element in pixels.
Default: 200.|
|iconid\_disabled|string|ID of the image used to display disabled map elements. Unused for image elements.|
|iconid\_maintenance|string|ID of the image used to display map elements in maintenance. Unused for image elements.|
|iconid\_on|string|ID of the image used to display map elements with problems. Unused for image elements.|
|label|string|Label of the element.|
|label\_location|integer|Location of the map element label.
Possible values:
-1 - *(default)* default location;
0 - bottom;
1 - left;
2 - right;
3 - top.|
|permission|integer|Type of permission level.
Possible values:
-1 - none;
2 - read only;
3 - read-write.|
|sysmapid|string|*(readonly)* ID of the map that the element belongs to.|
|urls|array|Map element URLs.
The map element URL object is [described in detail below](object#map_element_url).|
|use\_iconmap|integer|Whether icon mapping must be used for host elements.
Possible values:
0 - do not use icon mapping;
1 - *(default)* use icon mapping.|
|viewtype|integer|Host group element placing algorithm.
Possible values:
0 - *(default)* grid.|
|width|integer|Width of the fixed size host group element in pixels.
Default: 200.|
|x|integer|X-coordinates of the element in pixels.
Default: 0.|
|y|integer|Y-coordinates of the element in pixels.
Default: 0.|
[comment]: # ({/868adba3-c7b92dfc})
[comment]: # ({62e76926-305dd3e0})
#### Map element Host
The map element Host object defines one host element.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|hostid|string|Host ID|
[comment]: # ({/62e76926-305dd3e0})
[comment]: # ({95fc77e5-e1118d67})
#### Map element Host group
The map element Host group object defines one host group element.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|groupid|string|Host group ID|
[comment]: # ({/95fc77e5-e1118d67})
[comment]: # ({b9b86c4e-2d745dcc})
#### Map element Map
The map element Map object defines one map element.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmapid|string|Map ID|
[comment]: # ({/b9b86c4e-2d745dcc})
[comment]: # ({5bd3a35a-0283fd46})
#### Map element Trigger
The map element Trigger object defines one or more trigger elements.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|triggerid|string|Trigger ID|
[comment]: # ({/5bd3a35a-0283fd46})
[comment]: # ({3c7f3c29-a7495119})
#### Map element tag
The map element tag object has the following properties.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**tag**
(required)|string|Map element tag name.|
|operator|integer|Map element tag condition operator.
Possible values:
0 - *(default)* Contains;
1 - Equals;
2 - Does not contain;
3 - Does not equal;
4 - Exists;
5 - Does not exist.|
|value|string|Map element tag value.|
[comment]: # ({/3c7f3c29-a7495119})
[comment]: # ({e1f313cb-5a112b10})
#### Map element URL
The map element URL object defines a clickable link that will be
available for a specific map element. It has the following properties:
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmapelementurlid|string|*(readonly)* ID of the map element URL.|
|**name**
(required)|string|Link caption.|
|**url**
(required)|string|Link URL.|
|selementid|string|ID of the map element that the URL belongs to.|
[comment]: # ({/e1f313cb-5a112b10})
[comment]: # ({379da81c-1e44fd2a})
### Map link
The map link object defines a link between two map elements. It has the
following properties.
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|linkid|string|*(readonly)* ID of the map link.|
|**selementid1**
(required)|string|ID of the first map element linked on one end.|
|**selementid2**
(required)|string|ID of the first map element linked on the other end.|
|color|string|Line color as a hexadecimal color code.
Default: `000000`.|
|drawtype|integer|Link line draw style.
Possible values:
0 - *(default)* line;
2 - bold line;
3 - dotted line;
4 - dashed line.|
|label|string|Link label.|
|linktriggers|array|Map link triggers to use as link status indicators.
The map link trigger object is [described in detail below](object#map_link_trigger).|
|permission|integer|Type of permission level.
Possible values:
-1 - none;
2 - read only;
3 - read-write.|
|sysmapid|string|ID of the map the link belongs to.|
[comment]: # ({/379da81c-1e44fd2a})
[comment]: # ({61bc5baf-219c2bce})
#### Map link trigger
The map link trigger object defines a map link status indicator based on
the state of a trigger. It has the following properties:
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|linktriggerid|string|*(readonly)* ID of the map link trigger.|
|**triggerid**
(required)|string|ID of the trigger used as a link indicator.|
|color|string|Indicator color as a hexadecimal color code.
Default: `DD0000`.|
|drawtype|integer|Indicator draw style.
Possible values:
0 - *(default)* line;
2 - bold line;
3 - dotted line;
4 - dashed line.|
|linkid|string|ID of the map link that the link trigger belongs to.|
[comment]: # ({/61bc5baf-219c2bce})
[comment]: # ({5b3b42dc-96c2bee0})
### Map URL
The map URL object defines a clickable link that will be available for
all elements of a specific type on the map. It has the following
properties:
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmapurlid|string|*(readonly)* ID of the map URL.|
|**name**
(required)|string|Link caption.|
|**url**
(required)|string|Link URL.|
|elementtype|integer|Type of map element for which the URL will be available.
Refer to the [map element "type" property](object#map_element) for a list of supported types.
Default: 0.|
|sysmapid|string|ID of the map that the URL belongs to.|
[comment]: # ({/5b3b42dc-96c2bee0})
[comment]: # ({e4d740dd-942f03ad})
### Map user
List of map permissions based on users. It has the following properties:
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmapuserid|string|*(readonly)* ID of the map user.|
|**userid**
(required)|string|User ID.|
|**permission**
(required)|integer|Type of permission level.
Possible values:
2 - read only;
3 - read-write;|
[comment]: # ({/e4d740dd-942f03ad})
[comment]: # ({423a41e7-f6e63a8f})
### Map user group
List of map permissions based on user groups. It has the following
properties:
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmapusrgrpid|string|*(readonly)* ID of the map user group.|
|**usrgrpid**
(required)|string|User group ID.|
|**permission**
(required)|integer|Type of permission level.
Possible values:
2 - read only;
3 - read-write;|
[comment]: # ({/423a41e7-f6e63a8f})
[comment]: # ({5e96a3b7-9d0acde7})
### Map shapes
The map shape object defines a geometric shape (with or without text)
displayed on a map. It has the following properties:
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmap\_shapeid|string|*(readonly)* ID of the map shape element.|
|**type** (required)|integer|Type of map shape element.
Possible values:
0 - rectangle;
1 - ellipse.
Property is required when new shapes are created.|
|x|integer|X-coordinates of the shape in pixels.
Default: 0.|
|y|integer|Y-coordinates of the shape in pixels.
Default: 0.|
|width|integer|Width of the shape in pixels.
Default: 200.|
|height|integer|Height of the shape in pixels.
Default: 200.|
|text|string|Text of the shape.|
|font|integer|Font of the text within shape.
Possible values:
0 - Georgia, serif
1 - "Palatino Linotype", "Book Antiqua", Palatino, serif
2 - "Times New Roman", Times, serif
3 - Arial, Helvetica, sans-serif
4 - "Arial Black", Gadget, sans-serif
5 - "Comic Sans MS", cursive, sans-serif
6 - Impact, Charcoal, sans-serif
7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif
8 - Tahoma, Geneva, sans-serif
9 - "Trebuchet MS", Helvetica, sans-serif
10 - Verdana, Geneva, sans-serif
11 - "Courier New", Courier, monospace
12 - "Lucida Console", Monaco, monospace
Default: 9.|
|font\_size|integer|Font size in pixels.
Default: 11.|
|font\_color|string|Font color.
Default: '000000'.|
|text\_halign|integer|Horizontal alignment of text.
Possible values:
0 - center;
1 - left;
2 - right.
Default: 0.|
|text\_valign|integer|Vertical alignment of text.
Possible values:
0 - middle;
1 - top;
2 - bottom.
Default: 0.|
|border\_type|integer|Type of the border.
Possible values:
0 - none;
1 - `—————`;
2 - `·····`;
3 - `- - -`.
Default: 0.|
|border\_width|integer|Width of the border in pixels.
Default: 0.|
|border\_color|string|Border color.
Default: '000000'.|
|background\_color|string|Background color (fill color).
Default: `(empty)`.|
|zindex|integer|Value used to order all shapes and lines (z-index).
Default: 0.|
[comment]: # ({/5e96a3b7-9d0acde7})
[comment]: # ({8f84cf82-b1536eee})
### Map lines
The map line object defines a line displayed on a map. It has the
following properties:
|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmap\_shapeid|string|*(readonly)* ID of the map shape element.|
|x1|integer|X-coordinates of the line point 1 in pixels.
Default: 0.|
|y1|integer|Y-coordinates of the line point 1 in pixels.
Default: 0.|
|x2|integer|X-coordinates of the line point 2 in pixels.
Default: 200.|
|y2|integer|Y-coordinates of the line point 2 in pixels.
Default: 200.|
|line\_type|integer|Type of the lines.
Possible values:
0 - none;
1 - `—————`;
2 - `·····`;
3 - `- - -`.
Default: 0.|
|line\_width|integer|Width of the lines in pixels.
Default: 0.|
|line\_color|string|Line color.
Default: '000000'.|
|zindex|integer|Value used to order all shapes and lines (z-index).
Default: 0.|
[comment]: # ({/8f84cf82-b1536eee})