{"id":13491191,"url":"https://github.com/missinglink/pbf","last_synced_at":"2025-10-14T17:26:18.849Z","repository":{"id":48338620,"uuid":"83022881","full_name":"missinglink/pbf","owner":"missinglink","description":"utilities for parsing OpenStreetMap PBF files and extracting geographic data","archived":false,"fork":false,"pushed_at":"2024-07-22T09:32:34.000Z","size":847,"stargazers_count":21,"open_issues_count":10,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-13T23:38:12.151Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/missinglink.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["missinglink"]}},"created_at":"2017-02-24T09:07:09.000Z","updated_at":"2024-06-08T20:22:12.000Z","dependencies_parsed_at":"2024-10-25T17:50:02.647Z","dependency_job_id":"672d384d-c7ee-48e0-911d-6e50d93203fd","html_url":"https://github.com/missinglink/pbf","commit_stats":{"total_commits":82,"total_committers":4,"mean_commits":20.5,"dds":"0.060975609756097615","last_synced_commit":"04d4fff63f5e72e469a55a4769fe20f74589748d"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Fpbf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Fpbf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Fpbf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Fpbf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/missinglink","download_url":"https://codeload.github.com/missinglink/pbf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234970026,"owners_count":18915304,"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-07-31T19:00:54.399Z","updated_at":"2025-10-14T17:26:13.817Z","avatar_url":"https://github.com/missinglink.png","language":"Go","funding_links":["https://github.com/sponsors/missinglink"],"categories":["Software Tools"],"sub_categories":[],"readme":"\nutilities for parsing OpenStreetMap PBF files and extracting geographic data\n\n### installation\n\n\u003e tested on go version go1.9, recommended go1.10, cross-compilation possibly broken in recent versions of go\n\ngo1.17 and above\n```bash\n$ go install github.com/missinglink/pbf@latest\n```\nbelow go1.17\n```bash\n$ export GO111MODULE=on\n$ go get github.com/missinglink/pbf\n```\n\n### disclaimer\n\nthis repo contains a bunch of experiments including a monkey-patched parsing library, it should be considered as permanently in development.\n\nplease feel free to fork and contribute, at some stage it might reach a level of maturity and stability where it could be published as a more general-purpose tool.\n\n### running the cli\n\n```bash\n$ pbf --help\n\nNAME:\n   pbf - utilities for parsing OpenStreetMap PBF files and extracting geographic data\n\nUSAGE:\n   pbf [global options] command [command options] [arguments...]\n\nVERSION:\n   0.0.0\n\nCOMMANDS:\n     stats                    pbf statistics\n     json                     convert to overpass json format, optionally using bitmask to filter elements\n     json-flat                convert to a json format, compulsorily using bitmask to filter elements and leveldb to denormalize where possible\n     xml                      convert to osm xml format, optionally using bitmask to filter elements\n     opl                      convert to opl, optionally using bitmask to filter elements\n     nquad                    convert to nquad, optionally using bitmask to filter elements\n     cypher                   convert to cypher format used by the neo4j graph database, optionally using bitmask to filter elements\n     sqlite3                  import elements in to sqlite3 database, optionally using bitmask to filter elements\n     leveldb                  import elements in to leveldb database, optionally using bitmask to filter elements\n     genmask                  generate a bitmask file by specifying feature tags to match\n     genmask-boundaries       generate a bitmask file containing only elements referenced by a boundary:administrative relation\n     genmask-super-relations  generate a bitmask file containing only relations which have at least one another relation as a member\n     bitmask-stats            output statistics for a bitmask file\n     store-noderefs           store all node refs in leveldb for records matching bitmask\n     boundaries               write geojson osm boundary files using a leveldb database as source\n     xroads                   compute street intersections\n     streets                  export street segments as merged linestrings, encoded in various formats\n     noderefs                 count the number of times a nodeid is referenced in file\n     index                    index a pbf file and write index to disk\n     index-info               display a visual representation of the index file\n     find                     random access to pbf\n     help, h                  Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --help, -h     show help\n   --version, -v  print the version\n```\n\n### get more detailed information on a specific command\n\n```bash\n$ pbf help stats\n\nNAME:\n   pbf stats - pbf statistics\n\nUSAGE:\n   pbf stats [command options] [arguments...]\n\nOPTIONS:\n   --interval value, -i value  write stats every i milliseconds (default: 0)\n```\n\n### running the tests\n\n```bash\n$ go test $(go list ./... | grep -v /vendor/)\n```\n\n### issues / bugs\n\nplease open a github issue / open a pull request.\n\nif you are planning a non-trivial feature, please open an issue to discuss it first.\n\n### license\n\n```bash\nThe MIT License (MIT)\n\nCopyright (c) 2017, Peter Johnson\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmissinglink%2Fpbf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmissinglink%2Fpbf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmissinglink%2Fpbf/lists"}