Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.

Previous page Remove an interactive map  Display maps by marker name Next page

On this page:


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:

  • positionmarker position on the map. In geomaps, these are geographic latitude and longitude; in raster maps, these are coordinates from the image center.
  • field_of_viewcamera field of view parameters.
    • anglecamera viewing angle in degrees (360 in this case).
    • directiondirection 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.

  • No labels