Skip to content

matkoniecz/lunar_assembler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lunar assembler

SVG maps from OpenStreetMap data in browser, can be used by marking area on a map. Using it does not require any programming skills.

In action

General high zoom map style

Publicly accessible generation of any location in this map style

examples/general_high_zoom_-_road_crossing.png

Animation of a typical use

examples/lunar_assembler_in_action.gif

examples/general_high_zoom_-_airport.png

try it!

Generating design for laser cut tactile maps

examples/laser_neighbourhood_-_Madalińskiego.png

This map styles are designed for used in a laser cutter, to produce maps for blind.

Ultra-high zoom map for showing a single crossing, relying on area:highway.

high zoom map style for showing neighbourhood, with some attempts to automatically simplify data, no need for area:highway.

Laser cut 3D tactile map

3D tactile map for blind children. Teaching aid for orientation lessons - special subject where children learn how to move on their own across the city. This is a map of a specific crossing, nearby their school. Made using this project, this propotype was donated to the school.

Cut using file generated by map style shown in the section above.


How can I use it on my site?

This work is AGPL licensed. This means that you also can use it, with requirement to share your improvements (see license for the full info, this is a single-sentence summary).

examples folder contains files necessary to use that in you project:

  • lunar_assembler.dist.js (build .js file containing all necessary JS code)
  • lunar_assembler.dist.css (build .js file containing all necessary CSS code)

Feel free to use it in your own projects or build on it!

Pull requests with improvements are also welcomed!

How can I make own map style?

Map style can be quite simple - just setting colors for lines/areas.

You can make own map style and use it at your own site.

You will need to copy examples/lunar_assembler.dist.css and examples/lunar_assembler.dist.js files and include it in your own site.

Fully functional examples are in an example folder.

There is a very simple but also working map style that can show water area, forests, buildings and marinas. See this simple example, this page is hosted and shown here.

examples/simple_map_style_-_Sztynort.png

Advanced map styles

In some cases one needs to somehow deals with layers. For example, what should be displayed if road in tunnel goes under building? Or under forest? What should be shown if there is a lake in a forest?

The most complex part of default map style is dealing with layers and it is often quite tricky.

Map styles also have access to a powerful functionality allowing complete rewriting of geometries, what is necessary to implement some functionality but typically can be ignored. I used it for example to generate zebra crossing bars on detailed road maps and to generate symbolic representations of steps areas.

Help!

Note: especially this part of documentation is incomplete and would benefit from better info. Please open an issue and mention what is confusing and where you are stuck. Right now I am not entirely sure what kind of knowledge people using it will have and what and how should be explained.

Other published styles

Demonstration of basic high-zoom map style

Architecture

It works in following way

  • user selects an area
  • Overpass API is called to download OpenStreetMap data in that area
  • data is locally processed and rendered

it means that servers only delivers HTML site, code then runs on client. It still needs access to Overpass API but there are generously provided servers allowing some limited use.

Use on other sites

current release and (for now only known use of it)

Potential uses

SVG files may be much more accessible for further processing than alternatives formats of OSM data.

SVG files may be directly usable for some purposes, for example in laser cutters.

Mentions of use are welcome

In case that you used this code or it inspired you to do something - feel free to create an issue with photo/description of what was produced! Or send an email to [email protected]. It would be nice to have confirmation that publishing it was useful for somebody.

Improving documentation

Please create a new issue if you want to use it but current instructions are insufficient, wrong or can be in some way improved!

I know that documentation may be far better, but I am not sure what kind of additional documentation would be most useful.

Alternatives

As usual OSM Wiki documentation is useful - there are also other ways to make SVG maps from OpenStreetMap data.

[https://touch-mapper.org/en/](Touch Mapper) is another OSM based tool for making tactile maps. It differs by relying on a 3D printing and by more complex infrastructure.

It requires Amazon Web Services to run. Inability to put limit on spending there scared me away from basing my work on it. I do not accept idea that bug in my code may result in a 100 000$ bill that may or may not be waived.

I have run programs that tried to allocate 4654951TB of memory due to a bad configuration and I am scared that Amazon would allow this to happen and then bill me.

hapticke.mapy.cz may be useful if you need tactile maps.

Skipped and rejected features

Note that it is basically impossible to make SVGs that would qualify as high-quality cartography here. As reason why this project exists does not require it (generation of laser cutter designs) it was not considered during design and implementation. But feel free to open issues and create pull requests to add missing functionality!

Sponsors


The OpenStreetMap foundation was funding the development of this project in their first round of the microgrant program in 2020. It was done as part of making tactile maps based on OpenStreetMap data, for blind or visually impaired children (part of making used tools accessible to other and OpenStreetMap promotion).

If anyone else is also interested in supporting this project via funding - let me know (opening a new issue is also OK) and it is likely that some way of doing that can be found :)