https://github.com/giscience/osmgpxmapmatcher
https://github.com/giscience/osmgpxmapmatcher
Last synced: 9 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/giscience/osmgpxmapmatcher
- Owner: GIScience
- License: lgpl-3.0
- Created: 2015-02-23T15:04:46.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2016-06-24T14:23:26.000Z (over 9 years ago)
- Last Synced: 2024-04-09T15:12:04.653Z (almost 2 years ago)
- Language: Java
- Size: 33.2 KB
- Stars: 9
- Watchers: 16
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# OsmGpxMapMatcher
osmgpxmapmatcher is a tool to find corresponding GPS traces of street segments. The streets and GPS traces to be matched, need to be stored in a PostgreSQL/PostGIS database. [osmgpxfilter](https://github.com/GIScience/osmgpxfilter) can be used to import the GPS-traces into the database.
The result will be written in a new table, referencing the unique identifiers of streets and GPS trace data sets.
To adjust the standard schema of the input tables, the properties file matching.properties needs to be changed.
Until now, it uses following matching algorithm:
- look for candidate traces intersecting a buffer of a street segment
- create profile lines (perpendicular line) with a given length add each node of a street
- condition: if 70% of the profile lines are intersected by the GPS Trace, the street and GPS trace are considered as matched:
### Requirements
- The input geometries must be in WGS84 (EPSG:4326)
- Geometry type of GPS-traces: MultiLineString
- Geometry type of streets: LineString
### Getting started
1. install maven
2. install git
3. clone project `$ git clone https://github.com/GIScience/osmgpxmapmatcher`
4. go into project directory `$ cd osmgpxmapmatcher`
5. if necessary, adjust the properties file in resources/matching.properties
5. run maven `$ mvn clean package`
6. start application `java -jar target/osmgpxmapmatcher-0.1.jar `
### Usage
```
Help:
-h,--help displays help
Required Arguments:
-D,--database Name of database
-PW,--password Password of DB-User
-U,--user Name of DB-Username
Optional Arguments:
-H,--host Database host
-o Name of output table in database.
-P,--port Database port
Example: java -jar target\osmgpxmapmatcher-0.1.jar -D osmgpx -U postgres -PW xxx
```
### 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
*|
*|----------------------------------------------------------------------------------------------*/
```