General information

The map in Axxon One is used to visualize and manage devices at a protected facility. The following can be used as a base for the map:

• An uploaded bitmap or vector image (building plan, site map).
• Data from map providers (OpenStreetMap, Google Maps).

You can work with the map in three modes:

1. 3D mode—Map and layout are available.
2. 2D mode—Only map is available.
3. Immersion mode—Video on top of the map.

The map contains icons of cameras, inputs, outputs, macros, and ACFA devices. The field of view and the area with live video are displayed for each camera.

The map can either have one layer or have several floors (see Floors).

Map edit mode

You can create maps, add objects to them, and configure these objects in the map edit mode. To go to the edit mode:

1. Select the required layout on the layout panel (see Configuration of layouts).
2. Click the Open layout control menu button in the upper left corner of the panel.
3. Select Edit layout/map.

You switched to the edit mode.

Manage maps

Add a map

To add a map:

1. Go to the map edit mode.
2. Click the Open layout control menu button in the upper left corner of the panel.
   1. If the map isn't added to the layout, select Add new map.
   2. Or:
      1. Select Edit layout/map.
      2. Click the Map button in the lower right corner of the panel.
      3. Click the Add new map button in the lower left corner of the panel.
   3. Or:
      1. Select Edit layout/map.
      2. Click the Map button in the lower right corner of the panel.
      3. Right-click the map.
      4. In the menu that opens, select Add new map.
3. In the window that opens, specify the map settings listed in the table.
   

   Setting	Value	Description
   New Map
   Name		Enter the name of the map
   Type		Select a data source from the drop-down list. Available types are specified in the domain options (see Map providers)
   	Bitmap or vector image	Bitmap image consists of a grid of pixels, each of which has a specific color. Vector image is based on mathematical formulas and consists of lines, curves, and shapes that are defined using coordinates
   	Google Map	There are three types of Google maps available: Google Hybrid Google Maps Google Satellite
   	OpenStreetMap	Provides free access to cartographic data
   Address		The setting is available only when you select the following values in the Type setting: Google Map OpenStreetMap Enter the address, postal code, or geographic coordinates of the required area on the map and click the button. You can zoom using the zoom slider or the mouse wheel and navigate the map using the standard navigation method
   Image		Click the button and select the required file that will be used as a graphic plan of the protected facility. If you don't select any file, a map with a white background will be created. Setting requirements: The setting is available only when you select Bitmap or vector image in the Type setting. Supported formats: Bitmap image: PNG, JPG, JPEG, JPE, GIF, BMP. Vector image: SVG. The file size must not exceed 4 MB. The maximum image size is 4 million pixels (the number of pixels in a 2000x2000 resolution). The map isn't created if you select a file larger than the permitted size
   Share map		Select who has access to the map
   	Any user	The map is available to all users
   	Not shared	The map is only available to the current user
   	Roles	The map is available only to those roles that are selected in the Roles setting
   Roles		By default, the checkbox is clear, and roles are unavailable. To set the checkbox for the required role, select Roles in the Share map setting. You can create roles on the Users tab (see Role)

4. Click the Apply button. To cancel actions, click the Cancel button.
5. Click the Save button. To cancel actions, click the Cancel button.

A map is added.

Bind a map to a layout

You can bind a map and a layout. When you go to a layout, the map that is bound to it will automatically open. To bind a map to a layout:

1. Select a layout that you want to bind to a map on the layout panel or create a new layout (see Configuration of layouts).
2. Go to the map edit mode.
3. Click the Map button in the lower right corner of the panel.
4. Select the created map or create a new map (see Switch between maps, Add a map)
5. Click the Save button. To cancel actions, click the Cancel button.

The map is bound to the layout . If you save the layout with the map open in 2D mode, then when you go to this layout, the map will always open in this mode .

Change the map name

To change the map name:

1. Go to the map edit mode.
2. Left-click the corresponding tab in the lower left corner of the screen and enter a new name for the map.
3. Click the mouse anywhere on the screen.
4. Click the Save button. To cancel actions, click the Cancel button.

The map name is changed.

Change the type or image of the map

To change the type or image of the map:

1. Go to the map edit mode.
2. Right-click any place on the map and select Map properties.
3. In the window that opens, specify the map properties. This window is similar to the map creation window (see Add a map).
4. Click the Apply button. To cancel actions, click the Cancel button.
5. Click the Save button. To cancel actions, click the Cancel button.

The type or image of the map is changed.

Change the order of map tabs

By default, tabs with maps are arranged in the order they were created in the system. To change the order:

1. Go to the map edit mode.
2. Select a tab and drag it to the required position.
   
3. Click the Save button. To cancel actions, click the Cancel button.

The order of the map tabs is changed.

Change the tilt of the map surface

You can change the tilt of the map surface by changing the border of the map and layout.

There are two ways you can go to 2D map viewing mode:

1. Click the button to the right of the Map button. The layout closes, and the map is displayed full-screen. To return to 3D map viewing mode, click the Map button. To hide the map completely, click the button.
2. Click the Top view button on the control bar in the lower right corner of the screen. This keeps the layout open, and the map is displayed in the same location. To return to 3D map viewing mode, click the Top view button.
   

   If the map is hidden, the control bar in the lower right corner of the screen isn't available.

   

Change the map zoom and shift the map

You can change the map zoom and shift the map either manually or automatically.

• When an alarm occurs, the map automatically changes zoom and position to display all alarmed cameras.
• After all alarms end, the map returns to its original zoom and position.
• Automatic change of the zoom and position stops when you interact with the map or camera.
• You can also change the zoom of the map manually using the mouse wheel or the zoom bar.
  

After the map is zoomed in, you can move the map with the mouse (by pressing and holding the left mouse button) in any direction.

Switch between maps

In any mode, you can switch between maps created in the system. There are two ways to switch between them:

1. On the map panel in the lower left corner of the screen.
   
   If you created many maps, not all tabs can fit on the panel. Click the List of all maps button and select the required map in the window that opens.
   
2. Left-click a transition icon on the map if a transition was created (see Add transitions to another map). The caption of the icon indicates the name of the map to which the transition occurs: .

Show and hide the map

You can view the map from all surveillance modes except archive mode. To view a map, click the Map button in the lower right corner of the screen.

The map is displayed in a 3D mode, with the layout moving to the top of the screen and decreasing in size.

To exit map viewing mode, click the Map button again. The map also automatically hides when you zoom in on any surveillance window to its maximum size (see Scaling the Surveillance window). When you zoom out on a surveillance window to its minimum size, the map is displayed again.

Delete a map

To delete a map:

1. Go to the map edit mode.
2. Right-click anywhere on the map and select Delete map. Or click the Delete map button next to the map name.
3. Click the Save button. To cancel actions, click the Cancel button.

The map is deleted.

Add objects to the map

You can add the following types of objects to the map:

• Cameras
• Inputs (that are on)
• Outputs (that are on)
• Macros
• Transitions to other maps
• ACFA devices.

After you add objects to the map from the objects panel, when you left-click an object, a line is drawn that shows the object's location on the map. You can also use the context menu of the icons on the map to control cameras, inputs, outputs, macros, and ACFA devices.

Add cameras to the map

You can add a camera to the map in one of the following ways:

1. You can add a camera from a surveillance window:
   1. Go to the map edit mode.
   2. Click the Click to show context menu button in the surveillance window.
   3. Select Add new map in the menu.
2. You can add a camera from the objects panel by dragging:
   1. Go to the map edit mode. To delete a camera from the map, click the button.
   2. Click the Objects panel button (see Object panel).
   3. Drag the camera to the map. To delete a camera from the map, click the button.
3. You can add a camera via the context menu of the objects panel:
   1. Go to the map edit mode.
   2. Click the Objects panel button (see Object panel).
   3. Right-click the required camera and select Add to map. To add all cameras in a group/server/domain, right-click the name and select Add to map. To delete a camera or cameras in a group/server/domain from the map, click the button.

A camera or cameras in a group/server/domain are added to the map. If a camera has Latitude, Longitude, and Azimuth specified (see Camera), the camera icon is automatically positioned on the map according to the specified coordinates. If coordinates are not specified, the camera icon is automatically added to the center of the visible map area.

Cameras are added to the map. Possible states of cameras and their icons:

Interface control and configuration commands:

Add an output to the map

To add an output (see Output) to the map:

1. Go to the map edit mode.
2. Click the Objects panel button (see Object panel).
3. Drag the required output to the map. To delete an output from the map, click the  button.

An output is added to the map. Possible states of outputs and their icons:

Interface control and configuration commands:

Add an input to the map

To add an input (see Input) to the map:

1. Go to the map edit mode.
2. Click the Objects panel button (see Object panel).
3. Drag the required input to the map. To delete an input from the map, click the button.

An input is added to the map. Possible states of rinputs and their icons:

For the Tibbo board inputs (see Set up Tibbo input/output boards), the map also displays temperature and humidity values.

The appearance of the input icon depends on the camera to which it belongs.

Add a macro to the map

To add a macro (see Programming) to the map:

1. Go to the map edit mode.
2. Click the Objects panel button (see Object panel).
3. Click the Programming button in the lower left corner of the screen.
4. Drag the required macro to the map. To delete a macro from the map, click the button.

By default, the start button is displayed on the map for the Event rules macro. The enable/disable checkbox is displayed on the map for the Cycle rules macro (see Configuration of macros). To hide macros, clear the Show buttons checkbox. In this case, macros are only available via the context menu.

A macro is added to the map.

Commands to control macros and configure the interface:

You can also control macros using the Run button and the Enable checkbox. By default, macro icons don't change.

Add ACFA devices to the map

To add ACFA devices (see Documentation ACFA software package 16.0) to the map:

1. Go to the map edit mode.
2. Click the Objects panel button (see Object panel).
3. Click the ACFA devices button in the lower left corner of the screen.
4. Drag the ACFA device to the map. You can add one ACFA device to the map only once. To delete an ACFA device from the map, click the button.

You can add an ACFA device to the map as:

ACFA devices are added to the map.

Add transitions to another map

You can add a transition to another map in one of the following ways:

1. By dragging:
   1. Go to the map edit mode.
   2. Using your mouse, select the tab of the map to which you want to create a transition and drag the transition icon to the required place on the map. To delete a transition from the map, click the  button.
2. Using the context menu of the map:
   1. Go to the map edit mode.
   2. Right-click anywhere on the map.
   3. Select Add transition to map.
   4. Select a map created in the system to which you want to create a transition. To delete a transition from the map, click the button.

A transition to another map is added. 

Group objects into a cluster

When cameras have the same coordinates or are located close to each other, they are automatically grouped into a cluster.

• Each cluster is displayed on the map as a circle, with the total number of cameras in the cluster indicated in the center.
• Inputs, outputs, macros, and ACFA devices can be grouped into clusters.

When you right-click a cluster, a list of all objects included in that cluster is displayed.

When you select a specific object from the list, it is displayed next to the cluster.

When you left-click an icon of an object on the map, a context menu opens. You can use this menu to manage the object. To hide the list of objects and display them on the map, simply zoom out on the map (see Change the map zoom and shift the map).

If there are multiple clusters close to each other on the map, zooming out merges them into a new cluster. The total number of objects in all child clusters is displayed in the center of the new cluster.

When you click a merged cluster, the map is automatically zoomed in, and child clusters are displayed.

Select several cameras to display in a dynamic layout

To display cameras selected on the map in a dynamic layout:

1. Press the Ctrl key and select cameras by left-clicking the icon.
   
   
2. Click the Show layout button.

The selected cameras are displayed on a dynamic layout that is removed when you switch to another layout (see Configuration of layouts).

Delete objects from the map

To delete objects from the map:

1. Select the layout from which you want to delete the object (see Configuration of layouts).
2. Go to the map edit mode.
3. Click the Delete from map button next to the object. Or right-click the icon of an object and select Remove from map.

Objects are deleted from the map.

Personalization of the map

You can change some settings of the map in view mode using the controls in the lower right corner of the screen.

Change the icon size

To change the icon size:

1. Go to the map edit mode.
2. Use the slider to change the icon size. At the far left position, the icons are the smallest size; at the far right, the icons are the largest.
3. Click the Save button. To cancel actions, click the Cancel button.

The icon size is changed.

Configuration of cameras on the map

Configuration of a camera in a standard map view mode

After you add cameras (see Add cameras to the map) to the map:

1. Move the camera icon on the map to a place corresponding to the actual location of the device in the protected territory.
   
2. Move the camera's field of view to the required direction using the button.
3. Use the anchor points to change the camera's field of view on the map according to the actual situation in the protected territory.
4. Right-click the camera's field of view to display it.
5. In the menu that opens, select Show video.
   

   You can configure the Show video/Hide video item outside of the layout/map edit mode, and the setting remains until you restart the client.

6. Configure video area:
   
   

   To display a video area when you use a fisheye camera: In the Activate setting, select Yes. In the Camera position setting, select Ceiling (see Configuring fisheye cameras) and set the camera's field of view as a circle. Then the video will be displayed directly within the specified area. For cameras with an Immervision lens, select PTZ in the View type setting (see Configuring fisheye cameras). If a fisheye camera has a different field of view, the video display is unavailable when the camera is positioned on the ceiling.

   
   
   1. Use the dots on the video to adjust the size of the video area. To do this, left-click the dot and drag it to the required place.
   2. Use a dot to change the tilt angle of the area.
      

      When you work with the map, you can switch the video display mode to "flat" (see Personalization of the map).

The configuration of a camera in a standard map view mode is complete.

Immersion mode

Immersion mode is used to align a video from a camera with a map. In immersion mode, the video from the selected camera is displayed over the map.

• If you created connection points between a video and a map (see Configuration of a camera in immersion mode), a camera angle is selected so that the objects observed in the video and the map coincide.

• If you don't create connection points, the map is displayed in such a way that the video is located within the camera's field of view specified on the map. The field of view is directed upward.

You can switch to immersion mode in two ways:

1. Click the Move to immersion mode button in the upper right corner of the surveillance window. For the button to be displayed, in the user interface settings (see User Interface), select Inside in the Location of the control buttons in the surveillance window setting.
2. Double-click the left mouse button on the camera icon, the camera's field of view, or the video display area on the map. This method is applicable if the button isn't clicked (see Personalization of the map).
   

In immersion mode, you can only view video from one camera at a time.

To select a different camera, do one of the following:

1. Double-click the left mouse button on the camera icon, the camera's field of view, or the video display area on the map.
2. Exit immersion mode and select the required camera on the map.

To exit immersion mode, do one of the following:

1. Click the Switch to 2D-map mode  button.
2. Zoom out on the surveillance window by clicking the Zoom out the tile button.
3. Click an area of ​​the map that doesn't contain the camera's field of view.

Configuration of a camera in immersion mode

To align a video from a camera with a map, connection points are used. They connect identical objects in the video and on the map.

To configure video in immersion mode:

1. Go to the map edit mode.
2. Go to immersion mode.
3. Left-click the video image to add connection points. You must add at least six connection points. To delete a connection point, hover the cursor over it and click the button. The calibration is recalculated if you delete a point. After you add all connection points, you can adjust their positions by dragging them with the left mouse button pressed. To reset all connection points, click the Reset changes button.
   

   When you set a point on the video, the following rules must be met: All connection points must lie on the same horizontal plane. We recommend placing the points on the floor or on the ground. We don't recommend placing three points in a straight line. The points must demonstrate the perspective of the plane. When you set the sixth point, it is possible that the second connection point cannot be placed in certain locations. This happens because the system cannot determine the correct viewing angle to display the video and the map with the set connection points. Most likely, you set the connection points incorrectly.

4. If calibration is available, the Apply calibration button appears after you add a sixth point (or more), allowing you to calibrate the connection points on the map.
   
   
5. Click the Save button. To cancel actions, click the Cancel button.
   

   The specified connection points are reset if you perform any of the following actions before you save the changes and exit: If you change the place of the camera's icon on the map. If you change the angle of the display area on the map. If you change the camera's field of view on the map. After you update from previous versions to Axxon One 3.0/3.1 or higher, the connection points used to link the camera to the map are reset. You must set the connection points again.

Configuration of a camera in immersion mode is complete.

Configuration of cameras with an embedded GPS tracker

Some devices have an embedded GPS tracker that sends the current coordinates of the device to Axxon One. This feature is used for cameras installed on mobile objects—such as ambulances or public transport—enabling their position on the map to update automatically.

To configure this feature:

1. Create an embedded GPS tracker (see Configuration of detectors and their sub-detectors).
   
2. Create a map (see Add a map).
3. Add cameras to the map (see Add cameras to the map).

Configuration of cameras with an embedded GPS tracker is complete.

Floors

Floors are used to organize multi-level objects on the map and allow you to combine floor plans from different levels of a building into a single map.

Add a floor

You can add a floor in two ways:

1. Add a new floor to the map:
   1. Go to the map edit mode.
   2. Select a map to which you want to add a floor.
   3. Right-click and select Add child map.
   4. Configure the settings listed in the table.
   5. Click the Apply button. To cancel actions, click the Cancel button.
      If necessary, repeat the steps, adding a new floor to the last created floor.
      A floor is added.
      
2. Add a map as a floor:
   

   When you add floors, note the following: You can add a map as a floor only if the map doesn't have any lower-level floors of its own. In other words, the map that you want to add must not contain nested floors. You can add a floor to a map only if that map isn't a floor of another map—meaning it must not have a parent floor. If both maps are already part of different floor hierarchies, those hierarchies cannot be merged. Only a map that is not linked to another hierarchy can be added as a floor. If any of the listed conditions isn't met, the Add as child map option doesn't appear in the context menu. Maps that you can get from map providers cannot be used as floors or included in a floor hierarchy.

   
   
   1. Go to the map edit mode.
   2. Select a map you want to add as a floor.
   3. Right-click and select Add as child map.
   4. Select the map to which you want to add a map as a floor.
   5. Click the Apply button. To cancel actions, click the Cancel button.
      A map is added as a floor.
      

Adjust floor placement

To adjust floor placement:

1. Go to the map edit mode.
2. Select the required floor, left-click its image, and drag it to the required place. Both the selected floor and its child floors will move.
3. To rotate or resize the floor image, click the Change camera viewing direction  button and, while holding it down, rotate or resize the image.
4. Click the Save button. To cancel actions, click the Cancel button.

The floor placement is adjusted.

Edit a floor

When you add a floor, each new floor is added as a separate map. To edit a floor, you need to go to the tab containing its map.

The floor edit functions are similar to the map edit functions:

1. Add objects to the floor (see Add objects to the map).
2. Configuration of the display of the added cameras (see Configuration of cameras on the map).
3. Delete objects from the floor (see Delete objects from the map).
4. Change the type or image (see Change the type or image of the map).
5. Change the floor name (see Change the map name).

Delete a floor

To delete a floor:

1. Go to the map edit mode.
2. Click the  button on the tab corresponding to the floor you want to delete. Or right-click the floor image and select Delete map.

A floor is deleted.

Search on the map

On the maps from map providers (see Map providers), you can search for any geographic objects (see Search on the map by a keyword). You can also search on the map when you add a map to a layout (see Add a map). To do this:

1. Enter the name of the geographic object in the search bar.
2. Select the required option from the drop-down list.
   

The search on the map is complete. As a result, a marker indicating the requested geographic object appears on the map.

Search on the map by a keyword

A keyword allows you to limit the search area for objects and addresses on the map (see Search on the map). By default, the value of the Address setting is used (see Add a map). If you specify a country, city, street, or other geographic object as the keyword, the search is performed only within the designated area.

To change the keyword:

1. Go to the map edit mode.
2. Click the button on the lower panel.
3. Enter the necessary keywords in the window that opens.
4. Click the Apply button. To cancel actions, click the Cancel button.
5. Click the Save button. To cancel actions, click the Cancel button.

A new keyword is set.