Geopaparazzi Presentation given at Foss4g Asia 2018

1. GEOPAPARAZZI
STATE OF THE ART
Andrea Antonello, Silvia Franceschi
HydroloGIS s.r.l.
Foss4G Asia-2018 Moratuwa
December 3rd 2018

2. WHO AM I?
cofounder of
Contract professor in Advanced Geomatics at the
Charter Member and GFOSS advocate
develop and coordinate
develop and coordinate the
working on integration of the HortonMachine and
Geopaparazzi in gvSIG
HydroloGIS
Free
University of Bolzano
Osgeo
Geopaparazzi
HortonMachine project

3. IN HYDROLOGIS WE ARE ENGINEERS
AND DEVELOPERS, AND DO
SUVERYS…​ SOMETIMES ;-)

4. …
…
​
​
THE RUGGED PANASONIC XPLORE
THE RUGGED PANASONIC XPLORE
…
…
​
​
THE RUGGED PANASONIC XPLORE
THE RUGGED PANASONIC XPLORE
…
…
​
​
THE RUGGED PANASONIC XPLORE
THE RUGGED PANASONIC XPLORE
……​​THE RUGGED PANASONIC XPLORETHE RUGGED PANASONIC XPLORE
TABLET
TABLET
TABLET
TABLET
TABLET
TABLET
TABLETTABLET

5. …
…
​
​
THE ULTRALIGHT ASUS
THE ULTRALIGHT ASUS
…
…
​
​
THE ULTRALIGHT ASUS
THE ULTRALIGHT ASUS
…
…
​
​
THE ULTRALIGHT ASUS
THE ULTRALIGHT ASUS
……​​THE ULTRALIGHT ASUSTHE ULTRALIGHT ASUS

6. …
…
​
​
THE TRIMBLE JUNO
THE TRIMBLE JUNO
…
…
​
​
THE TRIMBLE JUNO
THE TRIMBLE JUNO
…
…
​
​
THE TRIMBLE JUNO
THE TRIMBLE JUNO
……​​THE TRIMBLE JUNOTHE TRIMBLE JUNO

7. BUT NONE OF THEM TURNED OUT
RIGHT FOR US

8. AND THEN ANDROID CAME AND
MADE IT POSSIBLE TO EASILY
SURVEY IN PRACTICALLY…​

9. ANY CONDITION
ANY CONDITION
ANY CONDITION
ANY CONDITION
ANY CONDITION
ANY CONDITION
ANY CONDITIONANY CONDITION

10. AND I MEAN: ANY CONDITION
AND I MEAN: ANY CONDITION
AND I MEAN: ANY CONDITION
AND I MEAN: ANY CONDITION
AND I MEAN: ANY CONDITION
AND I MEAN: ANY CONDITION
AND I MEAN: ANY CONDITIONAND I MEAN: ANY CONDITION

11. WHAT IS GEOPAPARAZZI?
basically an engineering survey
tool but it can be used also for
emergency management, general
field activities (sport) and tourism
always at hand when needed
can collect georeferenced
pictures, notes and gps logs
easy to use and intuitive

12. BASE FUNCTIONALITIES
 Notes, images and gps logs are saved in the project
file.

13. SUPPORTED BASEMAPS
Mapsforge map files (vector, 1 nation in 500MB), MBtiles
databases, TMS online/offline, WMS, Rasterlite2 databases

14. SPATIALITE: LOAD DATABASES
 You can set the color, dimensions, width and the
labelling of the features.

15. SPATIALITE: THEMATIC STYLING
Support for unique values thematic styling (readonly - SLD)
for all feature types.

16. IMPORT / EXPORT
Geopaparazzi supports some simple import - export directly
from the device.
Complex notes (forms) can be exported to pdf.

17. GEOPAPARAZZI TOOLS FOR GVSIG
in gvSIG it is possible to:
create the map background data as .mbtile
create the forms to use in the field with the form editor
create a spatialite database with SLD styles
export the data contained in the project as shapefiles
browse geopaparazzi project files
the plugins are avaliable in the gvSIG addons repository
and in the of the project with
updated documentation and an installation guide
github releases page

18. CREATE BACKGROUND MAPS
Create Geopaparazzi Tiles can create mbtiles maps:
 Vectors are styled based on the SLD file they have.

19. CREATE FORMS
Form designer can create the form for complex notes

20. CREATE A SPATIALITE DATABASE
The Spatialite Creator (HortonMachine) allows to create a
database from a folder of shapefiles, using their SLD to style
the features.

21. CONVERT A PROJECT TO GIS DATA
In the ADD LAYER command of gvSIG there is a Geopaparazzi
option (tab).

22. CONVERT A PROJECT TO GIS DATA
All the collected info are stored as attributes also for form
based notes.

23. A FEW NOTES FOR DEVELOPERS
A FEW NOTES FOR DEVELOPERS
A FEW NOTES FOR DEVELOPERS
A FEW NOTES FOR DEVELOPERS
A FEW NOTES FOR DEVELOPERS
A FEW NOTES FOR DEVELOPERS
A FEW NOTES FOR DEVELOPERSA FEW NOTES FOR DEVELOPERS

24. THE NEW PLUGIN SYSTEM
In the last year work has been done to make the
geopaparazzi application more pluggable.
We are in an early stage but some things can be done
already:
the application can be branded easily
through plugins we can add entries to the import/export
menus

25. THERE IS DOCUMENTATION AT
THERE IS DOCUMENTATION AT
THERE IS DOCUMENTATION AT
THERE IS DOCUMENTATION AT
THERE IS DOCUMENTATION AT
THERE IS DOCUMENTATION AT
THERE IS DOCUMENTATION ATTHERE IS DOCUMENTATION AT
WWW.GEOPAPARAZZI.EU
WWW.GEOPAPARAZZI.EU
WWW.GEOPAPARAZZI.EU
WWW.GEOPAPARAZZI.EU
WWW.GEOPAPARAZZI.EU
WWW.GEOPAPARAZZI.EU
WWW.GEOPAPARAZZI.EUWWW.GEOPAPARAZZI.EU

26. AN EXAMPLE
The following lines of code…​
public class MainGvsigMobileActivity
extends GeopaparazziCoreActivity {
}
<resources>
<string name="my_gvsig_appname">GvSIG Mobile</string>
</resources>
<color name="main_background">#FFFFFF</color>
<color name="main_decorations">#cf7d3c</color>
<color name="main_decorations_dark">#cf7d3c</color>
<color name="main_text_color">#00699e</color>
<color name="main_text_color_neutral">#00699e</color>
<color name="main_selection">#008fd8</color>
<color name="main_selection_border">#008fd8</color>

27. AN EXAMPLE
…​allow for this branding

28. HOW DO I SYNCHRONIZE MY
WORKING TEAM WITH MY SERVER?

29. 1) GEOPAPARAZZI PROFILES
Data management for casual and non-GIS users can be
difficult: Find a basemap (.map, .mapurl, etc), some
Spatialite overlays, get a tags.json file, and create a project
file. Oh and add them to your Geopaparazzi session.
Profiles are a way to easily group and switch basemap,
overlay, tags/forms, and project files
A Profile is a bit of JSON, read (and stored) by
Geopaparazzi
A great way to distribute data to many Geopaparazzi
users

30. CLOUD PROFILES
Cloud Profiles are delivered from a web server
You specify the server in Cloud Settings in Geopaparazzi
Use Import → Cloud Profiles
Select a profile and all its files are automatically
downloaded

31. COOKIECUTTER GEOPAPARAZZI
REFERENCE SERVER
Developed and released by as free and open
source license:
1. create Cloud Profiles for download with graphical feature
editing
2. HTTPS/TLS security
3. users management with email confirmation and social
media signup
4. media storage via Amazon AWS
 Github page:
Geoanalytic
cookiecutter-geopaparazzi-server

32. 2) MAPZONE
is a web platform to gather data, create
maps, publisch web services and share data.
It allows you to create free projects as long as the uploaded
data are public.
The platform is very solid, has advanced tools (ex. styling)
and…​ has a geopaparazzi plugin!
https://mapzone.io

33. You can use the built in Cloud Projects import/export, i.e.
upload projects, download the list of online projects and
download a selected project to the device.
In mapzone the projects are split into layers that can be
styled on demand.
This applies to logs…​

34. …​notes…​

35. …​and images! Everything is nicely displayed:

36. THE GEOPAPARAZZI SURVEY SERVER
THE GEOPAPARAZZI SURVEY SERVER
THE GEOPAPARAZZI SURVEY SERVER
THE GEOPAPARAZZI SURVEY SERVER
THE GEOPAPARAZZI SURVEY SERVER
THE GEOPAPARAZZI SURVEY SERVER
THE GEOPAPARAZZI SURVEY SERVERTHE GEOPAPARAZZI SURVEY SERVER
& FRIENDS
& FRIENDS
& FRIENDS
& FRIENDS
& FRIENDS
& FRIENDS
& FRIENDS& FRIENDS

37. THE SERVER
The Geopaparazzi Survey Server (GSS) is a web application
that allows geopaparazzi users to synchronize their project
data with a central server.
Its companion is an Android app named Geopaparazzi
Survey Server Sync (GSSS) .
The app can connect to geopaparazzi projects and perform
synchronization of the data contained using
the unique device ID to upload the data to the server.
The server can be installed through docker
available on google play
incremental

38. INSTALLATION AND RUN
To start the server, just run:
This will download and install the docker image on your
system (if it is not there already) and then start a server that
uses /home/hydrologis/GSS as data folder and port 8080 for
its webservice.
Open your favorite browser and enter the url:
docker run --rm -v /home/hydrologis/GSS:/home/basefolder
-e JAVA_OPTS="-Xms1256m -Xmx4g -Dstage.globalfolder=/home/basefolder/"
-p 8080:8080 -p 9092:9092 moovida/gss:v2.15
http://localhost:8080

39. DASHBOARD AND MAP VIEW
The application features a dashboard and a map view to
keep track of surveyors and data uploaded.

40. USERS AND USERS
It is possible to:
create web users and groups. There are two levels of
users: admins and normal users.
configure surveyors. New devices that connect and
upload are automatically added. The name of the
surveyor by default is the unique id of the device.

41. SERVE DATA FROM THE SERVER TO
YOUR TEAMS
Datasets available that we will use are of basemap, overlay
and project type:

42. sri-lanka.map: mapsforge map of Sri Lanka. Less than
100Mb for all the Openstreetmap data of Sri Lanka on your
device

43. moratuwa_university.mbtiles: mbtiles map of an ortophoto
of the region of the university. The image is from google
maps and has pure educational purposes.

44. osm_sri_lanka.sqlite: spatialite vector database with some
data of the region of Colombo-Moratuwa

45. DOWNLOAD THE DATA WITH GSSS
If you open the GSSS, enter the Data Download view and
push refresh, you should see the available data. The
different icons are for basemaps (grid), overlays (polyline)
and project.

46. LOAD THE DATA INTO
GEOPAPARAZZI
To load basemaps enter the tiles icon from the main
actionbar, then use the FAB button to browse the filesystem
for the data:

47. To load overlays enter the map context menu, then use the
FAB button to browse the filesystem for the data:

48. To load an existing geopaparazzi project choose Load
existing project from the main menu to browse the
filesystem for the project file:

49. THE FORM BUILDER
The server features also a powerful form builder. You can
create your forms and publish them to your teams.

50. GET THE SURVEY DATA IN THE
SYSTEM
Once back from the survey, GSSS can be used to load the
incremental (only new notes and logs are synchronized)
survey to the server.

51. THE SYNCHRONIZATION VIEW
If you never loaded a geopaparazzi project before, it is
simple to load one (*.gpap):

52. SYNCHRONIZE THE DATA
Once you choose a project, the notes, logs and images will
be visible in 3 distinct tabs.

53. THANKS FOR YOUR ATTENTION!
Homepage:
Need help? Join the Mailinglist.
Have cool userstories to share? Join the facebook group:
Geopaparazzi Users Around The World!
Want to translate it in your language?
News about Geopaparazzi:
http://www.geopaparazzi.eu
http://groups.google.com/group/geopaparazzi-users
https://www.facebook.com/groups/350587351732480/
https://www.transifex.com/projects/p/geopaparazzi/
http://jgrasstechtips.blogspot.it/search/label/geopaparazzi