To set up the Mapon connection, activate the connection for your organisation and link the Mapon device to the corresponding Spot in Spotilla. Activation and device linking are separate steps: an active connection does not yet mean that devices have been linked to Spots.

Prerequisites

You need Spotilla admin rights, the Mapon integration enabled for your organisation, and the API key and key name for the Mapon connection. Configure the settings in Spotilla's browser interface. The Android and iOS apps do not have functions for activating the Mapon connection or linking devices.

The Spot you want to link must be available to you and must have a tag attached with an internal Spotilla ID. Creating the Spot alone is not enough. If necessary, follow the instructions in Attaching a tag to a Spot. Also have the identifying details of the correct Mapon device ready.

Activate the Mapon connection

  1. Open Settings from the main menu in the browser interface. Select the Integrations tab and then the Integrations subtab within it.
  2. Find the Mapon row. Click the Mapon name in the Software column to open the activation form.
  3. Select Activate integration. Fill in Key name and Key value; enter the API key in the latter field. Both fields are required.
  4. Select Save on the form. In the updated integration list, check that Mapon's Integration status is In use.

If the status is already In use, proceed to linking devices. The key fields are displayed for activation, rather than as a standard editing form for an active connection.

If the Mapon row is missing, check the availability of the integration for your organisation with your Spotilla contact. Entering an API key does not replace the requirement to enable the integration for your organisation. For more information, see Prerequisites and status for activating an integration.

Link a Mapon device to the correct Spot

  1. Select Linked devices in the Actions column of the Mapon row. This opens link management; the Mapon name opens the connection activation form.
  2. Check the existing links before adding a new one. The list displays Spot, Tag, Linked Mapon device and Mapon type. You can filter the list using the search fields in the column headers.
  3. Select Link new device below the list. In the form's Select spot field, select the correct Spot.
  4. Open the list in the Select device field. Compare the Unit ID, Mapon Label, Number and Vehicle title details provided by Mapon with the details of the correct device. These fields are displayed if Mapon returns a value for them. Typing in the device search filters by Mapon Label; it does not search all the displayed fields.
  5. Select the device from the list. Its unit ID appears in the selection, and Mapon type is filled in automatically. You cannot edit the type yourself. The Spot, device and type are required.
  6. Save the link using the Link new device button on the form.
  7. Close the linked devices list and reopen it. Check the Spot name, tag, Mapon device ID and type in the reloaded data.

The Mapon device name, unique identifier and Spot name may differ. Verify the pairing before saving so that data is not associated with the wrong device. Mapon's Mapon Label and Spotilla's Tag are different pieces of information.

If the device list does not load or linking fails, check the connection status, your admin rights and the Spot's tag. If you cannot find the device by typing, clear the search and check the list. Do not select a device with the same name without comparing its identifying details. A missing Mapon type value cannot be entered manually.

Remove or change a link

If a device is taken out of use or moves to another Spot, check the current link and remove it before creating a new link.

  1. Open Mapon's Linked devices and find the correct row.
  2. Click the trash icon at the right end of that row. Confirm the deletion by selecting Yes.
  3. Close the list and reopen it. Make sure the link is also absent from the reloaded list. If necessary, clear the search fields so that a filter does not hide the row.
  4. If you are changing the pairing, create a new link to the correct Spot as described above.

The trash icon removes the link between the Mapon device and the Spot. It does not delete the Spot or deactivate the entire Mapon connection. Removing a link also does not reset previously received data or correct incorrect values.

Deactivate the entire connection

In the browser interface, all Mapon links must be removed before the connection can be deactivated. If any links remain, the activation checkbox is locked and the save button is hidden.

  1. Remove the links from the Linked devices list. Reopen the list and make sure it is empty with no search filters applied.
  2. Click the Mapon name to reopen the connection form. Clear the Activate integration checkbox and select Save.
  3. Check the integration list to make sure Mapon's status is Not in use.

Deactivating the connection affects your organisation's Mapon connection. Removing an individual link affects only that pairing.

What do the success checks tell you?

The In use status indicates that the connection has been activated. A row visible in the reloaded linked devices list confirms that the pairing has been saved. Neither alone confirms that measurement data has arrived.

Check separately what data your organisation's Mapon implementation is intended to transfer and where to verify its arrival. These settings do not let you select which measurements are transferred or how frequently synchronisation occurs. A value already visible in Spotilla does not, by itself, show that the connection has transferred new data.