{"id":37786578,"url":"https://github.com/johnlettman/overpassql-loader","last_synced_at":"2026-01-16T15:12:58.623Z","repository":{"id":181070533,"uuid":"665740202","full_name":"johnlettman/overpassql-loader","owner":"johnlettman","description":"A webpack loader for OverpassQL files.","archived":false,"fork":false,"pushed_at":"2025-12-01T02:47:54.000Z","size":2828,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-03T13:14:50.738Z","etag":null,"topics":["loader","openstreetmaps","openstreetmaps-api","overpass","webpack","webpack-loader","webpack5"],"latest_commit_sha":null,"homepage":"https://johnlettman.github.io/overpassql-loader/","language":"TypeScript","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/johnlettman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-07-12T22:31:42.000Z","updated_at":"2025-12-01T02:47:51.000Z","dependencies_parsed_at":"2024-01-23T18:29:20.059Z","dependency_job_id":"dbf3d267-5c9d-4e30-b418-d6dbc251e110","html_url":"https://github.com/johnlettman/overpassql-loader","commit_stats":null,"previous_names":["johnlettman/overpassql-loader"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/johnlettman/overpassql-loader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnlettman%2Foverpassql-loader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnlettman%2Foverpassql-loader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnlettman%2Foverpassql-loader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnlettman%2Foverpassql-loader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnlettman","download_url":"https://codeload.github.com/johnlettman/overpassql-loader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnlettman%2Foverpassql-loader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["loader","openstreetmaps","openstreetmaps-api","overpass","webpack","webpack-loader","webpack5"],"created_at":"2026-01-16T15:12:57.870Z","updated_at":"2026-01-16T15:12:58.615Z","avatar_url":"https://github.com/johnlettman.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/webpack/webpack\"\u003e\n    \u003cimg height=\"100\" vspace=\"\" hspace=\"25\"\n      src=\"https://raw.githubusercontent.com/johnlettman/overpassql-loader/main/.github/assets/webpack-icon.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL\"\u003e\n    \u003cimg height=\"100\" vspace=\"\" hspace=\"25\"\n      src=\"https://raw.githubusercontent.com/johnlettman/overpassql-loader/main/.github/assets/overpass-icon.svg\"\u003e\n  \u003c/a\u003e\n  \u003ch1\u003eOverpassQL Loader\u003c/h1\u003e\n\u003c/div\u003e\n\n[![License][shield-license]][url-license]\n[![Package Version][shield-version]][url-npm]\n![Programming Language][shield-language]\n![Minimized Size][shield-minsize]\n![Test Results][shield-test]\n[![Code Coverage][shield-codecov]][url-codecov]\n\nThis Webpack loader allows you to pull in [OverpassQL][url-overpassql] files as\nstrings, providing seamless integration of OpenStreetMap data into your\napplication.\n\n\nNot only does it allow you to directly load OverpassQL scripts as part of\nyour Webpack build process, but it also optionally caches the responses\nfrom an [Overpass API server][url-overpassapi-servers] to speed up your\nproduction application.\n\n## Features\n- Implemented in TypeScript for strong type safety.\n- Load OverpassQL scripts as strings into your JavaScript or TypeScript\n  application.\n- Optionally cache responses from an Overpass API server.\n\n## Installation\nYou can install the loader using `npm`, `yarn`, or your preferred JavaScript\npackage management program.\n\n```bash\nyarn add --dev overpassql-loader\n```\n_or_\n```bash\nnpm install --save-dev overpassql-loader\n```\n\n## Usage\nAdd `overpassql-loader` to your Webpack configuration:\n\n```typescript\nimport type { Configuration, RuleSetUse } from 'webpack';\nimport type { PropertiesFilter } from 'overpassql-loader';\n\nconst IS_DEV: boolean = (process.env.NODE_ENV === 'development');\n\nconst propertiesFilter: PropertiesFilter = (properties) =\u003e ({\n  return (Object.keys(properties)\n    .filter(tag =\u003e /addr:.*/i.test(tag))\n    .reduce((filtered, tag) =\u003e {\n      filtered[tag] = properties[tag];\n      return filtered;\n    }, {}));\n});\n\nconst useOverpassql: RuleSetUse = {\n  test: /\\.overpass(ql)?$/,\n  options: {\n    // minify the query\n    stripWhitespace: !IS_DEV,\n    stripComments: !IS_DEV,\n\n    // cache API response\n    cacheGeoJSON: !IS_DEV,\n\n    // remove tags we're not interested in\n    keepProperties: false,\n    propertiesFilter\n  }\n}\n\nexport const config: Configuration = {\n  module: {\n    rules: [useOverpassql]\n  }\n}\n```\n\nUse the `import` in your project:\n\n```typescript\nimport { overpassJson } from 'overpass-ts';\nimport osmtogeojson from 'osmtogeojson';\nimport query from './my-query.overpassql';\n\nconst endpoint: string = 'https://overpass-api.de/api/interpreter';\n\nconsole.log(query); // print the query to console\noverpassJson(query, { endpoint }).then((osmdata) =\u003e {\n  const geoJSON = osmtogeojson(osmdata);\n\n  // work with the GeoJSON or OSM response\n  // e.g., integrate with Leaflet.js GeoJSON layers\n});\n```\n\n## Contributing\n### General advice\nThe following procedure for contributing changes is recommended:\n- Branch to `fix/[issue or description]`, `feature/[issue or description]`, ...\n- Implement your changes and commit\n- Open a [pull request][url-pr]\n\nOf course, you're welcome to use any reasonable workflow that best suits your\nstyle. After all, I committed to unprotected main throughout this project.\n\nPlease add any of the following strings to your commit message if the commit\ndoes not modify any code (e.g., documentation work):\n\n`[skip ci]`, `[ci skip]`, `[no ci]`, `[skip actions]`, `[actions skip]`\n\nSee: [GitHub documentation, \"skipping workflow runs\"][ghdocs-skip-actions]\n\n### Versioning\nTo bump versions:\n```bash\nyarn version --patch\nyarn version --minor\nyarn version --major\n```\n\n### Licensing\nGiven this project is licensed under the MIT License, please be mindful that\nyour contributions will fall under the same licensing scheme.\n\n## Related Projects \u0026 Dependencies\nThe following projects are core to the function of OverpassQL Loader.\nThey are worth checking out. The authors have my thanks. :-)\n\n### [overpass-ts][repo-overpass-ts]\n\u003e promise-based overpass api client in typescript\n\n- [GitHub Repository][repo-overpass-ts]\n- [NPM Package][npm-overpass-ts]\n\n\n### [osmtogeojson][repo-osmtogeojson]\n\u003e Converts OSM data to GeoJSON.\n\n- [GitHub Repository][repo-osmtogeojson]\n- [NPM Package][npm-osmtogeojson]\n\n\n## License\nThis project is licensed under the MIT License.\nSee `LICENSE` for more information.\n\n\n[url-overpassql]: https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL\n[url-overpassapi-servers]: https://wiki.openstreetmap.org/wiki/Overpass_API#Public_Overpass_API_instances\n\n[repo-overpass-ts]: https://github.com/1papaya/overpass-ts\n[npm-overpass-ts]: https://www.npmjs.com/package/overpass-ts\n\n[repo-osmtogeojson]: https://github.com/tyrasd/osmtogeojson\n[npm-osmtogeojson]: https://www.npmjs.com/package/osmtogeojson\n\n[ghdocs-skip-actions]: https://docs.github.com/en/actions/managing-workflow-runs/skipping-workflow-runs\n\n[url-pr]: https://github.com/johnlettman/overpassql-loader/pulls\n[url-npm]: https://www.npmjs.com/package/overpassql-loader\n[url-license]: https://github.com/johnlettman/overpassql-loader/blob/main/LICENSE\n[url-codecov]: https://codecov.io/gh/johnlettman/overpassql-loader\n\n[shield-license]: https://img.shields.io/npm/l/overpassql-loader?style=for-the-badge\n[shield-version]: https://img.shields.io/npm/v/overpassql-loader?style=for-the-badge\u0026logo=npm\n[shield-language]: https://img.shields.io/github/languages/top/johnlettman/overpassql-loader?style=for-the-badge\u0026logo=typescript\n[shield-minsize]: https://img.shields.io/bundlephobia/min/overpassql-loader?style=for-the-badge\n[shield-test]: https://img.shields.io/github/actions/workflow/status/johnlettman/overpassql-loader/test.yml?style=for-the-badge\u0026logo=github\u0026label=test\n[shield-codecov]: https://img.shields.io/codecov/c/github/johnlettman/overpassql-loader?style=for-the-badge\u0026logo=codecov\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnlettman%2Foverpassql-loader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnlettman%2Foverpassql-loader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnlettman%2Foverpassql-loader/lists"}