18. NextGIS Tracker hub for developers

The endpoint for tracker API is track.nextgis.com.

18.1. Send location packet

To send track points to NextGIS tracker hub execute following request:

POST /ng-mobile/(string: guid)/packet

Post track points request

Parameters
  • guid – tracker identifier

Request Headers
<jsonarr

track points array

Request JSON Object
  • lt (double) – latitude of track point

  • ln (double) – longitude of track point

  • ts (int) – timestamp

  • a (double) – elevation of track point

  • s (int) – satellite count used in fix

  • ft (string) – fix type [2d, 3d …]

  • sp (double) – speed

  • ha (double) – accuracy

Status Codes

Example request:

POST /ng-mobile/971f1-ffc-0f7073/packet HTTP/1.1
Host: track.nextgis.com
Accept: */*

[
 {
     "lt": 0.000044915764204969081,
     "ln": 0.000044915764205976054,
     "ts": 1553418558,
     "a": 5,
     "s": 5,
     "ft": 3,
     "sp": 18,
     "ha": 5
 },
 {
     "lt": 0.000053898917045962894,
     "ln": 0.000053898917047171271,
     "ts": 1553418559,
     "a": 6,
     "s": 6,
     "ft": 3,
     "sp": 21.6,
     "ha": 6
 },
 {
     "lt": 0.000062882069886956708,
     "ln": 0.000062882069888366482,
     "ts": 1553418561,
     "a": 7,
     "s": 7,
     "ft": 3,
     "sp": 25.2,
     "ha": 7
 }
]

18.2. Check tracker is registered at tracker hub

To check if tracker is registered at NextGIS tracker hub execute following request:

POST /ng-mobile/(string: guid)/registered

Check if tracker is registered request

Parameters
  • guid – tracker identifier

Request Headers
Status Codes

Example request:

If registered at NextGIS tracker hub:

POST /ng-mobile/971f1-ffc-0f7073/registered HTTP/1.1
Host: track.nextgis.com
Accept: */*

{"registered": true}

If not registered at NextGIS tracker hub:

POST /ng-mobile/971f1-ffc-0f7073/registered HTTP/1.1
Host: track.nextgis.com
Accept: */*

{"registered": false}

18.3. Get track points

18.3.1. Short output 1

To get track points from NextGIS Web execute following request:

GET /tracker/tracks/short?devices_id=(int: id1),(int: id2)&date_time_from=(string: ISO timestamp)&date_time_to=(string: ISO timestamp)

Post track points request

Parameters
  • guid – tracker identifier

Request Headers
Status Codes

Example request:

 GET /tracker/tracks/short?devices_id=14,23&date_time_from=2019-04-01T10:00:00.000Z&date_time_to=2019-04-01T15:00:00.000Z HTTP/1.1
 Host: demo.nextgis.com
 Accept: */*

 {
  "14": [
      [
          {
              "lat": 52.08881305,
              "h": 146,
              "lon": 23.70545869
          },
          {
              "lat": 52.08897581,
              "h": 169,
              "lon": 23.70549827
          },
          {
              "lat": 52.08914306,
              "h": 194,
              "lon": 23.70550141
          }
      ],
      [
          {
              "lat": 52.09576269,
              "h": 194,
              "lon": 23.73853582
          },
          {
              "lat": 52.09564859,
              "h": 181,
              "lon": 23.73879119
          },
          {
              "lat": 52.09555082,
              "h": 174,
              "lon": 23.73889233
          }
      ],
      [
          {
              "lat": 52.09650613,
              "h": 160,
              "lon": 23.74376705
          },
          {
              "lat": 52.09658299,
              "h": 165,
              "lon": 23.74365873
          },
          {
              "lat": 52.09664014,
              "h": 166,
              "lon": 23.74351429
          }
      ],
      [
          {
              "lat": 52.09682634,
              "h": 151,
              "lon": 23.74517907
          },
          {
              "lat": 52.09671756,
              "h": 172,
              "lon": 23.74514079
          },
          {
              "lat": 52.09661784,
              "h": 168,
              "lon": 23.74519602
          }
      ]
  ],
  "23": []
}

18.3.2. Short output 2

To get track points from NextGIS Web execute following request:

GET /tracker/tracks/short?devices_id=(int: id1),(int: id2)&date_time_from=(string: ISO timestamp)&date_time_to=(string: ISO timestamp)&array&srs=(int: srs)

Post track points request

Parameters
  • guid – tracker identifier

Request Headers
Status Codes

Example request:

 GET /tracker/tracks/short?devices_id=14,23&date_time_from=2019-04-01T10:00:00.000Z&date_time_to=2019-04-01T15:00:00.000Z HTTP/1.1
 Host: demo.nextgis.com
 Accept: */*

 {
  "14": [
      [
          [
              3270299.2317780224,
              7596000.373302298,
              146
          ],
          [
              3270285.911302843,
              7595988.225716175,
              169
          ],
          [
              3270274.2602909105,
              7595974.103075141,
              194
          ]
      ],
      [
          [
              3267691.9639889407,
              7597017.3687444,
              160
          ],
          [
              3267692.5723902555,
              7597006.083770043,
              165
          ],
          [
              3267696.4936128575,
              7596994.903371635,
              166
          ]
      ]
  ],
  "23": []
}

18.3.3. Full output

To get track points from NextGIS Web execute following request:

GET /tracker/tracks/full?devices_id=(int: id1),(int: id2)&date_time_from=(string: ISO timestamp)&date_time_to=(string: ISO timestamp)

Post track points request

Parameters
  • guid – tracker identifier

Request Headers
Status Codes

Example request:

GET /tracker/tracks/full?devices_id=14,23&date_time_from=2019-04-01T10:00:00.000Z&date_time_to=2019-04-01T15:00:00.000Z HTTP/1.1
Host: demo.nextgis.com
Accept: */*

{
    "14": [
        [
            {
                "lat": 52.08881305,
                "h": 146,
                "lon": 23.70545869,
                "packet": {
                    "c": null,
                    "sat_gp": 11,
                    "did": 14,
                    "s": 0,
                    "t": "2019-04-01T13:05:57+00:00",
                    "sat_gl": null
                }
            },
            {
                "lat": 52.08897581,
                "h": 169,
                "lon": 23.70549827,
                "packet": {
                    "c": null,
                    "sat_gp": 16,
                    "did": 14,
                    "s": 0,
                    "t": "2019-04-01T13:05:59+00:00",
                    "sat_gl": null
                }
            },
            {
                "lat": 52.08914306,
                "h": 194,
                "lon": 23.70550141,
                "packet": {
                    "c": null,
                    "sat_gp": 16,
                    "did": 14,
                    "s": 0,
                    "t": "2019-04-01T13:06:01+00:00",
                    "sat_gl": null
                }
            }
        ],
        [
            {
                "lat": 52.09637467,
                "h": 162,
                "lon": 23.74533841,
                "packet": {
                    "c": null,
                    "sat_gp": 13,
                    "did": 14,
                    "s": 0,
                    "t": "2019-04-01T17:27:01+00:00",
                    "sat_gl": null
                }
            },
            {
                "lat": 52.09631452,
                "h": 160,
                "lon": 23.7454654,
                "packet": {
                    "c": null,
                    "sat_gp": 16,
                    "did": 14,
                    "s": 3.7439998626708983,
                    "t": "2019-04-01T17:28:07+00:00",
                    "sat_gl": null
                }
            },
            {
                "lat": 52.09634283,
                "h": 162,
                "lon": 23.74561459,
                "packet": {
                    "c": null,
                    "sat_gp": 18,
                    "did": 14,
                    "s": 3.312000060081482,
                    "t": "2019-04-01T17:28:33+00:00",
                    "sat_gl": null
                }
            }
        ]
    ],
    "23": []
}