Creating and using maps, trails and Geojson files with PicApport


Already very early in PicApport we have added the possibility to search for photos via geocoordinates or to display them on a map.
See also Find photos with the map on Find photos with PicApport – PicApport Wiki (

Even with medium-sized photo collections, this can quickly become confusing. With the release of version 8 we have therefore
decided to expand the GEO functionality as follows:

  • Possibility to create dynamic collections as markers (color freely selectable) with text and an optional link on the map.
    With this you can e.g.
    • View all photos of a holiday trip via the marker on the map
    • Summarize all photos of a city e.g. Berlin and call them up via a marker.
    • Example (just click on the markers): Start online demo and then click on the globe next to the help button.
  • Possibility to display tracks, routes or other map information as GeoJSON file on the map.
    With this you can e.g.

  • In addition to the map-provider selection, PicApport supports three PicApport layers on the map.
    The individual layers can be switched on or off individually via the layer menu in the lower right corner.

    • Photo markers (markers for the photos)

    • The MyMarker layer: markers for dynamic collections (since version 8.0)
      This layer is only available if at least one marker has been created.

    • The GeoJSON layer: tracks, itineraries, etc. (since version 8.0)
      This layer is only available when a GeoJSON file has been clicked in the thumbnail view.

Create a Dynamic Collection as a Marker

To create markers you need the appropriate authorization: Permission to edit markers on map
(This authorization is automatically set during a version update for all users who have permission to edit dynamic collections.)

The name (title) of the marker as well as the description are taken from the selected photo and can be overwritten or changed.

Create GeoJSON files

Typically you create tracks or routes with a tracking app on your mobile phone. Because there are a lot of data formats,
a program converts the generated file into a GeoJSON file (
(The author uses e.g. the free GPSBabel ( which can also reduce the number of recorded track points, which is highly recommended).

Also there are numerous programs and tools to create tracks or GeoJSON files manually. (e.g. in the web

A GeoJSON file valid for PicApport must have the file extension .geojson. If the converter assigns the file extension .json, the file extension must be changed to .geojson after conversion.

Once the GeoJSON file has been created, it is simply copied to a directory on the PicApport server together with the thematically assigned photos.
The PicApport-Crawler automatically creates a thumbnail for the GeoJSON file.

This thumbnail takes metadata from the GeoJSON file  (see below the item Optional Metadata for GeoJSON Files) or can be provided with additional keywords in PicApport.
The GeoJSON file can then be found/queried with normal PicApport queries.

When you click on the track, there are two ways to display the track:

  1. Show GeoJSON-File on map
    The track is displayed including all images found in the same (current) query.

  2. Show GeoJSON-File on map with associated photos
    The track is only displayed with the photos that are in the same directory (including all subdirectories) as the track.
    Images which appear in the (current) query, but are located in other directories are not displayed. This allows you to reduce the display exclusively to the track and the assigned images.

Example on the Online Demo:

Description of the attributes supported by PicApport in Geojson files

The following two links show a simple example of a GeoJSON file:

Optional Metadata for GeoJSON Files

So that Geojson files can be found in PicApport, it is possible to optionally equip them with the following metadata:

"picapport-metadata": {
        "timestamp": "2007-12-11 15:00:00",
        "title": "Titel der GeoJSON Datei",
        "description": "Beschreibung",
        "keywords": "tag1, tag2, tag3",
        "rating": 1

See also our example GeoJSON file: kaikoura-whale-watching-map.geojson

timestampString (YYYY-MM-DD HH:MM:SS)

Creation date of the
GeoJSON file

Used like the date a photo was taken
for searching and sorting
titleStringName of GeoJSON fileCan be used for search
descriptionStringnot setCan be used for search
keywordsStringnot setCan be used for search
ratingIntegernot setRating (stars) for file
Allowed values: 0-5

picapport-metadata„:{} is a PicApport specific extension of the GeoJSON specification.
It is possible that this information is not supported by other GeoJSON editing programs (may not be saved after modification).

GeoJSON Styling and Attributes

Description (Valid for markers, lines and polygons)

titleStringnot setHeading for the tooltip of the object
urlStringnot set

External URL (Only in conjunction with title)
If title and url are set, the title is clickable in the popup.
The url is displayed in a new tab

descriptionStringnot setDescriptive text
picapport-queryStringnot set

If available, a Picapport query can be started.
(Thumbnails will then be displayed)

Points (Marker)


Color of the marker
next to the html-colors in the # notation (#rrggbb)
The following color codes are supported:

white, black, red, blue, yellow, orange, green

Lines in polygons

We have oriented ourselves to the following specification:


BooleantrueSet it to false to disable borders of polygons or circles. 



Line color (like marker-color)


Integer3Line width in pixels


0.0 – 1.0

1.0Opacity of the line



A string that defines the shape to be used at the end of a line.




A string that defines the shape to be used at the corners of lines.




not set

A string that defines the dash pattern.



Stringnot set

Spacing of the line pattern.



BooleantrueSpecifies whether the path should be filled with color. Set it to false to disable filling of polygons or circles.


Stringif not set then same value as strokeFill color of area (like marker-color)

0.0 – 1.0

0.2Opacity of the area