InfiniTime.git

ref: fdc89f1a20889c0295534f58dc2e82ce8c55a18b

doc/NavigationService.md


  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
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
# Navigation Service

## Introduction

The navigation ble service provides 4 characteristics to allow the watch to display navigation instructions from a companion application. This service is intended to be used when performing some outdoor activities, for example running or cycling.

The 4 characteristics are:
flag (string) - Upcoming icon name
narrative (string) - Textual description of instruction
manDist (string) - Manouvre Distance, the distance to the upcoming change
progress (uint8) - Percent complete of total route, value 0-100

## Service

The service UUID is 00010000-78fc-48fe-8e23-433b3a1942d0

## Characteristics

## Flags (UUID 00010001-78fc-48fe-8e23-433b3a1942d0)

All included icons are from pure-maps, which provides the actual routing from the client. The icon names ultimately come from the mapbox project "direction-icons", See https://github.com/rinigus/pure-maps/tree/master/qml/icons/navigation See the end of this document for the full list of supported icon names.

## Narrative (UUID 00010002-78fc-48fe-8e23-433b3a1942d0)

This is a client supplied string describing the upcoming instruction such as "At the roundabout take the first exit".

## Man Dist (UUID 00010003-78fc-48fe-8e23-433b3a1942d0)

This is a short string describing the distance to the upcoming instruction such as "50 m".

## Progress (UUID 00010004-78fc-48fe-8e23-433b3a1942d0)

The percent complete in a uint8. The watch displays this as an overall progress in a progress bar.

## Full icon list

- arrive
- arrive-left
- arrive-right
- arrive-straight
- close
- continue
- continue-left
- continue-right
- continue-slight-left
- continue-slight-right
- continue-straight
- continue-uturn
- depart
- depart-left
- depart-right
- depart-straight
- end-of-road-left
- end-of-road-right
- ferry
- flag
- fork
- fork-left
- fork-right
- fork-slight-left
- fork-slight-right
- fork-straight
- invalid
- invalid-left
- invalid-right
- invalid-slight-left
- invalid-slight-right
- invalid-straight
- invalid-uturn
- merge-left
- merge-right
- merge-slight-left
- merge-slight-right
- merge-straight
- new-name-left
- new-name-right
- new-name-sharp-left
- new-name-sharp-right
- new-name-slight-left
- new-name-slight-right
- new-name-straight
- notification-left
- notification-right
- notification-sharp-left
- notification-sharp-right
- notification-slight-left
- notification-slight-right
- notification-straight
- off-ramp-left
- off-ramp-right
- off-ramp-sharp-left
- off-ramp-sharp-right
- off-ramp-slight-left
- off-ramp-slight-right
- off-ramp-straight
- on-ramp-left
- on-ramp-right
- on-ramp-sharp-left
- on-ramp-sharp-right
- on-ramp-slight-left
- on-ramp-slight-right
- on-ramp-straight
- rotary
- rotary-left
- rotary-right
- rotary-sharp-left
- rotary-sharp-right
- rotary-slight-left
- rotary-slight-right
- rotary-straight
- roundabout
- roundabout-left
- roundabout-right
- roundabout-sharp-left
- roundabout-sharp-right
- roundabout-slight-left
- roundabout-slight-right
- roundabout-straight
- turn-left
- turn-right
- turn-sharp-left
- turn-sharp-right
- turn-slight-left
- turn-slight-right
- turn-stright
- updown
- uturn