To access the Locator tool, it is required that:
- the Locator service should be activated in the billing plan or account properties;
- you should create or have access rights to at least one unit.
To open the tool, go to the user menu and select the Locator item.
Locator allows you to share the unit location in real time. The work with the tool consists of two parts: creating the link and viewing the units on the map after following the created link.
Viewing on the map
After following the link the activation time of which has already begun, you can see the locator map with units and geofences (if they have been indicated in the link creation settings). Gurtam Maps and, if available, Google Maps can be used as a base map on which the units are displayed. To choose a base map, point to the icon below the scaling buttons (upper left corner). You can also enable/disable displaying of geofences on the map here.
If the life span of the link is less than 48 hours, it will be shown in the upper right corner of the window.
Units
A unit is presented on the map by its icon. The unit name and movement direction arrows are shown as well (by default). You can also activate units traces (switched off by default). Click on the button in the lower right corner to enable/disable the above-mentioned settings.
After the unit has been found, you can view its latest data. The data is shown in the window that is opened by clicking on the unit. The amount of provided information depends on the unit state (moving/stationary). If it is moving (movement arrow is an indicator), then the following parameters are shown for it: speed, time of movement, its duration, and covered distance. For a unit which is not moving such parameters as speed and covered distance are irrelevant, therefore only two parameters are shown for it: the time of the start of the stationary state and its duration. Besides, regardless of the unit state the header of the opened window contains such information as the time passed from the last message and address from the last message. The unit address is determined by Gurtam Maps, irrespective of the selected base map. Note that upon receiving new messages either position of a unit on the map or its current parameters are automatically refreshed.
If it is necessary to know where the unit (units) was since the launch of the locator, you can generate and view its track. The track is displayed for a period of not more than 24 hours. To do this, click on the button in the upper right corner and select the required unit from the dropdown list. Afterwards, a track is built, and the map is scaled in order for the whole track to be displayed. If the tracks are built for several units at a time, they are shown in different colours on the map and the map itself is scaled so that they all get in the field of vision. To remove a track from the map, click on the track building button again or uncheck the boxes of the units whose tracks you want to delete. Note that in the locator the track colour is selected randomly and it does not depend on any unit settings.
The track of movements can be viewed only if a user indicates such a possibility when creating the link.
Tracking
When you create and open the first link, the option of tracking all units is activated in the locator by default, that is, the map is scaled in such a way that all units are in the visible area. To disable this option, click on the icon and cancel the selection of the item all in the drop-down list. Select one or more units if you want to track only these ones.
The tracking settings are resaved every time after you change them. When you reload the page or open the link again in the same browser, the tracking settings are the same as the last time you used the link. When you open a link which you have not used for more than two weeks, the default tracking settings are applied, that is, the tracking option is activated for all units.
Sensors
If sensor masks have been indicated when generating a link, in the left part of the window of the locator there will be a list of units with their names, the time of receiving the last message and the latest location, as well as the names of the sensors, their values and metrics. If for some sensor intervals and colours are set, the adjusted colour will be used for showing its value in the list. To find units by name, use the dynamic search above the list.
If you open the locator link on a mobile device, use the buttons and to switch between the Map and Sensors modes respectively.
Current location
Locator provides a possibility of defining your current location on the map. This is particularly helpful if you use a locator from a mobile device.
To determine your current location click on the button in the lower right corner. Afterwards, the map is scaled and centered on your location.
Due to browser restrictions, the determination of the current location is only available during the connection via the https protocol.
If a particular unit has been chosen using the monitoring tool, and then you click on the location button, both the unit and your current location get into the field of vision. However, as it was stated before, upon arrival of new messages from the unit selected in the monitoring tool, the map continues scaling and centering on it until the monitoring is disabled (select dash from the dropdown list).
Scaling
When the locator is opened, the map is automatically scaled so that all units get into the field of vision. To move around the map, drag it using the mouse.
You can scale the map by scrolling or using zoom buttons (+/-) in the upper right corner. A graduated scale located in the lower left corner helps you understand the distances on the map.
Depending on the scale used and the number of items available, some icons can overlap each other. In this case, the assembly of icons is replaced by the group icon (the number of elements is shown for every group):
- : for units;
- : for geofences.
Click on the group item to see the list of all items (icon + name).
Creating links
Links are generated and edited in the locator dialog, which is accessible through the user menu.
To create a new link, click on the New link for sharing units button and fill in the fields of the form.
Indicate the activation time for the link in the upper left corner of the dialog. It can be Now or any other moment in the future (indicate the date and time in the calendar). Note that the activation time cannot exceed 100 days.
Furthermore, enter the lifespan of the link into the corresponding field. The value can be indicated in minutes, hours, or days (select from the dropdown list). Note that you can specify any value (from 0 to 1000) or make it unlimited (enter 0).
You can enter a note for your link in the upper right corner of the window. This allows distinguishing the link in the general list. Besides, the note (if entered) is shown in the header of the page of the locator itself.
You can also check the Geofences box here to share them in the link. Moreover, you can provide the possibility of generating and viewing the track of a unit by activating the Tracks checkbox.
The user that provides the possibility to view the track of a unit must have the Request reports and messages right.
Below, you select the units whose location you want to share. The selection is made in the list on the left. Transfer the required units to the list on the right (use double clicks or the Add button).
For the convenience of choosing units or unit groups, the contents of the list can be changed using the filter above it. The following variants are available: All, Units, Unit groups, Units outside groups. To find the required unit quickly, you can also use the dynamic filter.
Sensors with their values and units of measurement can also be shown in the locator. To do this, it is necessary to enable the corresponding option and indicate the masks of the sensors to be displayed.
To generate the link, click OK. To dismiss the changes, press Cancel.
List of links
Generated links get in the corresponding list containing such information as the start and end time of its operation, how much is left before the expiration date (if the activation time has already come), the number of units, as well as whether geofences and tracks are shown on the map of the locator. When you hover the cursor over the number of units, its list is shown in the tooltip. If there is less than one hour left before the link's expiration, the corresponding line is highlighted in red.
On the right, there are the following buttons:
- : edit link parameters;
- : copy locator;
- : remove link from the list.
Click on the link to open it in a new tab. To copy the URL of a link, click on the button to the right of it.
After expiration, the link is automatically deleted.
When the user password is changed, all locator links are automatically deleted.
Integrating locator
Use the following form of code to integrate the locator into your website:
<iframe src="link_address&lang=en" width="700" height="400"></iframe>
Necessary actions:
- In the link list, click on the icon to the right of the link and copy it.
- Paste the copied link instead of link_address.
Such parameters as width and height stand for the corresponding properties of the integrated window. The Lang parameter stands for the language used.
Manipulations with link
As has been described earlier, there are 3 settings for the unit displaying (movement direction, name, 'tails'). Changing these settings the corresponding information is added to the locator's URL:
'Tail' (on/off)
&tails=1/0
Name (on/off)
&labels=1/0
Arrow (on/off)
&directs=1/0
Therefore, to save the applied settings and use them afterwards, it is necessary to utilize not the original link (created in the locator dialog), but the modified one (received when the settings of unit presentation on the map are changed).
Moreover, there is a possibility to select a map source in advance. The information on the map source is added to the locator URL. The procedure is the same for any available map, consider the example of the OpenStreetMap:
&map=OpenStreetMap
If it is necessary to display the tracks of all available units on the map, use the parameter
&build_tracks=all
In this case, the map shows the tracks rendered since the creation of the link.