{"id":19881427,"url":"https://github.com/giscience/osmgpxmapmatcher","last_synced_at":"2026-03-02T18:11:05.637Z","repository":{"id":27725594,"uuid":"31212983","full_name":"GIScience/osmgpxmapmatcher","owner":"GIScience","description":null,"archived":false,"fork":false,"pushed_at":"2016-06-24T14:23:26.000Z","size":34,"stargazers_count":9,"open_issues_count":0,"forks_count":4,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-04-09T15:12:04.653Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GIScience.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-23T15:04:46.000Z","updated_at":"2022-02-18T06:54:27.000Z","dependencies_parsed_at":"2022-09-03T03:43:29.248Z","dependency_job_id":null,"html_url":"https://github.com/GIScience/osmgpxmapmatcher","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxmapmatcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxmapmatcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxmapmatcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxmapmatcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GIScience","download_url":"https://codeload.github.com/GIScience/osmgpxmapmatcher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224315203,"owners_count":17290992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T17:14:12.976Z","updated_at":"2026-03-02T18:11:05.589Z","avatar_url":"https://github.com/GIScience.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OsmGpxMapMatcher\nosmgpxmapmatcher 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.\nThe result will be written in a new table, referencing the unique identifiers of streets and GPS trace data sets. \nTo adjust the standard schema of the input tables, the properties file matching.properties needs to be changed. \n\n Until now, it uses following matching algorithm:\n\n- look for candidate traces intersecting a buffer of a street segment\n- create profile lines (perpendicular line) with a given length add each node of a street \n- condition: if 70% of the profile lines are intersected by the GPS Trace, the street and GPS trace are considered as matched:\n\n### Requirements\n- The input geometries must be in WGS84 (EPSG:4326)\n- Geometry type of GPS-traces: MultiLineString\n- Geometry type of streets: LineString\n\n\n### Getting started\n\n1. install maven\n2. install git\n3. clone project `$ git clone https://github.com/GIScience/osmgpxmapmatcher`\n4. go into project directory `$ cd osmgpxmapmatcher`\n5. if necessary, adjust the properties file in resources/matching.properties\n5. run maven `$ mvn clean package`\n6. start application `java -jar target/osmgpxmapmatcher-0.1.jar \u003cargs\u003e`\n\n### Usage\n```\nHelp:\n -h,--help              displays help\n \nRequired Arguments:\n -D,--database          Name of database\n -PW,--password \u003carg\u003e   Password of DB-User\n -U,--user \u003carg\u003e        Name of DB-Username\n \n Optional Arguments:\n-H,--host \u003carg\u003e        Database host \u003cdefault:localhost\u003e\n -o \u003carg\u003e               Name of output table in database. \u003cdefault:streets_gpx\u003e\n -P,--port \u003carg\u003e        Database port \u003cdefault:5432\u003e\n\n\nExample: java -jar target\\osmgpxmapmatcher-0.1.jar -D osmgpx -U postgres -PW xxx\n\n\n ```\n \n### Citation\n\nWhen using this software for scientific purposes, please cite:\n\nJohn, 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 \u0026 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).\n \n \n ```\n /*|----------------------------------------------------------------------------------------------\n *|\t\t\t\t\t\t\t\t\t\t\t\t\t\tHeidelberg University\n *|\t  _____ _____  _____      _                     \tDepartment of Geography\t\t\n *|\t / ____|_   _|/ ____|    (_)                    \tChair of GIScience\n *|\t| |  __  | | | (___   ___ _  ___ _ __   ___ ___ \t(C) 2014\n *|\t| | |_ | | |  \\___ \\ / __| |/ _ \\ '_ \\ / __/ _ \\\t\n *|\t| |__| |_| |_ ____) | (__| |  __/ | | | (_|  __/\tBerliner Strasse 48\t\t\t\t\t\t\t\t\n *|\t \\_____|_____|_____/ \\___|_|\\___|_| |_|\\___\\___|\tD-69120 Heidelberg, Germany\t\n *|\t        \t                                       \thttp://www.giscience.uni-hd.de\n *|\t\t\t\t\t\t\t\t\n *|----------------------------------------------------------------------------------------------*/\n ```\n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiscience%2Fosmgpxmapmatcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiscience%2Fosmgpxmapmatcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiscience%2Fosmgpxmapmatcher/lists"}