/map2gpx

map2gpx lets you trace paths on maps (for hiking for instance) and export them to GPX or KML formats.

Primary LanguageHTMLMIT LicenseMIT

map2gpx

Demo

For the French version, see map2gpx.fr. For the international version, see map2gpx.eu.

How to rebuild

Pre-requisites:

  1. Install nodejs
  2. In the checkout, install the dependencies: npm install
  3. Run npm run lrm-graphhopper-fixup
  4. If you are using GeoPortail API, download the autoconf file and put it in this folder under the name autoconf-https-prod.json. This can be ignored if not using GeoPortail API.
  5. Web-server with PHP installed

Rebuild:

  • npm run pack runs:
    • rollup to generate the JS library files (can be re-used as-is without all the map2gpx layout) in dist folder
    • gulp to generate the websites (dist-www for generic assets, www-fr and www-en for the whole map2gpx websites)

Generated files

Output comes in multiples flavors:

  • dist folder exposes the library (available in CommonJS, ES6 and UMD formats), that can be reused directly into your projects
  • www-fr to use GeoPortail maps and APIs (only available in France) - driven by index-fr.html, source for map2gpx.fr
    • You will need your own API key if you want to test/run it
  • www-en to use services available worldwide (maps from OpenStreetMap, Thunderforest, OpenTopoMap, Hike & Bike, Hillshading and APIs from OpenElevation, GrapHopper) - driven by index-en.html, source for map2gpx.eu
    • Thunderforest and GraphHopper require API keys. Even if the API keys provided here may work for you, please use your own API key if you to test/run it

Customize

If you want to add more services, feel free to create an issue, submit a pull request, or even fork the project and run it by yourself.