Skip to content
No description, website, or topics provided.
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources
src/osmgpxtool
.gitignore
LICENSE.md
README.md
pom.xml

README.md

osmgpxfilter

osmgpxfilter is a tool to extract data from the gpx-planet file or its regional extracts and export using one of the following options:

  • (clipped) gpx planet-extract (tar.xz archive)
  • export Postgresql/PostGIS database (3D Points / 3D MultiLineString)
  • export to as ESRI shapefile (3D Points) The data can be filtered by bounding box and/or by checking whether an elevation attribute is existing in the track

Getting started

  1. install maven
  2. install git
  3. clone project $ git clone https://github.com/GIScience/osmgpxfilter
  4. go into project directory $ cd osmgpxfilter/
  5. run maven $ mvn clean package
  6. start application java -jar target/osmgpxfilter-0.1.jar <args>

Usage

 -bbox,--bounding-box <left=x.x> <right=x.x> <top=x.x> <bottom=x.x>                       specifies bounding box
 -c,--Clip                                                                                Clip GPS traces at bounding box. This option is only applied for PQSql and Shape output.
 -e,--elevation                                                                           only use GPX-files if they have elevation information
 -h,--help                                                                                displays help
 -i,--input                                                                               path to gpx-planet.tar.xz
 -ds,--datasource [dump,scrape,both] 													  "dump": only use specified dump,
 																						  "scrape": only scrape OSM public trace list,                                                                                                       
                                                                                          "both": use dump and retrieve additional traces from public 																						  																						  trace list
 -wd,--write-dump <path to output.tar.xz>                                                 path to output dump file (gpx-planet.tar.xz)
 -wpg,--write-pqsql <db=gis> <user=gisuser> <password=xxx> <host=localhost> <port=5432> <geometry=[point,linestring]>   connection parameters for database
 -ws,--write-shape <path to output shape file>                                            path to output shape file


Example java -jar target/osmgpxfilter-0.1.jar -bbox top=49.42 left=8.64 bottom=49.39 right=8.72 -c -i C:\input.tar.xz -ds dump -e -wpg db=gpxdatabase user=postgres password=xxx host=localhost port=5432 geometry=linestring

Citation

When using this software for scientific purposes, please cite:

John, S., Hahmann, S., Rousell, A., Loewner, M., Zipf, A. (2016): Deriving incline values for street networks from voluntarily collected GPS traces. Cartography and Geographic Information Science (CaGIS). Taylor & Francis. http://dx.doi.org/10.1080/15230406.2016.1190300 (author manuscript: http://koenigstuhl.geog.uni-heidelberg.de/publications/2016/Hahmann/John_et_al_2016.pdf, version as accepted).

/*|----------------------------------------------------------------------------------------------
*|														Heidelberg University
*|	  _____ _____  _____      _                     	Department of Geography		
*|	 / ____|_   _|/ ____|    (_)                    	Chair of GIScience
*|	| |  __  | | | (___   ___ _  ___ _ __   ___ ___ 	(C) 2014
*|	| | |_ | | |  \___ \ / __| |/ _ \ '_ \ / __/ _ \	
*|	| |__| |_| |_ ____) | (__| |  __/ | | | (_|  __/	Berliner Strasse 48								
*|	 \_____|_____|_____/ \___|_|\___|_| |_|\___\___|	D-69120 Heidelberg, Germany	
*|	        	                                       	http://www.giscience.uni-hd.de
*|								
*|----------------------------------------------------------------------------------------------*/
You can’t perform that action at this time.