{"id":19881428,"url":"https://github.com/giscience/osmgpxfilter","last_synced_at":"2025-10-25T00:04:32.629Z","repository":{"id":25748396,"uuid":"29186243","full_name":"GIScience/osmgpxfilter","owner":"GIScience","description":null,"archived":false,"fork":false,"pushed_at":"2018-07-23T06:57:37.000Z","size":94,"stargazers_count":2,"open_issues_count":2,"forks_count":2,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-07-06T07:09:05.161Z","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-01-13T11:07:41.000Z","updated_at":"2017-09-24T13:42:05.000Z","dependencies_parsed_at":"2022-08-24T14:13:28.539Z","dependency_job_id":null,"html_url":"https://github.com/GIScience/osmgpxfilter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GIScience/osmgpxfilter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxfilter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxfilter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxfilter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxfilter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GIScience","download_url":"https://codeload.github.com/GIScience/osmgpxfilter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fosmgpxfilter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266405405,"owners_count":23923536,"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","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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:13.543Z","updated_at":"2025-10-16T17:51:21.074Z","avatar_url":"https://github.com/GIScience.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# osmgpxfilter\nosmgpxfilter 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:\n- (clipped) gpx planet-extract (tar.xz archive)\n- export Postgresql/PostGIS database (3D Points / 3D MultiLineString) \n- export to as ESRI shapefile (3D Points)\nThe data can be filtered by bounding box and/or by checking whether an elevation attribute is existing in the track\n\n### Getting started\n\n1. install maven\n2. install git\n3. clone project `$ git clone https://github.com/GIScience/osmgpxfilter`\n4. go into project directory `$ cd osmgpxfilter/`\n5. run maven `$ mvn clean package`\n6. start application `java -jar target/osmgpxfilter-0.1.jar \u003cargs\u003e`\n\n### Usage\n```\n -bbox,--bounding-box \u003cleft=x.x\u003e \u003cright=x.x\u003e \u003ctop=x.x\u003e \u003cbottom=x.x\u003e                       specifies bounding box\n -c,--Clip                                                                                Clip GPS traces at bounding box. This option is only applied for PQSql and Shape output.\n -e,--elevation                                                                           only use GPX-files if they have elevation information\n -h,--help                                                                                displays help\n -i,--input                                                                               path to gpx-planet.tar.xz\n -ds,--datasource [dump,scrape,both] \t\t\t\t\t\t\t\t\t\t\t\t\t  \"dump\": only use specified dump,\n \t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t  \"scrape\": only scrape OSM public trace list,                                                                                                       \n                                                                                          \"both\": use dump and retrieve additional traces from public \t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t  \t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t  trace list\n -wd,--write-dump \u003cpath to output.tar.xz\u003e                                                 path to output dump file (gpx-planet.tar.xz)\n -wpg,--write-pqsql \u003cdb=gis\u003e \u003cuser=gisuser\u003e \u003cpassword=xxx\u003e \u003chost=localhost\u003e \u003cport=5432\u003e \u003cgeometry=[point,linestring]\u003e   connection parameters for database\n -ws,--write-shape \u003cpath to output shape file\u003e                                            path to output shape file\n\n\nExample 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\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%2Fosmgpxfilter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiscience%2Fosmgpxfilter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiscience%2Fosmgpxfilter/lists"}