Custom Configuration

Follow this step-by-step guide to configure your custom GPS device.


  1. You device must be able to send GPS data with HTTP GET/POST requests.

  2. Send data to the following server and with required format:

    • Hostname: updates.geolink.io
    • Port: 80
    • URL parameters: [imei] [key] [d]

      • imei - IMEI of the GSM/GPS device, must be unique number per device. Example: 312345006395040

      • key - unique key for the device. This key can be configured through GEOLINK interface and must match for the device. In case key does not match, GPS data will not be accepted. Can be omitted for the initial connections.

        For additional security, we highly recommend you use security keys for all your devices.

      • d - GPS data in the following format:

        ISO Datetime[date, time, latitude, longitude, spkm, altitude, cog, hdop, nsat]{SensorA:VALUE,SensorB:VALUE,SensorX:VALUE}

        Data example: 16/03/25,13:26:10+00[130315,13262500,48.208019,16.196690,0.19,136.10,0.00,120,6]{vbat:12.56,temp:10.34,humidity:40,wind:1.56}

        Example explained:

        • 16/03/25,13:26:10+00 - Date and time in ISO format - usually received from the modem
        • 130315 - GPS Date - ddmmyy
        • 13262500 - GPS Time - hhmmssss
        • 48.208019 - Latitude - decimal
        • 16.196690 - Longitude - decimal
        • 0.19 - Speed over ground - km/h - x.x
        • 136.10 - Altitude - x.x
        • 0.00 - Course over ground - ddd.mm
        • 120 - HDOP - x.x
        • 6 - Number of satellites - nn

        Sensors explained:

        • vbat - sensor identification name, it is advisable to use short simple names, you can set Display name later in the interface.
        • 12.56 - actual value of the sensor.

        Sensors data is optional and can be omitted.

        You can send multiple DATA lines via POST separating them by New Line character (ascii:10).

      Full examples:
      http://updates.geolink.io/index.php?imei=312345006395040& key=test&d=13/03/15,13:26:10+00[130315,13262500,48.208019,16.196690,0.19,136.10,0.00,120,6]{}
      http://updates.geolink.io/index.php?imei=312345006395040& key=test&d=13/03/15,13:26:10+00[130315,13262500,48.208019,16.196690,0.19,136.10,0.00,120,6]{vbat:12.56,temp:10.34,humidity:40,wind:1.56}

  3. Server will reply with current server ISO UTC time in the following format:

    #t:17/11/25,12:05:08+00
    #eof

    You can synchronize your device internal clock with server time if required.

  4. Once your hardware has been configured, you need to activate it for your users or yourself.

    Please note that for IMEI to be recognized during registration at least one GPS data transfer is required from the GPS device.


Once your device has been configured, simply activate it for data display.

Follow Activation Startup Guide