... | ... | @@ -54,49 +54,50 @@ Information about the ***endpoint***: |
|
|
- _If the beacon is on the lead vehicle, the value of the field **beaconTypeId** will be 1= Start._
|
|
|
- _If the beacon is on the trailing vehicle, the value of the field **beaconTypeId** will be 2= End._
|
|
|
|
|
|
#### Update of the static information of the progress of a sporting event
|
|
|
### Update of the static information of the progress of a sporting event
|
|
|
|
|
|
The event is the main part of this data ingestion API. With this event you can update the dynamic information of the sporting event. With it, the information **received by the V2 signals** of the escort cars located at the head and tail of the event will be updated. The **static** information can be differentiated, the following body will be sent, which unlike the dynamic **does not contain the beaconEnd** field.
|
|
|
The event is the main part of this data ingestion API. With this event you can update the dynamic information of the sporting event. With it, the information **received by the V2 signals** will be updated as the event is completed. The information will be delivered with the following fields in the following format:
|
|
|
|
|
|
Information about the ***endpoint***:
|
|
|
|
|
|
- Method: POST
|
|
|
|
|
|
- URL: {baseUrl}/v1/tracking/event
|
|
|
|
|
|
- Updates the static information data of a sports plan
|
|
|
- Body:
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"actionId": "1",
|
|
|
"timestamp": "2000-12-12T15:00:00",
|
|
|
"hdop": "",
|
|
|
"speed": "",
|
|
|
"beaconStart": {
|
|
|
"beaconId": "1",
|
|
|
"lon": "-8.103828007999937",
|
|
|
"lat": "42.437257490000036"
|
|
|
}
|
|
|
}
|
|
|
```
|
|
|
|
|
|
**\* = Required field**
|
|
|
```json
|
|
|
{
|
|
|
"actionId": "CLI_235",
|
|
|
"beaconId": "cff92179-dc0a-47da-bd9e-5e9c5b14d251",
|
|
|
"beaconTypeId": 4,
|
|
|
"timestamp": "2021-03-15T13:34:00.000Z",
|
|
|
"lon" : "-7.009654361999935",
|
|
|
"lat" : "38.52736428400004",
|
|
|
"hdop" : 5,
|
|
|
"speed": 50
|
|
|
}
|
|
|
```
|
|
|
|
|
|
· **(*)actionId** (string): Unique identifier of the event
|
|
|
**\* = Required field**
|
|
|
|
|
|
· **(*)timestamp** (UTC Date): Date and time in UTC format of the moment in which the event was generated. It needs to be a maximum of 30 seconds old with respect to UTC time. The date must end with the character 'Z' that marks that it is in UTC.
|
|
|
- **(*) actionId** (text): unique identifier of the event.
|
|
|
|
|
|
· **(*)hdop**: DOP value to determine the quality of the GPS information. More information [here](https://en.wikipedia.org/wiki/Dilution_of_precision_(navigation))
|
|
|
- **(*) beaconId** (text): unique identifier of the beacon (for example, the MAC).
|
|
|
|
|
|
· **(*)speed** (decimal number): Speed in kilometers per hour at which the element is at the moment the event is sent
|
|
|
- **(*)beaconTypeId** (enter number): Beacon type identifier. The only possible value is beaconType/ 4=Unique. The rest of the values do not apply to this tracking method.
|
|
|
|
|
|
· **(*)beaconStart**: Field that contains the information of the parameters of the initial beacon.
|
|
|
- **(*) timestamp** (UTC date): date and time in UTC format of the moment in which the event was generated. It needs to be a maximum of 30 seconds old with respect to UTC time.
|
|
|
|
|
|
- **(*) lon** (decimal number): longitude of WGS 84 type coordinates where the event was generated.
|
|
|
|
|
|
· **(*)beaconId** (string): Unique identifier of the beacon (for example, the MAC)
|
|
|
- **(*) lat** (decimal number): latitude of WGS 84 type coordinate where the event was generated.
|
|
|
|
|
|
· **(*)lat** (decimal number): WGS 84 type coordinate latitude where the event was generated
|
|
|
- **(*) hdop** (enter number): DOP value to determine the quality of the GPS information. More information [here](https://en.wikipedia.org/wiki/Dilution_of_precision_(navigation))
|
|
|
|
|
|
· **(*)lon** (decimal number): Longitude of WGS 84 type coordinates where the event was generated
|
|
|
- **(*) speed** (decimal number): speed in kilometers per hour at which the element is at the moment the event is sent
|
|
|
|
|
|
**Note**: If it only contains the beaconStart field it corresponds to static information, if it contains the beaconStart field and beaconEnd it corresponds to dynamic information.
|
|
|
**Note**: *_To identify an event that requires a static trace (type of trace that requires a single beacon), the beacon must be identified with a **beaconTypeId** field value of 1= Start._*
|
|
|
|
|
|
## Methods required for the integration of connected cones
|
|
|
|
... | ... | |