Go to documentation repository
Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.
Add a camera marker to a map
{ "method": "axxonsoft.bl.maps.MapService.UpdateMarkers", "data": { "changed": { "map_id": "00000000-0000-0000-0000-000000000002", "updated": { "position": { "x": 37.342491, "y": 55.684160 }, "component_name": "hosts/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0", "display_title": true, "camera_marker": { "field_of_view": { "angle": 50, "direction": { "x": 0, "y": 60000 } }, "video_frame_arrangement": { "incline": 0, "distance": 0, "angle": 0 } } } } } }
Note
- The component_name parameters specifies the path to the video camera.
A video camera can only be added to the map once. If you make another request to add a video camera, it will overwrite the previous marker.
Add a marker for transition to other map
{ "method": "axxonsoft.bl.maps.MapService.UpdateMarkers", "data": { "changed": { "map_id":"f1bf882b-7137-4542-8650-03c0eaa4411e", "updated":{ "position":{ "x":0.5, "y":0.5 }, "component_name": "transition", "display_title":true, "transition_marker": { "linked_map_id": "03e1221e-5683-4d27-b68c-79ab9201f067" } } } } }
where linked_map_id is the identifier of the map to which the transition will be made.
Create a marker to switch to immersion mode
{ "method": "axxonsoft.bl.maps.MapService.UpdateMarkers", "data": { "changed": { "map_id": "0bccf3b8-9af2-4fa1-8630-4dcc33efcea0", "updated": { "position": { "x": -0.6715789437294006, "y": -0.10830700397491455 }, "component_name": "hosts/SERVER1/DeviceIpint.105/SourceEndpoint.video:0:0", "display_title": true, "camera_marker": { "field_of_view": { "angle": 60, "direction": { "x": 0, "y": 50000 } }, "immersion": { "position": { "x": -0.07999998331069946, "y": 0.05993688106536865 }, "has_zoom": true, "zoom": 0, "links": [ { "video_point": { "x": 0.18906395137310028, "y": 0.7742998600006104 }, "video_monitor_view_point": { "x": 0.3255208432674408, "y": 0.6866456270217896 }, "map_point": { "x": -0.6673684120178223, "y": -0.663512110710144 } }, { "video_point": { "x": 0.39388322830200195, "y": 0.3756178021430969 }, "video_monitor_view_point": { "x": 0.44062501192092896, "y": 0.4321766495704651 }, "map_point": { "x": -0.6968420743942261, "y": -0.7623554468154907 } }, { "video_point": { "x": 0.5199258327484131, "y": 0.3657331168651581 }, "video_monitor_view_point": { "x": 0.5114583373069763, "y": 0.42586749792099 }, "map_point": { "x": -0.7347368001937866, "y": -0.758149266242981 } }, { "video_point": { "x": 0.7330861687660217, "y": 0.8401976823806763 }, "video_monitor_view_point": { "x": 0.6312500238418579, "y": 0.7287065982818604 }, "map_point": { "x": -0.7663158178329468, "y": -0.6445846557617188 } } ] }, "video_frame_arrangement": { "incline": 0, "distance": 0, "angle": 0 } } } } } }
where:
position—the position of the marker on the map, specified in relative coordinates.
x—X-coordinate of the marker.
y—Y-coordinate of the marker.
links—links to switch to immersion mode.
immersion—information about the immersion mode.
has_zoom—flag indicating whether the camera has zoom.
zoom—zoom level.
Display a 360 degree marker
Note
If you use a fish-eye video camera (see Configuring fisheye cameras), the marker will be converted into a projection of the image from this video camera. If the fish-eye video camera is disabled, the marker will be displayed as a circle.
{ "markers": { "hosts/SERVER1/DeviceIpint.2/SourceEndpoint.video:0:0": { "position": { "x": 0.50833332538604736, "y": 0.012499988079071045 }, "component_name": "hosts/SERVER1/DeviceIpint.2/SourceEndpoint.video:0:0", "display_title": true, "camera_marker": { "field_of_view": { "angle": 360, "direction": { "x": -7397.3251953125, "y": -16413.94921875 } }, "immersion": { "has_zoom": false, "zoom": 0, "links": [] } } } } }
where:
- position—marker position on the map. In geomaps, these are geographic latitude and longitude; in raster maps, these are coordinates from the image center.
- field_of_view—camera field of view parameters.
- angle—camera viewing angle in degrees (360 in this case).
- direction—direction of the camera view, specified by x and y coordinates.
- immersion—information about the immersion mode.
has_zoom—flag indicating whether the camera has zoom.
zoom—zoom level.