git clone http://danamlund/git/map_with_photos/.git
Log | Files | Refs

readme.org (2032B)


      1 Create a standalone .html file that shows photos and GPS recordings on
      2 hybrid google maps using leafletjs.
      3 
      4 * Demo
      5 https://danamlund.github.io/map_with_photos/demo/map.html
      6 
      7 * Features
      8  - Shows where photos were taken on google maps. 
      9  - Single standalone .html file. js/css libraries are bundled in
     10    file. It still requires internet to access google maps tiles.
     11  - Auto-extracts gps coordinates from locally stored photos.
     12  - Links to locally stored photos (so moving the .html file can break
     13    it).
     14  - Can also import .gpx files to show recorded GPS routes.
     15  - Supports 360 degree images with redbean web server and pannellum js
     16    360 viewer.
     17 
     18 * Usage
     19 #+BEGIN_EXAMPLE
     20 $ python map_with_photos.py `find . -iname '*.jpg'` `find . -iname '*.gpx'`
     21 $ firefox map.html
     22 #+END_EXAMPLE
     23 
     24 If contain 360 images, then it will output a redbean webserver running pannellum.
     25 #+BEGIN_EXAMPLE
     26 $ python map_with_photos.py `find . -iname '*.jpg'` `find . -iname '*.gpx'`
     27 $ ./map.bat
     28 #+END_EXAMPLE
     29 
     30 
     31 * Dependencies
     32 Bundled in the python script and generated .html files.
     33  - leaflet https://leafletjs.com/
     34  - leaflet plugin marker cluster https://github.com/Leaflet/Leaflet.markercluster
     35  - leaflet plugin photo https://github.com/turban/Leaflet.Photo
     36  - leaflet plugin gpx https://github.com/mpetazzoni/leaflet-gpx
     37  - dygraph http://dygraphs.com/
     38  - redbean https://redbean.dev/
     39  - pannellum https://pannellum.org/
     40 
     41 Changes to the gpx plugin: Use inline images for marker icons. And
     42 keep track of number of GPS points in routes.
     43 
     44 * Bugs
     45 No arguments or much help. This is essentially a personal tool.
     46 
     47 Giving all photos as arguments will fail if there are too many
     48 photos. My system have a default max argument size of 2M. That is
     49 enough for me for the foreseeable future.
     50 
     51 The standalone .html requires internet and a working google maps
     52 API. I do not know if google maps will work in 20 years. The google
     53 api path is a single place in the .html, so it is easy to change. I
     54 would have liked to bundle the map tiles near photos as inline images.