BangleApps_old/apps/openstmap

OpenStreetMap

This app allows you to upload and use OpenSteetMap map tiles onto your Bangle. There's an uploader, the app, and also a library that allows you to use the maps in your Bangle.js applications.

Uploader

Once you've installed OpenStreetMap on your Bangle, find it in the App Loader and click the Disk icon next to it.

A window will pop up showing what maps you have loaded.

To add a map:

• Click Add Map
• Scroll and zoom to the area of interest or use the Search button in the top left
• Now choose the size you want to upload (Small/Medium/etc)
• On Bangle.js 1 you can choose if you want a 3 bits per pixel map (this is lower quality, but uploads faster and takes less space). Bangle.js 2 is limited to 3bpp.
• Click Get Map, and a preview will be displayed. If you need to adjust the area you can change settings, move the map around, and click Get Map again.
• When you're ready, click Upload

Note: By default on Bangle.js, pre-dithered 3 bpp bitmaps will be uploaded (which match the screen bit depth). However you can untick the 3 bit checkbox to use 8 bit maps, which take up 2.6x more space but look much better when zoomed in/out.

Bangle.js App

The Bangle.js app allows you to view a map. It also turns the GPS on and marks the path that you've been travelling (if enabled), and displays waypoints in the watch (if dependencies exist).

• Drag on the screen to move the map
• Click at the bottom left corner to zoom in, bottom right to zoom out (or you can choose from the menu)
• Press the button to bring up a menu, where you can zoom, go to GPS location, put the map back in its default location, or choose whether to draw the currently recording GPS track (from the Recorder app).

The map displays:

• Your current GPS location and angle (in blue) or a circle at the edge of the screen if your location is offscreen
• Your currently recorded/recording track in red (if the Recorder app is installed)
• Any waypoints as red markers (if the Waypoint app is installed)

Bangle.js App Settings

Pressing the button while in the app and unlocked brings up the settings menu:

• Center GPS - (if GPS lock available) centre the map on the GPS location
• Zoom in - zooms in on the map (tapping bottom left in the map also does this)
• Zoom out - zooms out on the map (tapping bottom right in the map also does this)
• Draw Track - if Recorder is installed this will draw the current GPS track in red
• Draw cont. position - will leaves a series of red dots on screen marking your previous GPS position (these disappear when you scroll)
• Hide Widgets - hide the widget bar to leave more space for the map
• Autoscroll - then the GPS marker starts going offscreen, scroll to show it again
• Direction Source - (Bangle.js 2 only) None/GPS/Compass When showing the direction with the GPS marker where to get the direction from. If None a GPS marker isn't shown
• Reset Compass - reset the compass (if calibration has gone wrong - turn in a circle immediately after to recalibrate)
• Center Map - Center the view on the current map (not GPS)
• Record - If Recorder app is installed, start/stop recording
• Exit - Exit to the Clock

Library

See the documentation in the library itself for full usage info: https://github.com/espruino/BangleApps/blob/master/apps/openstmap/openstmap.js

Or check the app itself: https://github.com/espruino/BangleApps/blob/master/apps/openstmap/app.js

But in the most simple form:

var m = require("openstmap");
// m.lat/lon are now the center of the loaded map
m.draw(); // draw centered on the middle of the loaded map