summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 61de4c8e9bfb218d372779ec22a8b4460ee1ee77 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# Navigation Service

## Overview

Navigation service keeps track of application data that allows other clients to share location, waypoints,
and state between each other.

## Verbs

| Name                | Description                                 | JSON Response                      |
|---------------------|---------------------------------------------|------------------------------------|
| subscribe           | subscribe to an navigation service          | *Request:* {"value": "status"}     |
| unsubscribe         | unsubscribe to an navigation service        | *Request:* {"value": "status"}     |
| broadcast_status    | broadcast status event to other clients     | *Request:* {"state": "stop"}       |
| broadcast_position  | broadcast position event to other clients   | See *position Verb* section        |
| broadcast_waypoints | broadcast waypoints events to other clients | See *waypoints Verb* section       |


### broadcast_position Verb

Populate same data referenced in *position Event* section for the event

### broadcast_waypoints Verb

Populate same data referenced in *waypoints Event* section for the event

## Events

| Name           | Description                         |
|----------------|-------------------------------------|
| status         | status of the navigation engine     |
| position       | current route or car position event |
| waypoints      | waypoints for routing engine        |

### position Event

<pre>
{
  "points": [
    {
      "position": "car",
      "latitude": 36.12906,
      "longitude": -115.17908
      "direction": 273.0,
      "distance": 1530.45
    }
  ]
}
</pre>

### waypoints Event

<pre>
{
  "points": [
    {
      "latitude": 36.12906,
      "longitude": -115.17908
    }
  ]
}
</pre>