Introduction

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

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:


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 (https://en.wikipedia.org/wiki/GeoJSON).
(The author uses e.g. the free GPSBabel (https://www.gpsbabel.org/) 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 http://geojson.io)

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: https://en.onlinedemo.picapport.de/picapport#thumbs?query=track+cevennen&sort=datetimeascending&viewtime=7


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)

marker-colorString"red"

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: https://github.com/mapbox/simplestyle-spec/tree/master/1.1.0

stroke-visible
(stroke)

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

stroke
(color)

String"#3388ff"

Line color (like marker-color)

stroke-width
(weight)

Integer3Line width in pixels

stroke-opacity
(opacity)

Decimal
0.0 - 1.0

1.0Opacity of the line

stroke-linecap
(lineCap)

String"round"

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

see: https://developer.mozilla.org/de/docs/Web/SVG/Attribute/stroke-linecap

stroke-linejoin
(lineJoin)

String"round"

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

see: https://developer.mozilla.org/de/docs/Web/SVG/Attribute/stroke-linejoin

stroke-dasharray
(dashArray)

String

not set

A string that defines the dash pattern.

see: https://developer.mozilla.org/de/docs/Web/SVG/Attribute/stroke-dasharray

stroke-dashoffset
(dashOffset)

Stringnot set

Spacing of the line pattern.

see: https://developer.mozilla.org/de/docs/Web/SVG/Attribute/stroke-dashoffset

fill-visible
(fill)

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

fill
(fillColor)

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

Decimal
0.0 - 1.0

0.2Opacity of the area