https://github.com/giscience/osmgpxfilter
https://github.com/giscience/osmgpxfilter
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/giscience/osmgpxfilter
- Owner: GIScience
- License: lgpl-3.0
- Created: 2015-01-13T11:07:41.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2018-07-23T06:57:37.000Z (over 7 years ago)
- Last Synced: 2025-07-06T07:09:05.161Z (8 months ago)
- Language: Java
- Size: 91.8 KB
- Stars: 2
- Watchers: 15
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# osmgpxfilter
osmgpxfilter is a tool to extract data from the [gpx-planet file](http://wiki.openstreetmap.org/wiki/Planet.gpx) or its [regional extracts](http://zverik.osm.rambler.ru/gps/files/extracts/index.html) 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 `
### Usage
```
-bbox,--bounding-box 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 dump file (gpx-planet.tar.xz)
-wpg,--write-pqsql connection parameters for database
-ws,--write-shape 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
*|
*|----------------------------------------------------------------------------------------------*/
```