mkpine.github.io-pine

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