Maps & Places¶

PhotoPrism includes four high-resolution world maps to see where you've been, and for rediscovering long-forgotten shots.

To enhance your photos with location data such as state, city and category, we've also launched our own geo-information service based on OpenStreetMap. A future release will additionally provide public events' data, so that albums of popular music festivals, or sports gatherings, can be created automatically.

We are happy to assist other OSS projects that don't have the time or expertise to run their own infrastructure.

Example Request¶

https://places.photoprism.app/v1/location/149ce78563

{
  "id":"149ce78563",
  "name":"Pink Beach",
  "category":"nature",
  "timezone":"Europe/Athens",
  "lat":35.26963621850717,
  "lng":23.53695076231683,
  "place": {
    "id":"149ce78563",
    "label":"Chrisoskalitissa, Crete, Greece",
    "city":"Chrisoskalitissa",
    "state":"Crete",
    "country":"gr"
  },
  "events":[],
  "licence":"Data © OpenStreetMap contributors"
}

Privacy¶

Reverse geocoding requests won't be logged. Location data is cached though so that it can be used to serve subsequent requests. Because of HTTPS, your internet provider can't see the exact request - only the fact that you exchanged data with our backend.

Our API approximates coordinates, encodes them with S2, and doesn't care about street or house number:

Event Discovery¶

Open Source Libraries¶

https://tegola.io/ - An open source vector tile server written in Go
https://tegola.io/tutorials/tegola-with-open-layers/ - Using Tegola with OpenLayers
https://github.com/go-spatial/tegola-osm - scripts for importing and running a mirror of OSM with tegola
https://pelias.io/ - Pelias Geocoder (GitHub)
https://github.com/Leaflet/Leaflet - JavaScript library for mobile-friendly interactive maps
https://github.com/tidwall/tile38 - a geospatial database and realtime geofencing server
https://github.com/melihmucuk/geocache - an in-memory cache that is suitable for geolocation based applications
https://github.com/aaronland/go-slippy-tiles - a proxy for map tiles
https://github.com/paulmach/osm - a general purpose library for reading, writing and working with OpenStreetMap data
https://github.com/maguro/pbf - a Go-based OpenStreetMap PBF encoder/ decoder
https://github.com/golang/geo - S2 geometry library in Go
https://gist.github.com/antoniomo/3371e44cbe2f0cc75a525aac0d188cfb - example for S2 geometry library
https://github.com/tidwall/redcon - Redis compatible server framework (Go)
https://github.com/siddontang/ledisdb - a high performance NoSQL DB powered by Go (homepage)
https://github.com/blevesearch/bleve/tree/master/geo - geo support in bleve

OpenStreetMap¶

At the moment, we use the reverse lookup API of OpenStreetMap as well as the their tiles for our Leaflet-based Places page.

Code: internal/maps/osm/location.go

Commercial Maps¶

Tutorials¶

https://developers.google.com/maps/solutions/store-locator/clothing-store-locator#findnearsql
https://blog.mastermaps.com/2014/08/showing-geotagged-photos-on-leaflet-map.html - Showing geotagged photos on a Leaflet map
https://rubenspgcavalcante.github.io/leaflet-ant-path/ - Animate polylines as ants walking in a path