[comment]: # translation:outdated

[comment]: # ({14e441a9-14e441a9})
# map.get

[comment]: # ({/14e441a9-14e441a9})

[comment]: # ({72489b9c-480bee08})
### Опис

`integer/array map.get(object parameters)`

Метода омогућава преузимање мапа према датим параметрима.

::: noteclassic
Ова метода је доступна корисницима било ког типа. Дозволе 
за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте [Корисничке
улоге](/manual/web_interface/frontend_sections/users/user_roles) 
за више информација.
:::

[comment]: # ({/72489b9c-480bee08})

[comment]: # ({06309d5b-c0fdc6dd})
### Параметри

`(object)` Параметри који дефинишу жељени излаз.

Метод подржава следеће параметре.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|sysmapids|ID/array|Враћа само мапе са датим ID-ијевима.|
|userids|ID/array|Враћа само мапе које припадају датим ID-ијевима корисника.|
|expandUrls|flag|Додаје глобалне URL-ове мапе одговарајућим елементима мапе и проширује макрое у свим URL-овима елемената мапе.|
|selectIconMap|query|Враћа својство [`iconmap`](/manual/api/reference/iconmap/object) са мапом икона која се користи на мапи.|
|selectLinks|query|Враћа својство [`links`](/manual/api/reference/map/object#Map_link) са везама мапе између елемената.|
|selectSelements|query|Враћа својство [`selements`](/manual/api/reference/map/object#map_element) са елементима мапе.|
|selectUrls|query|Враћа својство [`urls`](manual/api/reference/map/object#Map_URL) са URL адресама мапе.|
|selectUsers|query|Враћа својство [`users`](/manual/api/reference/map/object#Map_user) са корисницима са којима се мапа дели.|
|selectUserGroups|query|Враћа својство [`userGroups `](/manual/api/reference/map/object#Map_user_group) са корисничким групама са којима се мапа дели.|
|selectShapes|query|Враћа својство [`shapes`](/manual/api/reference/map/object#Map_shapes) са облицима мапе.|
|selectLines|query|Враћа [`lines`](/manual/api/reference/map/object#Map_lines) са линијама мапе.|
|sortfield|string/array|Сортирај резултат према датим особинама.<br><br>Могуће вредности: `name`, `width`, `height`.|
|countOutput|boolean|Ови параметри који су заједнички за све `get` методе и детаљно су описани у [референтном коментару](/manual/api/reference_commentary#common_get_method_parameters).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/06309d5b-c0fdc6dd})

[comment]: # ({7223bab1-7223bab1})
### Повратне вредности

`(integer/array)` Враћа било:

-    низ објеката;
-    број преузетих објеката, ако је параметар `countOutput` 
коришћен.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Примери

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({645c26fb-cb769d11})
#### Преузимање мапе

Преузми све податке мапе "3".

[Захтев](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "map.get",
    "params": {
    "output": "extend",
    "selectSelements": "extend",
    "selectLinks": "extend",
    "selectUsers": "extend",
    "selectUserGroups": "extend",
    "selectShapes": "extend",
    "selectLines": "extend",
    "sysmapids": "3"
    },
    "id": 1
}
```

Одговор:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "selements": [
                {
                    "selementid": "10",
                    "sysmapid": "3",
                    "elementtype": "4",
                    "evaltype": "0",
                    "iconid_off": "1",
                    "iconid_on": "0",
                    "label": "Zabbix server",
                    "label_location": "3",
                    "x": "11",
                    "y": "141",
                    "iconid_disabled": "0",
                    "iconid_maintenance": "0",
                    "elementsubtype": "0",
                    "areatype": "0",
                    "width": "200",
                    "height": "200",
                    "viewtype": "0",
                    "use_iconmap": "1",
                    "show_label": "-1",
                    "zindex":"0",
                    "elements": [],
                    "urls": [],
                    "tags": [
                        {
                            "tag": "service",
                            "value": "mysqld",
                            "operator": "0"
                        }
                    ]
                    },
                    {
                    "selementid": "11",
                    "sysmapid": "3",
                    "elementtype": "4",
                    "evaltype": "0",
                    "iconid_off": "1",
                    "iconid_on": "0",
                    "label": "Web server",
                    "label_location": "3",
                    "x": "211",
                    "y": "191",
                    "iconid_disabled": "0",
                    "iconid_maintenance": "0",
                    "elementsubtype": "0",
                    "areatype": "0",
                    "width": "200",
                    "height": "200",
                    "viewtype": "0",
                    "use_iconmap": "1",
                    "show_label": "0",
                    "zindex":"0",
                    "elements": [],
                    "urls": [],
                    "tags": []
                },
                {
                    "selementid": "12",
                    "sysmapid": "3",
                    "elementtype": "0",
                    "evaltype": "0",
                    "iconid_off": "185",
                    "iconid_on": "0",
                    "label": "{HOST.NAME}\r\n{HOST.CONN}",
                    "label_location": "0",
                    "x": "111",
                    "y": "61",
                    "iconid_disabled": "0",
                    "iconid_maintenance": "0",
                    "elementsubtype": "0",
                    "areatype": "0",
                    "width": "200",
                    "height": "200",
                    "viewtype": "0",
                    "use_iconmap": "0",
                    "show_label": "1",
                    "zindex":"0",
                    "elements": [
                    {
                    "hostid": "10084"
                    }
                    ],
                    urls": [],
                    "tags": []
                     }
                     ],
                     "links": [
                     {
                    "linkid": "23",
                    "sysmapid": "3",
                    "selementid1": "10",
                   "selementid2": "11",
                   "drawtype": "0",
                   "color": "00CC00",
                   "label": "",
                   "show_label": "1",
                   "indicator_type": "0",
                   "itemid": "0",
                   "linktriggers": [],
                   "thresholds": [],
                   "highlights": []
                   }
                   ],
                   "users": [
                   {
                   "sysmapuserid": "1",
                   "userid": "2",
                   "permission": "2"
                   }
                   ],
                   "userGroups": [
                   {
                   "sysmapusrgrpid": "1",
                   "usrgrpid": "7",
                   "permission": "2"
                   }
                   ],
                   "shapes":[
                   {
                   "sysmap_shapeid":"1",
                   "type":"0",
                   "x":"0",
                   "y":"0",
                  "width":"680",
                  "height":"15",
                  "text":"{MAP.NAME}",
                  "font":"9",
                 "font_size":"11",
                 "font_color":"000000",
                 "text_halign":"0",
                 "text_valign":"0",
                 "border_type":"0",
                 "border_width":"0",
                 "border_color":"000000",
                 "background_color":"",
                 "zindex":"0"
                 }
                 ],
                 "lines":[
                 {
                 "sysmap_shapeid":"2",
                 "x1": 30,
                 "y1": 10,
                "x2": 100,
                "y2": 50,
                "line_type": 1,
                "line_width": 10,
                "line_color": "009900",
                "zindex":"1"
                }
                ],
               "sysmapid": "3",
               "name": "Local network",
               "width": "400",
               "height": "400",
               "backgroundid": "0",
               "background_scale": "1",
               "label_type": "2",
               "label_location": "3",
               "show_element_label": "0",
               "show_link_label": "1",
               "highlight": "1",
               "expandproblem": "1",
               "markelements": "0",
               "show_unack": "0",
               "grid_size": "50",
               "grid_show": "1",
               "grid_align": "1",
               "label_format": "0",
               "label_type_host": "2",
               "label_type_hostgroup": "2",
               "label_type_trigger": "2",
               "label_type_map": "2",
               "label_type_image": "2",
               "label_string_host": "",
               "label_string_hostgroup": "",
               "label_string_trigger": "",
               "label_string_map": "",
               "label_string_image": "",
              "iconmapid": "0",
              "expand_macros": "0",
              "severity_min": "0",
              "userid": "1",
             "private": "1",
             "show_suppressed": "1"
              }
              ],
              "id": 1
}
```

[comment]: # ({/645c26fb-cb769d11})

[comment]: # ({4be4cd90-4be4cd90})
### Погледајте такође

-  [Мапа икона](/manual/api/reference/iconmap/object#icon_map)
-  [Елемент мапе](object#map_element)
-  [Линк мапе](object#map_link)
-  [URL мапе](object#map_url)
-  [Корисник мапе](object#map_user)
-  [Корисничка група мапе](object#map_user_group)
-  [Облици мапе](object#map_shapes)
-  [Линије мапе](object#map_lines)

[comment]: # ({/4be4cd90-4be4cd90})

[comment]: # ({d61644e7-d61644e7})
### Извор

CMap::get() у *ui/include/classes/api/services/CMap.php*.

[comment]: # ({/d61644e7-d61644e7})