# HTTP tracker

To utilize 3rd-party sources of geographic coordinates, such as 

* your GPS tracker backend that works as a gateway,
* a public source of geo data like a public transportation network, or a naval positioning system, 
* built-in GPS in camera systems during TV productions. 

Instead of connecting a physical device, you create a virtual tracker that receives location updates through an HTTP endpoint.

### Create an HTTP tracker

* Go to the [tracker management](https://racemap.com/admin/trackers) and click "+ Add Tracker".  
* This opens a modal, select "HTTP GPS Tracker" as tracker type.  
* The unique tracker ID is generated automatically, provide a device name.  
* Confirm with "Add Tracker" and the new HTTP tracker is created 
* The new HTTP tracker is shown in the device list of your tracker management. 

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FyzTqYyLp1gKBts0czrvi%2Fgrafik.png?alt=media&#x26;token=fd6e3bd3-b503-4f76-af5c-60e060894941" alt=""><figcaption></figcaption></figure>

### Send locations to the HTTP tracker

Send messages to the specific endpoint of the HTTP tracker.&#x20;

```
POST /api/trackers/:id/points
```

{% hint style="warning" %}
Copy the required `id` for the endpoint in the tracker management, info tab. \
`id` **is not** the generated tracker id!&#x20;

<img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FmnHMjAY3EtiDW7QbWb8f%2Fgrafik.png?alt=media&#x26;token=f712283c-e992-4bb2-90d0-95839c61b1c8" alt="" data-size="original">
{% endhint %}

Sample request in the terminal:

```
curl -X POST \
  --url https://racemap.com/api/trackers/69b12d04a440a83c52a9ee8c/points \
  --header 'authorization: Bearer {{API_TOKEN}}' \
  --header 'content-type: application/json' \
  --data '[{ "lng": 13.74179, "lat": 51.05471, "time": "2026-03-11T09:15:00Z" }]'
```

{% hint style="info" %}
Only authorized users can direct to the endpoint. \
[Create your authentication with an API token.](https://docs.racemap.com/api/authentication)
{% endhint %}

When directing valid and current coordinates, the HTTP tracker updates its location on the map and APIs.

#### Parameters

<table data-full-width="false"><thead><tr><th width="188">Field</th><th width="311">Description</th><th width="294">Sample</th><th data-hidden></th></tr></thead><tbody><tr><td><code>lng</code></td><td>Longitude in degree</td><td><code>13.74179</code></td><td></td></tr><tr><td><code>lat</code></td><td>Latitude in degree</td><td><code>51.05471</code></td><td></td></tr><tr><td><code>time</code></td><td>Timestamp of the coordinate, UTC</td><td><code>"2022-01-24T23:00:00.000Z"</code></td><td></td></tr><tr><td><code>elv</code></td><td>Elevation in meter, optional</td><td><code>445</code></td><td></td></tr></tbody></table>