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:

  • 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.

  • No labels