Workshop about digital field mapping given in Paris at the Foss4g Europe, 18 July 2017

1. Geopaparazzi
WORKSHOP
Franceschi Silvia
Paris, 18 July 2017

2. GEOPAPARAZZI: INTRODUCTION
Geopaparazzi is a tool for digital field mapping.
Originally it has been developed for fast qualitative
engineering/geologic surveys but it can be used also as
a tool for emergency management, general field
activities (sport) and tourism.
Geopaparazzi is available on the Android Play Store.
Search for Geopaparazzi on your phone or get it from
the online android market.
Note: Geopaparazzi doesn't work on iPhone and
Windows Phone.

3. GEOPAPARAZZI: INTRODUCTION
The main aim of Geopaparazzi is to have a tool that:
●
can be always at hand when needed
●
gives the possibility to take georeferenced pictures
during the survey, with further possibility to import
them into a main GIS application
●
is extremely easy to use and intuitive, providing just
few important functionalities

4. GEOPAPARAZZI: INTRODUCTION
The main features available in Geopaparazzi are:
●
georeferenced notes: text notes, pictures, sketches,
forms
●
gps tracks logging
●
a map view for browsing and navigation of the data
●
easy export of collected data
●
simple generation of any type of background map

5. GEOPAPARAZZI: INSTALLATION
1. connect your Android device to
internet
2. open Play Store
3. type geopaparazzi within the
Search textbox

6. GEOPAPARAZZI: INSTALLATION
1. connect your Android device to
internet
2. open Play Store
3. type geopaparazzi within the
Search textbox
4. select to install the first
application found with the name
Geopaparazzi which represents
the last version (not
geopaparazzi3)
5. open Geopaparazzi...

7. GEOPAPARAZZI: FIRST START
Geopaparazzi requires to turn on the GPS
position of the device, if this is not
available when starting, the application will
ask to activate it.
Activate the GPS positioning
following the specifics of your
own device.

8. GEOPAPARAZZI: THE DASHBOARD
take a note project info
toggle GPS
logging
map view
import export

9. GEOPAPARAZZI: THE DASHBOARD
Icons in the menu bar can be
more with bigger screens or
in landscape mode.

10. GEOPAPARAZZI: THE DASHBOARD
GPS status:
RED: GPS is switched off
ORANGE: GPS is on but no
fix was acquired
GREEN: GPS is on, has fix,
and is not logging
BLUE: GPS is logging

11. GEOPAPARAZZI: THE DASHBOARD
Menu settings

12. GEOPAPARAZZI: THE DASHBOARD
Main menu

13. GEOPAPARAZZI: THE DASHBOARD
Background
tile sources
Create a
new project

14. Take a note
GEOPAPARAZZI: THE DASHBOARD

15. Place the note in the GPS
position or in the last map
center coordinates (active
only if GPS has fix).
Simple notes can contain:
●
text
●
picture
●
sketch
Complex notes are based on
structured forms.
GEOPAPARAZZI: NOTES

16. Save the picture or take
a new one (Take new).
GEOPAPARAZZI: NOTES

17. Select the type of line and
the color and start to draw.
GEOPAPARAZZI: NOTES

18. Project info
GEOPAPARAZZI: THE DASHBOARD

19. Some fields are editable
to insert the project’s
metadata.
GEOPAPARAZZI: PROJECT INFO

20. GPS logging
GEOPAPARAZZI: THE DASHBOARD
If GPS is logging:
- the logging button
will be orange
- the GPS status will
be blue
To STOP GPS logging select the same
button (in orange) and select to STOP
LOGGING.
To START GPS logging select
the button and enter a new log
name or continue from the last
one.

21. Map view
GEOPAPARAZZI: THE DASHBOARD

22. GEOPAPARAZZI: MAPS VIEW
●
Geopaparazzi by default uses on line services (mapnik)
saving the visualized tiles (and zoom) on the device
●
it is possible to use other background maps:
➢
off-line
➢
personalized (type of map and area)
available on the device.

23. GEOPAPARAZZI: MAPS VIEW
The basemap is loaded from an on-
line service considering the GPS
position (if the GPS is not active or if
there is no internet connection no map
will be displayed).
Tap the orange button in the map view
to see the menu.

24. GEOPAPARAZZI: MAPS VIEW
Map menu

25. GEOPAPARAZZI: MAPS VIEW
Long tap of the orange button to clear
the map from tools.
… and also to visualized them again.

26. GEOPAPARAZZI: MAPS VIEW
Maps tools
center the map in the
GPS position.
manage bookmarks
manage notes:
activate measure
maps center position
zoom levels
- tap: add new
- long tap: open the list
activate log analysis

27. GEOPAPARAZZI: NOTES
Select to place the note in
the GPS position or in the
center of the map.
Complex notes are possible
using customized forms.
Simple notes
To use them, a tags.json file
needs to be created and placed
inside the geopaparazzi folder
inside the sdcard. In that file a
json format description of the
wanted tags and forms needs to
be placed.
By default a sample tags.json is
created in the Geopaparazzi
installation. It contains form
samples and examples to show
all supported form widgets.

28. GEOPAPARAZZI: NOTES
Complex forms can contain
different tabs and fields
defined by drop-down menu or
multiple choices selection.

29. GEOPAPARAZZI: THE DASHBOARD

30. GEOPAPARAZZI: IMPORT
Choose the format of the data to
import as background or vector
layers.
browse/import projects
from the net
voluntary online service
that supplies mapurls
import CSV files that start
with bookmarks_xyz.csv
and contain lines of the
form: label,lat,lon,zoom
create a simple spatialite
database with a point, line
and polygon table

31. GEOPAPARAZZI: EXPORT
Choose the format of the data to
export (notes, images and GPS
tracks).
only direct export that
supports proper complex
notes representation
upload the current project
in the net
export all the images of
the project into a folder
export all the notes as a
report in a PDF file

32. GEOPAPARAZZI: PROJECTS
●
projects are saved in a single file with the given name
●
the first project, created by default in the home directory
of the device is named geopaparazzi.gpap
●
when installing the application in the home directory of
the device a new folder will be created geopaparazzi
containing the form definition and all the temporary files
●
it is strongly reccommanded to create a new project for
different field surveys to avoid confusion in the
registered data

33. geopaparazzi_workshop
➔
foss4gparis.sqlite
➔
hydrologis4gvsig_0.1.0.gvspks
➔
ile-de-france.map
➔
ortho_paris_5m_04.tif
➔
shape
➔
osm_buildings.shp
➔
osm_pois.shp
➔
osm_roadways.shp
➔
osm_waterareas.shp
➔
osm_waterlines.shp
GEOPAPARAZZI: WORKSHOP DATA
Shapefiles contained in the
spatialite DB
File with the map of the
central France to use off-line
Aerial imagery of the area
around here to use for
mbtiles
Sqlite database with vector
data
HydroloGIS plugin for
Geopaparazzi in gvSIG

34. geopaparazzi_workshop
➔
foss4gparis.sqlite
➔
hydrologis4gvsig_0.1.0.gvspks
➔
ile-de-france.map
➔
ortho_paris_5m_04.tif
➔
shape
➔
osm_buildings.shp
➔
osm_pois.shp
➔
osm_roadways.shp
➔
osm_waterareas.shp
➔
osm_waterlines.shp
GEOPAPARAZZI: WORKSHOP DATA
Shapefiles contained in the
spatialite DB
File with the map of the
central France to use off-line
Aerial imagery of the area
around here to use for
mbtiles
Sqlite database with vector
data
HydroloGIS plugin for
Geopaparazzi in gvSIG

35. GEOPAPARAZZI: BASEMAPS

36. GEOPAPARAZZI: BASEMAPS
●
open specifications:
https://github.com/mapbox/
mbtiles-spec
●
Mapbox presentation page
●
image tiles format
●
can be created in many
different ways (ex. jgrasstools,
gvSIG, gdal)
MBTILES

37. GEOPAPARAZZI: BASEMAPS
●
open source project under
LGPL licence
●
.map extension
●
binary vector format
●
maps available for download
at:
http://download.mapsforge.
org/maps/
http://www.openandromaps.
org/en/downloads
MAPSFORGE

38. GEOPAPARAZZI: BASEMAPS
●
simple textfile describing an
online/offline TMS or WMS
service
●
.mapurl extension
●
projection EPSG:4326
MAPURL

39. GEOPAPARAZZI: BASEMAPS
●
the service url containing XXX, YYY for the boundingbox
●
min/max longitudes and latitudes and the tiles dimension
MAPURL WMS EXAMPLE

40. Tap the + to add
new background
maps
Add a single entry
or a whole folder
In the
geopaparazzi
folder you can
find some online
services
The off-line maps
can be in .map
format
(mapsforge)
GEOPAPARAZZI: BASEMAPS

41. GEOPAPARAZZI: BASEMAPS
online mapnik offline mbtilesonline TMSoffline mapsforge

42. GEOPAPARAZZI: OVERLAY DATA
Tap the + to add
new spatialite db
Add a single entry
or a whole folder

43. GEOPAPARAZZI: OVERLAY DATA
Simple styling
possibilities:
- colors and sizes
●
set shape
●
set stroke width
●
set fill and stroke
color

44. GEOPAPARAZZI: OVERLAY DATA
Simple styling
possibilities:
- colors and sizes
- labelling
●
enabel labelling
●
set size
●
choose field

45. GEOPAPARAZZI: OVERLAY DATA
Result

46. GEOPAPARAZZI: EDITING TOOLS
long tap: select
editable layer
select among the list of
visible Spatialite layers
edit one layer
at a time (red)

47. GEOPAPARAZZI: EDITING TOOLS
tap: enter edit
mode (yellow)
Edit options are
different for
point, lines and
polygons:
●
add new
●
selection
●
edit geometry
●
edit attributes
tap again to
exit editing
mode

48. GEOPAPARAZZI: EDITING TOOLS
delete feature
tap selection:
draw a rectangle
to select one or
more features on
the screen (red)
copy feature
visualize/edit
attributes
cancel selection

49. GEOPAPARAZZI: EDITING TOOLS
delete feature
(cian)
attributes
save: confirm
cancel: undo

50. GEOPAPARAZZI: EDITING TOOLS
tap new:
draw a polygon by
taking vertexes
use drawing tools to specify the
vertexes of the polygon
(GPS, map center, tap)
back/undo: delete
last point
save: save new
feature

51. GEOPAPARAZZI: EDITING TOOLS
tap new:
draw a polygon
using the
available tools
(hand)
back/undo: to come back to the
main editing tools
save geometry
add other
polygons
intersecting an
existing one

52. GEOPAPARAZZI: EDITING TOOLS
edit polygons:
remove pieces
of polygons
draw a line
starting from the
polygon you
want to keep
and to the one
to use to cut
confirm save
geometry or
undo

53. GEOPAPARAZZI: EDITING TOOLS
edit polygons:
add pieces of
polygons
draw a line
starting from the
polygon you
want to expand
to the one to
add
confirm save
geometry or
undo

54. GEOPAPARAZZI & gvSIG
●
the plugin for the support of Geopaparazzi in gvSIG is
available at: https://we.tl/ROxgEc267P
●
read carefully the installation guidelines available here:
https://github.com/moovida/hydrologis4gvsig/releases/download/releas
e_0.1.0___jgt_0.8.1/hydrologis4gvsig_quickstart.pdf
●
in gvSIG it is possible to
– visualize a Geopaparazzi project
– create the map background data as .mbtile
– export and browse the image notes
– export all the data contained in the project as
shapefile

55. GEOPAPARAZZI & gvSIG
●
the plugins are supplied as a gvSIG package (gvspks)
●
to install the Geopaparazzi plugin use the standard
gvSIG updtate manager
●
enter the Addons manager,
which can be found in the
Tools menu
●
choose the Installation
from file option
●
select the installation
package
●
push on next

56. GEOPAPARAZZI & gvSIG
●
from the dialog that lists all installed and available
plugins look for the plugins that start with
org.jgrasstools.gvsig
●
select and confirm that you
want to install those plugins
●
wait until all the
packages are installed
●
restart gvSIG

57. GEOPAPARAZZI & gvSIG
launch gvSIG and create a new view, then enter the properties and
set the right projection. It needs to be set to the one of the data
the aerial data of France
is available for free in
CRS EPSG: 2154

58. GEOPAPARAZZI & gvSIG
Drag the aerial image (TIF) into the map view.
select NON TILED when
asked

59. GEOPAPARAZZI & gvSIG
In gvSIG there is a tool to create the background maps for
Geopaparazzi. The user just sets the wanted zoomlevels and a
name and output folder for the database.

60. GEOPAPARAZZI & gvSIG
Once launched it takes the current view and all layers and
generates an mbtiles database for Geopaparazzi. Pay attention on
the upper zoomlevel, it might be hard on your PC and time.
On large areas 19
might be a good
compromise.

61. GEOPAPARAZZI & gvSIG
CONVERT A PROJECT TO GIS DATA: in gvSIG do an ADD
LAYER, it will present you Geopaparazzi as option (new tab)
select the project to
convert in shp

62. GEOPAPARAZZI & gvSIG
CONVERT A PROJECT TO GIS DATA: in gvSIG do an ADD
LAYER, it will present you Geopaparazzi as option (new tab)

63. GEOPAPARAZZI & gvSIG
CONVERT A PROJECT TO GIS DATA: in gvSIG do an ADD
LAYER, it will present you Geopaparazzi as option (new tab)
select the project to
convert in shp

64. THANKS FOR THE ATTENTION!!
Franceschi Silvia, Andrea Antonello
info@hydrologis.eu
Homepage:
www.geopaparazzi.eu
Mailinglist.
http://groups.google.com/group/geopaparazzi-users