##### ORBNET Live Maps v1.5.0 ![Map-Pin|200](<ORB Live Maps/Attachments/A blue and green pin with a white circle and a black circle Description automatically generated.png>) # Prerequisites ## Software and Licensing ### Microsoft System Requirements - Microsoft® Windows® 10 Pro and Enterprise (64 bit) - Microsoft® Windows® 10 Enterprise LTSB (Long Term Servicing Branch) 2016 (version 1607 or later) - Microsoft® Windows® 10 IoT (Internet of Things) Enterprise, version 1803 or later (64 bit), IoT Core - Microsoft® Windows® 11 Pro and Enterprise (64 bit) - Microsoft® Windows® Server 2016 (64 bit): Essentials, Standard and Datacenter - Microsoft® Windows® Server 2019 (64 bit): Essentials, Standard and Datacenter - Microsoft® Windows® Server 2022 (64 bit): Essentials, Standard and Datacenter ### Milestone XProtect System Requirements - XProtect XProtect Express+, XProtect Professional+, XProtect Expert, XProtect Corporate - [2023 R1 (23.1a) or above] - XProtect Event Server - The XProtect Event Server is included as part of your XProtect installation. **Note:** ***If this component was not installed with your XProtect product, follow XProtect installer steps to install. ### ORBNET Systems - License – **ORBNET Live Maps** - When you first install ORBNET Live Maps you will get a **30-day trial license**, following this you will need to update to a paid license, reach out to us here; [orbnetsys.com/contact](https://orbnetsys.com/contact). - For pricing or to order a license, go to the website [orbnetsys.com/LiveMaps](https://orbnetsys.com/LiveMaps) select “ORDER NOW!” - Installer Download – **ORBNET Live Maps Installers v#.#.zip** - Available to download from [orbnetsys.com/LiveMaps](https://orbnetsys.com/LiveMaps%20) once registered and signed into the website [orbnetsys.com/Register](https://orbnetsys.com/Register) - Installer – ‘ORBNET Live Maps Service Setup.msi’ - Installer – ‘ORBNET Live Maps XProtect Plugins Setup.msi’ # Software Schematic with Installation Methods ![](<ORB Live Maps/Attachments/Attachment 1.png>) # Installation of ORBNET Live Maps for XProtect ## Server Begin with the server/machine that will be used for **ORBNET Live Maps service**. For most installations this should be a dedicated server to provide the best all-round performance for the XProtect solution. - Installer - **ORBNET Live Maps Service Setup.msi**. ![[z_img/45a9b38d68ed1d6a0c5153dd83767c3f_MD5.jpeg]] New License and Credentials required shown only for new installations. Prompt to update license shown for when upgrading software. ## Client Move to the **XProtect Smart Client** machines to install the **ORBNET Live Maps** client plugin. This is required on all machines where you wish to run the **ORBNET Live Maps** client on. - Installer - **ORBNET Live Maps XProtect Plugins Setup.msi** ![[z_img/c29005880542441da4c575f2f3262627_MD5.jpeg]] If the **XProtect Smart Client** is open or running during installation you will be prompted to close this before installation can be completed. # Product License Licensing details are found from the **ORBNET Live Maps tray icon** on the server with **ORBNET Live Maps** service installed. [Right click] the tray icon and **Stop** the **ORBNET Live Maps service** before then selecting Update license… ![[z_img/d8ad540d0a1e99d44ff1ad492660b7e3_MD5.jpeg|300]] The licensing window will open and will initially show the default license values with just the trial license countdown (Default Trial Period: **30-days**). Once activated with a full perpetual license this will show **LICENSE IS VALID WITH NO TIME RESTRICTIONS**. First the **ORBNET Live Maps service** must be connected with the **Milestone XProtect** installation. See [[#Connect to XProtect Methods]] for the relevant settings that need to be updated. ![[z_img/2e85a1e47ab470ffaac1d672aad55409_MD5.jpeg]] See [[#Update license]] for further information on requesting and upgrading a license. ## Trial For first time installation there will be a **30-day** trial from completion of the **ORBNET Live Maps Service Setup.msi** installation. ## Upgrades When upgrading from a previous version of **ORBNET Live Maps** you will need to renew the product license. Please ensure you can access a license update before upgrading. > [!Note] > **ORB-Up** - From the point of sale a minimum of 1 year ORB-Up is provided. This entails the license user to product updates that are made available during the time that ORB-Up is valid. > If the ORB-Up is not renewed product updates made available after the expiry date will not be made # Configuration ## ORBENT Live Maps Manager **Start-up** After installation as default the ORBNET Live Maps Manager will automatically run and will display in the Windows tool tray. ![[z_img/fe2f295ef100a9f82a193a02ff093129_MD5.jpeg|600]] **Desktop Shortcut** ![[z_img/37134b50cdbe27a3270cd088e9f54395_MD5.jpeg]] **Default Location:** `C:\Program Files\ORBNET\ORBNET Live Maps\ORBNET Live Maps Service Controller\` **Tool Tray Icon** ![[z_img/b5ea323d1cd51c4d44cc2c08db19967f_MD5.jpeg]] The majority of **ORBNET Live Maps** system settings are changed from the system tray icon. If you cannot see this check for hidden programs. **Menu** ![[z_img/a208611fbd772f8f09b424eaf57c1c8b_MD5.jpeg]] ### Start and Stop Service ORBNET Live Maps service control can be found from the ORBNET Live Maps tray icon on the server with ORBNET Live Maps service installed. [Right-click] the tray icon and use [Start] or [Stop] to change the service state. - When started, Start will show greyed, and Stop will be available to click. - When Stopped, Stop will show greyed, and Start will be available to click. ![[z_img/87563361ebaa5f7e6b5a75293c4430ed_MD5.jpeg]] When you hover over the **ORBNET Live Maps system tray icon** this will also show the service state as [Running] (Started) or [Stopped]. **Started** ![[z_img/85df6c3fa37ae158ef52d5283aaf9d39_MD5.jpeg|300]] **Stopped** ![[z_img/3e822b46806d7b90b11a8aafd27b3eea_MD5.jpeg|300]] ### View Logs System logs will be generated by the **ORBNET Live Maps service** and assist the installer with setup and troubleshooting. ![[z_img/d7be49167f5b0ae24a29694f5329aeb0_MD5.jpeg]] ![[z_img/93ecc6d411539ef1b909ccf5aa62ab0a_MD5.jpeg]] **Action Buttons:** - [Open Folder] Opens folder containing log files. - [Open File] Opens current log file in notepad or default .log file application. - [Freeze] Stops live feed of logs, useful if you need to catch a log entry. - [Clear (no-loss)] Clears the log window so new log entries show on top. No loss to log file. ### Integrations **ORBNET Live Maps** Integrations can be found from the **ORBNET Live Maps tray icon** on the server with **ORBNET Live Maps service installed**. [Right-click] the tray icon and [Stop] the **ORBNET Live Maps service** before then selecting [Integrations] ![[z_img/d55ab0a4c54fbdeaa7b3d65966a433f3_MD5.jpeg]] [Tick] **Enable integrations** to see more options. ![[z_img/77f4c1c4405aa853b983bf7ae27c358e_MD5.jpeg]] Once enabled Integration options will show in the dropdown menu with the relevant settings for that system. ![[z_img/c22223705454f879ceb8d1fe7eba6d71_MD5.jpeg]] #### TRBOnet TRBOnet provides advanced communication and dispatch solutions tailored for MOTOTRBO radio networks. Their offerings include software like TRBOnet Enterprise and TRBOnet PLUS, which facilitate efficient control room operations and enhance emergency response capabilities. Additionally, they offer hardware solutions such as the Swift IP Gateway series, which connects various radio systems, and mobile applications like the PTT Mobile App that extend radio functionalities to smartphones. TRBOnet is recognized for its innovative products, continuously updating its software to include features like video calling and enhanced monitoring tools ORBNET Live Maps enables radio locations to be pinpointed on the map using the live GPS locations. ### Change Settings **ORBNET Live Maps** settings can be found from the **ORBNET Live Maps tray icon** on the server with **ORBNET Live Maps service installed**. [Right-click] the tray icon and [Stop] the **ORBNET Live Maps service** before then selecting [Change settings…]. ![[z_img/079555d52d0fd7913f0edf5cee00248e_MD5.jpeg]] This window will open to allow settings to be changed. ![[z_img/26d0903aba14e3d72b4b2367f38b1e24_MD5.jpeg]] #### Save Config After changing settings use [Close] in the top right of **ORBNET Live Maps Settings**. ![[z_img/b6fcc7ca44b0842bec08af06433e2ab6_MD5.jpeg]] Config will show as saved. Press [OK]. ![[z_img/54b6923d1d7ee6effed056acd321e6f5_MD5.jpeg|400]] #### **ORBNETMapsConfiguration** #### API Settings - **API Authentication Mechanism** - [None]: No Authentication - [Basic]: use Basic Authentication (not safe unless using HTTPS) - [Digest]: Use Digest Authentication (Safer than Basic) - [JSON Web Token]: Enables JWT security (Safest option). A public key must be added to - **API Port** - [45656] (Default) - Select the TCP port that the RESTful API will use for HTTP - **API Secure Port** - [45657] (Default) - Select the TCP port that the RESTful API will use for HTTPS (requires certificates) #### Demo Demo examples from public available API datasets. [Tick] to enable. - **Alameda-Contra Costa Transport** AC Transit is the main bus transit operator in the East Bay region of the San Francisco Bay Area, California. AC Transit is the third largest bus operator in California, serving the western portions of Alameda and Contra Costa counties, with a fleet of over 600 buses operating 130 routes. ![[z_img/61faedd42ac5a6745381c57cfab83635_MD5.jpeg|500]] - **Finland Rail Traffic** The Finnish railway network consists of a total track length of 9,216 km (5,727 mi). Railways in Finland are built with a broad 1,524 mm (5 ft) track gauge, of which 3,249 km (2,019 mi) is electrified. Passenger trains are operated by the state-owned enterprise VR that runs services on 7,225 km (4,489 mi) of track. These services cover all major cities and many rural areas. ![[z_img/61b40b02accc3093b3dc7c49ab3eae49_MD5.jpeg|500]] - **Helsinki Transport** Helsinki's public transportation network, managed by HSL (Helsinki Regional Transport Authority), offers a comprehensive system for getting around the city and surrounding area. This includes buses, trams, metro, commuter trains, and even ferries. ![[z_img/7f3b40a76fae89de2db7f045eb8c40c5_MD5.jpeg|500]] #### ORBNET Live Maps Settings - **Database Path** - Default location: `C:\ProgramData\ORBNET\ORBNET Live Maps\Service\Database` - The file path where the ORBNET Live Maps databases are located. A network attached storage can be specified. - **Disable metadata position recording** (Default: Unticked - Enabled) - Disables recording new positions from the camera metadata channel and saving them to the database - **Disable position recording** (Default: Unticked - Enabled) - Disables recording new positions from all sources and saving them to the database - **Disable tile concurrent HTTP requests** (Default: Unticked - Enabled) - Disables sending concurrent HTTP requests for tile loading, potentially reducing server load or avoiding rate limits. - **Hostname** - The Hostname of this Server - **Log Level** (Dropdown, Normal (Default)) - [Normal], Trace, Debug - **Log Statistics Every (seconds)** (Default: 60) - The ORBNET Maps statistics will be logged every x seconds. - **Object Retention Time (Days)** (Default: 7) - The retention time for all objects stored in the database in days. - **Tile Acquisition** (Default: Online) Select if the tiles will be requested from the tile provider server or the local one. - Online - Offline - **Tile Provider** (Default: Thunderforest) Select the provider for the maps. - [Mapbox] - [Maptiler] - [Stadiamaps] - [Thunderforest] - [BingMaps] - **Tile Provider API Key** (Entry required to enable Tile Provider) Set the API Key for the chosen provider. #### XProtect Connection Settings See [[#Connect to XProtect Methods]] for the relevant settings that need to be updated to connect to XProtect. - **Connect to XProtect** (Default: Ticked) Connect and start XProtect MIP SDK. - **Secure Only** (Default: Unticked) Force a secure connection to XProtect (requires certificates). Used when HTTPS is enabled in XProtect. - **XProtect License** Software licence code from the XProtect Management Client. - **XProtect Login Method** (Default: ServiceAccount) - [ServiceAccount:] Use the service account the ORBNET Live Maps is running as to login to the XProtect Management Server. - [BasicUser:] Use XProtect Basic user credentials to login to the XProtect Management Sewer. - [WindowsUser:] Use Windows user credentials to login to the XProtect Management Server. - **XProtect Management Server IP** (Default: 127.0.0.7:80) Enter the IP address of the XProtect Management Server. - **XProtect Product Type** Automatically added once connected to XProtect. - **XProtect Server lD** Automatically added, Unique lD from the XProtect License). ### Password Manager **ORBNET Live Maps Password Manager** can be found from the **ORBNET Live Maps tray icon** on the server with **ORBNET Live Maps service** installed. [Right-click] the tray icon and [Stop] the **ORBNET Live Maps service** before then selecting [Manage passwords…]. ![[z_img/67c039635412c51dde9e70eec2d3321e_MD5.jpeg]] - **Basic User for Service Login** - Enter the **XProtect Basic User** used for connection to **XProtect Management Server**. *Required for connection to XProtect* - **Basic Users** - Accounts can be created to be used for the **ORBNET Live Maps API** ![A screenshot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screenshot of a computer Description automatically generated 14.png>) Once account details are added or edited, close this window and the details will be saved. [Start] the **ORBNET Live Maps service** from the system tray icon. ### Update license Licensing details are found from the **ORBNET Live Maps tray icon** on the server with **ORBNET Live Maps** service installed. [Right click] the tray icon and **Stop** the **ORBNET Live Maps service** before then selecting Update license… ![[z_img/d8ad540d0a1e99d44ff1ad492660b7e3_MD5.jpeg]] The licensing window will open and will initially show the default license values with just the trial license countdown (Default Trial Period: **30-days**). Once activated with a full perpetual license this will show **LICENSE IS VALID WITH NO TIME RESTRICTIONS**. #### License Request When making a license request, please complete the fields in bold. - [Client Name] - [MAX Numbers of Smart Clients] - [Max Number of tracked objects] - [Max Number of static objects] **Smart Client** – Refers to each connected XProtect Smart Client application registered for use with the licensed product. A pool of connection license channels are used on a first come first basis for any XProtect Smart Client, with the ORBNET Live Maps plugin installed. The list can be manually updated clients revoked access to free a license channel. **Tracked Objects** – Refers to live objects used within ORBNET Live Maps system. A connected GPS device, API tracked device or Milestone device that provides live tracking information, i.e. camera with GPS metadata or XProtect Mobile push client providing location data. **Static Object** – Refers to objects set with a manual location position. These would be fixed objects like, cameras that are physically fitted in a set location. The position is either set manually in Milestone device settings. Or and object added to the ORBNET Live Maps database with a static object tag. Use the [Export] license request button to generate a license request file. This must be included in an email to ORBNET Systems ([[email protected]](mailto:[email protected])) when requesting your license. On completion a valid license will be sent back. This can be imported by using the [Import] valid license button. This will now show an unlimited timeframe associated to ORBNET Live Maps with the requested number of XProtect Smart Clients and Objects. ![[z_img/5e5741ec2066839f74ac941823920c24_MD5.jpeg]] ## Connect to XProtect Methods **ORBNET Live Maps service** must be connected with the **Milestone XProtect** installation with one of the following account types. This will enable the service and allow the license to be linked to the XProtect system. - [BasicUser:] Use XProtect Basic user credentials to login to the XProtect Management Sewer. - [ServiceAccount:] Use the service account the ORBNET Live Maps is running as to login to the XProtect Management Server. - [WindowsUser:] Use Windows user credentials to login to the XProtect Management Server. The connection URL will also need to be updated, please see [[#XProtect Connection Settings]] under the [[#Change Settings]] section. ### XProtect Basic To use a XProtect Basic user account as the ORBNET Live Maps Service login. Start by creating a new Basic User Account within the XProtect Management Client. Site Navigation > Security > Basic User. ![[z_img/bef0e25a43c3333e3fd0d7a899fae633_MD5.jpeg]] Add a Username of your choosing plus a complex password for the account and ensure that the Status is set to Enabled and Force Basic User to change password on next login is unticked. > [!Note] >Adding the password to the description can be useful for administration, however, offers a lower level of security on larger systems. > ![A screenshot of a computer Description automatically generated|450](<ORB Live Maps/Attachments/A screenshot of a computer Description automatically generated 16.png>) Add this new Basic User account to a role, Site Navigation > Security > Roles. ![[z_img/bef0e25a43c3333e3fd0d7a899fae633_MD5.jpeg]] Select Users and Groups. We recommend the Administrators Role, however depending on the site configuration may require a customized role. This being the case, provide a role with access to all components that are required to be visible in ORBNET Live Maps. Select [Add..], [Basic User], find the relevant account and tick to add to the Role. ![A screenshot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screenshot of a computer Description automatically generated 17.png>) **ORBNET Live Maps** settings can be found from the **ORBNET Live Maps tray icon** on the server with **ORBNET Live Maps service installed**. [Right-click] the tray icon and [Stop] the **ORBNET Live Maps service** before then selecting [Change settings…]. ![[z_img/3ee9fa16f24803de3beb75c07d36645f_MD5.jpeg|300]] **Milestone Connection Settings** - Connect to XProtect - Tick [Enabled] (Default) required for operation. Connect and start XProtect MIP SDK / API. - Management Login Method - Select [BasicUser] Uses XProtect Basic User credentials to login to the XProtect Management Server. ![[z_img/114a1b9d08bf405bce2d93e2600c3f4a_MD5.jpeg]] **ORBNET Live Maps Password Manager** can be found from the **ORBNET Live Maps tray icon** by selecting [Manage passwords…]. ![[z_img/57e828cf65e64fbd3f3652fdb6a3595d_MD5.jpeg|300]] - Basic User for Service Login Enter the [XProtect Basic User] used for connection to **XProtect Management Server**. ![[z_img/d1210ae029967c598457e2dda2697079_MD5.jpeg]] Once account details are added or edited, close this window and the details will be saved. [Start ]the ORBNET Live Maps service from the system tray icon. Check the logs ([[#View Logs]]) to see that the **XProtect systems** is connected with ORBNET Live Maps and has a valid license, full or trial. ![[z_img/ba6d5b029bdf21ae5a02c7932ccd1e06_MD5.jpeg]] ### Windows Account To use a Windows Account user in XProtect, ensure the account is added to a [Role] from the **XProtect Management Client**. [Site Navigation] > [Security] > [Roles]. ![[z_img/bef0e25a43c3333e3fd0d7a899fae633_MD5.jpeg]] Select [Users & Groups] check this account is included in the Administrators role. To add an account, select [Add..] then [Windows user]. Find the relevant user from the domain or workgroup. Use [Check Names] to verify the user and domain is correct then press [OK]. ![A screenshot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screenshot of a computer Description automatically generated 23.png>) **ORBNET Live Maps settings** can be found from the **ORBNET Live Maps tray icon** on the server with ORBNET Live Maps service installed. [Right-click] the tray icon and Stop the **ORBNET Live Maps service** before then selecting [Change settings…] ![[z_img/c2cd21fc5497cfb03556485d1320b2ca_MD5.jpeg|300]] - **Milestone Connection Settings** Connect to Milestone - [Tick] Enabled (Default) required for operation. Connect and start XProtect SDK. Management Login Method - Select [WindowsAccount] Uses the service account the ORBNET Live Maps is running as to login to the Milestone Management Server. ![[z_img/6f26a9b3427d81ec7002db15a8d44ea6_MD5.jpeg]] Select from the **ORBNET Live Maps tray icon** [Manage passwords...]. ![[z_img/960a60e124297b296c547c78148dff64_MD5.jpeg|300]] Update the [Basic or Windows User] and [Password] field. For a Windows User, include the **Domain**, **Workgroup** or **Computer Hostname** with a `\` before the Username. ![[z_img/a7366ac4e3a82a9cc4cff829bcaee734_MD5.jpeg]] Once the user credentials are edited, close this window and the details will be saved. [Start] the **ORBNET Live Maps service** from the system tray icon. Check the logs ([[#View Logs]]) to see that the **XProtect systems** is connected with ORBNET Live Maps and has a valid license, full or trial. ![[z_img/ba6d5b029bdf21ae5a02c7932ccd1e06_MD5.jpeg]] ### Service Account Where **XProtect** uses an Active Directory Service Account or shared Workgroup Service Account, **ORBNET Live Maps** is also able to use this method. In **Windows Services** you will see that the **XProtect services** use Windows account to Log On instead of the default Network Service account XProtect will install with as default. Open `Windows` > `Services` and find the **Milestone XProtect** related services, the **Log On As** column will display a Windows account instead of Network Service. Generally, this will be formed `<DOMAIN\USER>` (in this example .\Milestone) ![A screen shot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screen shot of a computer Description automatically generated 1.png>) Find the **ORBNET Live Maps service**, [Right-click] and select [Properties]. ![A screenshot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screenshot of a computer Description automatically generated 22.png>) ![](<ORB Live Maps/Attachments/Attachment 3.png>) Select the [Log On] tab and select the This account, field and update **NETWORK SERVICE** to the same service account used for XProtect. [Add] the [Password], [Confirm Password] and finally press [Apply], acknowledge the prompt, and press [OK]. ![A screenshot of a computer login Description automatically generated|600](<ORB Live Maps/Attachments/A screenshot of a computer login Description automatically generated.png>) To use a Service Account user in XProtect, ensure the account is added to a [Role] from the **XProtect Management Client**. [Site Navigation] > [Security] > [Roles]. ![[z_img/bef0e25a43c3333e3fd0d7a899fae633_MD5.jpeg]] Select Users & Groups check this account is included in the Administrators role. To add an account, select Add.. then Windows user. Find the relevant user from the domain or workgroup. Use Check Names to verify the user and domain is correct then press OK. ![A screenshot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screenshot of a computer Description automatically generated 23.png>) **ORBNET Live Maps settings** can be found from the **ORBNET Live Maps tray icon** on the server with ORBNET Live Maps service installed. [Right-click] the tray icon and Stop the **ORBNET Live Maps service** before then selecting [Change settings…] ![[z_img/c2cd21fc5497cfb03556485d1320b2ca_MD5.jpeg|300]] - **Milestone Connection Settings** - Connect to Milestone - Tick Enabled (Default) required for operation. Connect and start Milestone SDK. - Management Login Method - Select ServiceAccount: Uses the service account the ORBNET Live Maps is running as to login to the Milestone Management Server. ![A screenshot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screenshot of a computer Description automatically generated 25.png>) Once the Login Method is edited, close this window and the details will be saved. [Start] the **ORBNET Live Maps service** from the system tray icon. Check the logs ([[#View Logs]]) to see that the **XProtect systems** is connected with ORBNET Live Maps and has a valid license, full or trial. ![[z_img/ba6d5b029bdf21ae5a02c7932ccd1e06_MD5.jpeg]] # XProtect Smart Client ## ORBNET Live Maps Plugin With **ORBNET Live Maps Plugin** installed, Open the **XProtect Smart Client** and go into [Setup] Mode. Under System Overview [ORBNET Plugins] you will find [ORBNET MAPS]. Creating a new [View 4:3 (1x1)] view is recommended. Then drag and drop the **ORBNET Live Maps plugin** this into a blank tile. ![[z_img/175c03cdde15d27c2351a54007a3f6a2_MD5.jpeg]] When the **ORBNET Live Maps plugin** first loads the screen will display a **Made with Unity** splash screen. ![[z_img/ba77ae736168586b3a06d140122854cc_MD5.jpeg]] Exit [Setup] to return to live operation mode in the XProtect Smart Client. Once the Unity splash screen has finished loading ORBNET Live Maps will now display from the default set location. ![[z_img/720aeac5f419c1e85081fc24cf5ebf28_MD5.jpeg]] # User Interface The ORBNET Live Maps user interface comprises of control buttons on the top and side panels. These control what and how objects and layers are shown within the map interface window. ![[z_img/8779b166acdf401d25eba089c1bbbbfa_MD5.jpeg]] ![[z_img/a500ae75b94fdf3aba22b7316f652d28_MD5.jpeg]] ## System Objects [Click] to open a side panel that shows **System Objects**. From this side panel these options are available. ![[z_img/c8a68568bed2c7bf0b3f3c5d0fd03e27_MD5.jpeg|125]] 1. **Cameras** - These are XProtect cameras shown in XProtect camera groups 2. **Live Objects** - These are objects added to the ORBNET Live Maps database 3. **Views** - XProtect Smart Client views list 4. **Inputs** - Available Inputs from XProtect 5. **Outputs** - Available Outputs from ![[z_img/c94cf0b9ac2082134e6c660f310239a2_MD5.jpeg]] ### Cameras These objects are devices already configured within the XProtect system and connected to a **XProtect Recording Server** with a video stream channel. As default these will be characterized with one of the below icons. ![[z_img/e26babafd53d6e0f8269cf1f72916978_MD5.jpeg]] To enable these camera devices to show on the map in **ORBNET Live Maps**, add the `GPS coordinates` to the camera information in the **XProtect Management Client**. Cameras set with a valid location will display automatically on the map. ![[z_img/0eca5fba8eb6451efd479ad8957d51fa_MD5.jpeg|500]] Camera objects generate states in XProtect, and can be used to display additional information, floating on the bottom right corner of an object. ![A screen shot of a phone Description automatically generated](<ORB Live Maps/Attachments/A screen shot of a phone Description automatically generated.png>) - Example shows a Body Camera in an offline state. Alarm States As well as the above states ORBNET Live Maps is also able to receive alarm states from XProtect. Wherever an XProtect Alarm Definition is created and with an associated camera or device these will display a triggered alarm state on the object icon. ![A screen shot of a computer Description automatically generated](<ORB Live Maps/Attachments/A screen shot of a computer Description automatically generated 2.png>) The camera object on the map will display a flashing red circle. In the object list the camera name text will show in red when in an alarm state. ![Graphical user interface, text, application, chat or text message Description automatically generated](<ORB Live Maps/Attachments/Graphical user interface text application chat or text message Description automatically generated.png>) ## Map Styles From the top right panel, Map Styles can be selected. As default there are three options. All these options use a tile server to provide the map image in a grid form. At different zoom levels new map images are provided. Map tiles are downloaded a stored locally, this makes the map load quicker. Changing Map Style will require new tiles to be downloaded so may be slow to load first time around. ![[z_img/267be00370de481a296977cb291b5ac3_MD5.jpeg]] ### Examples (Thunderforest) #### Dark ![[z_img/f3ef3b1bef1284930886d27b71722a56_MD5.jpeg]] #### Basic ![[z_img/fbc67436eab829db5bd0dd9a7d84157d_MD5.jpeg]] #### Satellite ![[z_img/da1444a70920e32610d2073d9714aced_MD5.jpeg]] ## Object Objects can be both **Static** and **Tracked** (GPS). These show with a icon (Default: [Camera]) and the device name. ![[z_img/8982a982007c41a27e96e329bfe7b489_MD5.jpeg]] ### Right-click menu. - **Current location** (Display: 4 decimal places) (Copy: Up to 13 decimal places ) - **Set as Home position** - This updates the pre-set Home position, for when the client is closed and reopened. This includes the current zoom level. - **Popup Camera** - Opens the selected camera device in a new floating window. - **Acknowledge Alarm** - Use to clear an alarm for the selected device. - **Settings** - - **Follow object** - Moves the map to keep the object in middle of the view. - **Start measuring distance** - Line will display with a measurement. ![[z_img/589801d9f63c79bf251e8086ce2efe3d_MD5.jpeg]] #### Current location Right-click to show the current object location. Latitude and Longitude will display with a 4 decimal places. [Click] to copy, depending on the object and the accuracy will change the number of decimal places that will be copied. - **Example:** (50.7728145232495, -1.9553399163083) ![[z_img/9b4580a663c0b785c8a10c23019ed012_MD5.jpeg]] #### +Set as Home position ++++++++++++++++ #### Popup Camera Right-click and select [Pop-up Camera] Opens the selected camera device in a new floating window. ![[z_img/e147dcd973d2ca864a86a78785909400_MD5.jpeg]] #### +Acknowledge Alarm ORBNET Live Maps is also able to receive alarm states from XProtect. Wherever an XProtect Alarm Definition is created and with an associated camera or device these will display a triggered alarm state on the object icon. The camera object on the map will display a flashing red circle. ![[z_img/73331f0a3c3f46c1d57a2da0960ac0a3_MD5.jpeg|250]] Right click the object and click [Acknowledge Alarm] to clear the alarm from display and remove from the XProtect alarm stack. +++ In the object list the camera name text will show in red when in an alarm state. ![[z_img/6e2c0c570b23f451312db8fb4d28474a_MD5.jpeg]] #### +Settings ++++++++++++++++ #### +Follow object +++++++++++++++++ #### +Start measuring distance +++++++++++++++++ ## Location Search In the left navigation panel find [MIP plug-ins], below **Incidents** you will find **ORBNET Live Maps Location Search**. - **Search:** Text input field - **Country Selection:** Dropdown menu to select the country you want to search, ![[z_img/d6b0704670c654cd9bf8f6875534ee2c_MD5.jpeg|300]] [Select] the option you want to use, then press [Go to]. ![[z_img/0188640a3539d445966dd0693dc4718f_MD5.jpeg|600]] The Map will move to the selected location. ![[z_img/92e8b989320a9ad86afd1a6e54c4e8ef_MD5.jpeg|600]] # Setup ## +Object Settings - Views - Inputs - Outputs - Commands - Cameras ## +Pin Setup # Copyright, trademarks, and disclaimer **Copyright © 2025 ORBNET Systems** - Copyright law and international treaties protect this Software. - Licensing agreements specify the terms and conditions of the Software use. - Neither the Customer nor any third party will be permitted to inspect, possess, use, copy, or attempt to discover any part of the Software source code (or any portion thereof). **Trademarks** - XProtect is a registered trademark of Milestone Systems A/S. - Milestone XProtect and connected components will be referred to as XProtect throughout this document. - Unity is a registered trademark of Unity Technologies, San Francisco. - This document contains other trademarks which belong to their respective owners. **Disclaimer** - In preparing this text, due care has been taken to ensure that it is intended for general information purposes only. - Information provided herein does not constitute any kind of warranty, and any risk resulting from its use rests with the recipient. - Adjustments may be made without prior notification by ORBNET Systems. - In this text, all names and organizations referenced in examples are fictitious.