{"id":19881452,"url":"https://github.com/giscience/ohsome-qgis-plugin","last_synced_at":"2025-05-02T14:30:45.742Z","repository":{"id":39965930,"uuid":"379189608","full_name":"GIScience/ohsome-qgis-plugin","owner":"GIScience","description":"ohsome Qgis plugin","archived":false,"fork":false,"pushed_at":"2023-11-09T13:36:37.000Z","size":888,"stargazers_count":6,"open_issues_count":18,"forks_count":1,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-04-09T15:12:03.602Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/GIScience.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2021-06-22T08:03:05.000Z","updated_at":"2023-10-27T12:36:22.000Z","dependencies_parsed_at":"2023-11-06T23:41:07.325Z","dependency_job_id":null,"html_url":"https://github.com/GIScience/ohsome-qgis-plugin","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fohsome-qgis-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fohsome-qgis-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fohsome-qgis-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GIScience%2Fohsome-qgis-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GIScience","download_url":"https://codeload.github.com/GIScience/ohsome-qgis-plugin/tar.gz/refs/heads/main","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:19.597Z","updated_at":"2024-11-12T17:14:20.251Z","avatar_url":"https://github.com/GIScience.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ohsomeTools: ohsome API QGIS Plugin\n\n- [ohsomeTools: ohsome API QGIS Plugin](#ohsometools-ohsome-api-qgis-plugin)\n  * [Functionalities](#functionalities)\n    + [General](#general)\n    + [Customization](#customization)\n  * [Getting Started](#getting-started)\n    + [Prerequisites](#prerequisites)\n    + [Installation](#installation)\n      - [Install via private QGIS repository](#install-via-private-qgis-repository)\n      - [Install manually from GitHub](#install-manually-from-github)\n  * [License](#license)\n  * [Acknowledgements](#acknowledgements)\n  * [Development](#development)\n\n\nPer default the QGIS native temporal feature (version \u003e= 3.14) is activated, if the result contains suitable geometries.\n\nThe Temporal Controller can be accessed via `View` -\u003e `Panels` -\u003e `Temporal Controller`.\n\n![Screenshot](static/ohsome_tab1.png)\n![Screenshot](static/ohsome_tab2.png)\n\n**Note, only QGIS \u003e= v3.14 is supported.**\n\nSet of tools to use the [ohsome API](https://api.ohsome.org) in QGIS.\n\nohsomeTools gives you easy access to the following API endpoints:\n\n- [Elements Aggregation](https://docs.ohsome.org/ohsome-api/stable/endpoints.html#elements-aggregation)\n- [Users Aggregation](https://docs.ohsome.org/ohsome-api/stable/endpoints.html#users-aggregation)\n- [Contributions Aggregation](https://docs.ohsome.org/ohsome-api/stable/endpoints.html#contributions-aggregation)\n- [Elements Extraction](https://docs.ohsome.org/ohsome-api/stable/endpoints.html#elements-extraction)\n- [Elements Full History Extraction](https://docs.ohsome.org/ohsome-api/stable/endpoints.html#elements-full-history-extraction)\n- [Contributions Extraction](https://docs.ohsome.org/ohsome-api/stable/endpoints.html#contributions-extraction)\n\nFor additional information on how to use the individual GUI elements:\n- [Filter](https://docs.ohsome.org/ohsome-api/stable/filter.html)\n- [Grouping](https://docs.ohsome.org/ohsome-api/stable/group-by.html)\n- [Time/Intervals](https://docs.ohsome.org/ohsome-api/stable/time.html)\n\nThe [API Documentation]([API Endpoints](https://docs.ohsome.org/ohsome-api/stable/endpoints.html)) offers plenty of\nresources on how to use the API. You can use the information analog for the QGIS plugin.\n\nIn case of issues/bugs, please use the [issue tracker](https://github.com/GIScience/ohsome-qgis-plugin/issues).\n\nSee also:\n\n- Host your own local [docker instance](https://github.com/GIScience/ohsome-api-dockerized) of the ohsome API for faster\n  usage.\n- Check out the [ohsome dashboard](https://ohsome.org/apps/dashboard) or ohsomeHeX (the\n  [OSM History Explorer](https://ohsome.org/apps/osm-history-explorer)) to get an idea of what is possible by using the\n  ohsome API.\n\n## Functionalities\n\n### General\n\nUse QGIS to query OSM data with defining spatial and temporal requests by using the ohsome API.\n\nThe current state offers only GUI related requests with limited batch functionalities.\n\n### Customization\n\nThe API is free of charge and doesn't require any registration or API-Key.\n\nFor faster results without size or time limits by the public API it is possible to host a private instance by using a\nlocal [Dockerized ohsome API](https://github.com/GIScience/ohsome-api-dockerized).\n\nConfiguration takes place either from the Web menu entry *ohsomeTools* ► *Provider settings*. Or from *Config* button in\nthe GUI.\n\n## Getting Started\n\n### Prerequisites\n\nQGIS version: min. **v3.14**\n\n### Installation\n\n#### Install via QGIS repository\n\nInstall from the QGis-plugin-manager. Just search for ohsomeTools and click install.\n- `Plugins -\u003e Manage and Install Plugins -\u003e Not Installed -\u003e Search for \"OhsomeTools\" -\u003e Click \"Install Plugin\"`\n\n#### Install via private QGIS repository\n\nOpen the repository manager:\n- `Plugins -\u003e Manage and Install Plugins -\u003e Settings -\u003e Scroll down to \"Plugin Repositories\" -\u003e Press Add`\n\nInsert and apply the following details for a new private qgis repository:\n```text\nName: ohsomeTools\nURL: https://raw.githubusercontent.com/GIScience/ohsome-qgis-plugin/main/qgis-private-release.xml\nParameters: Should be at least \"?qgis=3.14\". If it is lower than .14 please upgrade your QGIS.\nAuthentication: Leave empty\nEnabled: Check.\n```\n\nGo to all and search for \"ohsome\". The plugin should appear as \"ohsomeTools\".\nClick and install.\nIf it tells you \"There is a new update available\", just ignore it.\n\n\n\n#### Install manually from GitHub\n\n- [Download](https://github.com/GIScience/ohsome-qgis-plugin/archive/main.zip) ZIP file from GitHub\n- Unzip folder contents and copy `ohsomeTools` folder to:\n    - Linux: `~/.local/share/QGIS/QGIS3/profiles/default/python/plugins`\n    - Windows: `C:\\Users\\USER\\AppData\\Roaming\\QGIS\\QGIS3\\profiles\\default\\python\\plugins`\n    - Mac OS: `Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins`\n\n## License\n\nThis project is published under the GPLv3 license,\nsee [LICENSE.md](https://github.com/GIScience/ohsome-qgis-plugin/blob/master/LICENSE) for details.\n\n## Acknowledgements\n\nThis project was first started by [Julian Psotta](https://github.com/MichaelsJP)\nunder [https://github.com/MichaelsJP/ohsome-qgis-plugin](https://github.com/MichaelsJP/ohsome-qgis-plugin).\n\n## Development\n\nBefore adding new commits make sure pre-commit is installed `https://pre-commit.com#install` and the following commands\nneed to be executed inside the repository:\n\n```\npre-commit clean\npre-commit install\npre-commit install-hooks\n```\n\nBefore committing run the hooks on all files:\n\n```\npre-commit run --all-files\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiscience%2Fohsome-qgis-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiscience%2Fohsome-qgis-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiscience%2Fohsome-qgis-plugin/lists"}