Tactile map maker. Creates 3D or embosser printable files for requested OpenStreetMap areas.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.idea
OSM2World
converter
doc
install
translation
web
.gitignore
COPYING.txt
Makefile
README.md
agpl-3.0.txt
init.sh
ol-custom.json

README.md

Touch Mapper

Tactile map maker. Creates files for 3D or embossing printing from OpenStreetMap data. See https://touch-mapper.org

Feature roadmap

List is in a rough priority order.

  • Allow printing a QR sticker that points to touch-mapper.org/?map=deadbeef
  • Allow inspecting maps on a touch device.
    • APH's Nearby Explorer, and other apps
  • Describe map contents in the web UI (in progress).
  • Describe map contents in audio
    • Could perhaps crowd source production of the descriptions
  • Print labels for roads and/or points of interest
    • Maybe use short labels, and offer a separate legend that maps the labels to longer descriptions. The legend could be electronic.
  • Replace spinning 3D preview with one or more larger static images, create using Blender Render, using ambient occlusion
    • 3D preview is too small and unclear, and doesn't work on all devices
  • Remember user's past maps
  • Avoid significant overlaps between roads and buildings. This would enable reliable two-color 3D printing.
  • Print a compass star into corner of the map
  • Indicate map scale using small dots on map borders
  • Smaller scale modes: only show water/land/green areads; N largest roads; city borders
  • Non-square maps
  • Indoor areas

Technical TODO:

  • Move converter from EC2 to Lambda
  • Do all the work in a Java application that could be based on the first stages of OSM2World transformation pipeline. Benefits:
    • Do road processing mostly when they are still line segments rather than 2D objects
    • Better performance
    • Simpler processing pipeline

Development

Install dependencies

./init.sh

Setup AWS CLI

aws configure

Create AWS resources

make dev-aws-install

API Gateway for accessing email sending Lambda is for now not created automatically. The same API GW endpoints can be used by all Touch Mapper instances.

Install static website to S3

make dev-web-s3-install

Last line of output gives the URL (https://something.cloudfront.net) where the web UI can be accessed.

Run OSM -> STL converter service

In a tab of its own:

install/run-dev-converter.sh

Local web development

In web dir, in separate tabs:

make watch
make serve

You can now access the web UI in http://localhost:9000