Serval Maps Bridge Template

The purpose of the Serval Maps Bridge Template is to demonstrate simply how to take Point of Interest (POI) data from a Serval Maps into another website or online service.

Application Components

The application is comprised of five main components.

Batch Uploading

The template application provides a simple mechanism for uploading POI data in a batch. Existing POI data in the Serval Maps database on the device is polled, converted to JSON and uploaded one entry at a time as a batch. A progress bar is displayed during the JSON conversion process and displayed again for the upload process.

Upload New Items on Receipt

The template application integrates with the Serval Maps application and receives alerts when new POI data is added to the database. This occurs either when a new POI is created by the user, or a POI is added from data received over the mesh network. This capability must be enabled via a setting in the application before it occurs.

Activity Log

An activity log is created that shows the success or failure of the upload of POI data and when the last action occurred for the POI record. Planned functionality includes the ability to retry the upload of a record that failed before.

Convert a POI Record to JSON

The template application is designed in such a way that a single class is used to convert the POI record to a JSON string. This string is stored in the Activity Log and is used for the upload step. The intention is to support the replacement of this sample class with a website / service specific class.

Upload the JSON Data

The template application is designed in such a way that a single class is used to upload the JSON data into a website / service. The intention is to support the replacement of this sample class with a website / service specific class.

Website / Service Specific Implementations

The first implementation of a Serval Maps Bridge is the Serval Maps Bridge - FIST application, which integrates Serval Maps with the FIST portal from the Kestrel Technology Group.

The second planned implementation is to create a Serval Maps Bridge which integrates with with an instance of the Sahana Eden software.

More Information

For more information please contact us via email on maps@servalproject.org


Login