Avatar
Carlos
  • Updated

Teltonika Mapper

The Teltonika Mapper is a GpsGate tool that automates mapping of Teltonika tracker signals by displaying active AVL IDs and values, eliminating manual cross-referencing. It enables faster, error-reduced configuration by showing real-time data, allowing easy assignment of signals to variables, handling unknown Property IDs, and supporting manual additions. Auto refresh updates values live, enhancing setup confidence and efficiency.

The Teltonika Mapper is a specialized device mapping tool built exclusively for Teltonika hardware. It solves one of the most common pain points when setting up Teltonika trackers in GpsGate: having to manually look up AVL IDs, cross-reference protocol documentation, and map each incoming signal one by one.

With Teltonika Mapper, GpsGate reads the data coming directly from your Teltonika tracker and automatically lists its active Property IDs (AVL IDs) alongside the latest received values. From there, you simply assign each signal to a GpsGate variable — no guesswork, no extra documentation needed.

This makes tracker configuration significantly faster and more intuitive, especially when working with devices that report a large number of I/O elements.

Prerequisites

  • You must have administrator access to your GpsGate server.
  • The Teltonika Mapper is enabled by default on new GpsGate servers. If you are on an existing server and don't see this feature, contact GpsGate Support to have it enabled.
  • Your Teltonika tracker must already be connected and sending data to GpsGate. If you haven't set up your tracker yet, see Adding a New Tracker.

How to Use

Step 1: Open the Teltonika Mapper

Navigate to your asset window and select the asset associated with the Teltonika tracker you want to configure. Open the Teltonika Mapper panel by right-clicking and selecting the option.

Step 2: Review incoming signals

The mapper displays all the supported signals of the selected Teltonika model. For each row, you'll see:

  • Property ID — the AVL ID reported by the tracker
  • Device input — the name of the signal as defined in the Teltonika protocol (e.g., DigitalInput1, GsmSignalStrength, Speed)
  • Variable — the GpsGate variable currently assigned to that input (if any)
  • Latest value — the last received value in human-readable format
  • Raw value — the raw hex value as sent by the tracker
  • Last changed — timestamp of the last update
  • Status: 
    -Active if mapped and receiving data; 
    -Unused if no variable is assigned
    -NotIntegrated if the Property ID is not yet recognized by GpsGate

Use the search bar at the top to filter by device input name, Property ID, or variable name — useful when working with trackers that report many signals.

Step 3: Assign a variable to an input

For any row showing Active or Unused status, click the dropdown in the Variable column. A searchable list of all available GpsGate variables will appear.

Type in the search field to quickly find the variable you need, then select it. Once assigned, the row will show Active status as soon as the next data packet arrives from the tracker.

Step 4: Handle a NotIntegrated Property ID

If a row shows NotIntegrated, it means GpsGate received a Property ID from the tracker that isn't yet part of the official plugin. You can still map it manually:

  1. Click the gear icon (⚙️) in the Actions column for that row.
  2. The Edit mapping dialog will open, pre-filled with the Property ID.
  3. Select the appropriate Data type for the signal.
  4. Select the Mapped variable you want to assign it to.
  5. Click Save.

Step 5: Add a new mapping manually (optional)

If you need to add a mapping for a Property ID that isn't yet appearing in the list, click the + Custom mapping button in the top-right corner of the panel. Fill in:

  • Property ID — enter the numeric AVL ID from the Teltonika documentation for your tracker model
  • Data type — select the correct data type for the signal
  • Mapped variable — choose the GpsGate variable to assign it to

Click Save to add it to the list. This will only be implemented on the current application.

Step 6: Use Auto refresh (optional)

Toggle Auto refresh in the top-right corner of the panel to keep the Latest value and Raw value columns updating in real time. This is handy when verifying that a newly mapped signal is being received correctly

Benefits

  • Faster setup: active signals from your tracker are displayed automatically, so you don't need to reference protocol documentation to know which AVL IDs are being sent.
  • More confidence: you can see the actual latest value and raw value for each signal before mapping it, confirming the data is correct.
  • Fewer errors: searching for variables by name reduces the risk of mapping a signal to the wrong output.
  • Handles unknowns:  NotIntegrated Signals can still be mapped and used, even before official plugin support is added.
  • Real-time verification: Auto refresh lets you confirm new mappings are working without leaving the panel.

 

 

Related articles