GIScience / ohsome-qgis-plugin

ohsome Qgis plugin
MIT License
6 stars 1 forks source link

ohsomeTools: ohsome API QGIS Plugin

Per default the QGIS native temporal feature (version >= 3.14) is activated, if the result contains suitable geometries.

The Temporal Controller can be accessed via View -> Panels -> Temporal Controller.

Screenshot Screenshot

Note, only QGIS >= v3.14 is supported.

Set of tools to use the ohsome API in QGIS.

ohsomeTools gives you easy access to the following API endpoints:

For additional information on how to use the individual GUI elements:

The [API Documentation](API Endpoints) offers plenty of resources on how to use the API. You can use the information analog for the QGIS plugin.

In case of issues/bugs, please use the issue tracker.

See also:

Functionalities

General

Use QGIS to query OSM data with defining spatial and temporal requests by using the ohsome API.

The current state offers only GUI related requests with limited batch functionalities.

Customization

The API is free of charge and doesn't require any registration or API-Key.

For faster results without size or time limits by the public API it is possible to host a private instance by using a local Dockerized ohsome API.

Configuration takes place either from the Web menu entry ohsomeToolsProvider settings. Or from Config button in the GUI.

Getting Started

Prerequisites

QGIS version: min. v3.14

Installation

Install via QGIS repository

Install from the QGis-plugin-manager. Just search for ohsomeTools and click install.

Install via private QGIS repository

Open the repository manager:

Insert and apply the following details for a new private qgis repository:

Name: ohsomeTools
URL: https://raw.githubusercontent.com/GIScience/ohsome-qgis-plugin/main/qgis-private-release.xml
Parameters: Should be at least "?qgis=3.14". If it is lower than .14 please upgrade your QGIS.
Authentication: Leave empty
Enabled: Check.

Go to all and search for "ohsome". The plugin should appear as "ohsomeTools". Click and install. If it tells you "There is a new update available", just ignore it.

Install manually from GitHub

License

This project is published under the GPLv3 license, see LICENSE.md for details.

Acknowledgements

This project was first started by Julian Psotta under https://github.com/MichaelsJP/ohsome-qgis-plugin.

Development

Before adding new commits make sure pre-commit is installed https://pre-commit.com#install and the following commands need to be executed inside the repository:

pre-commit clean
pre-commit install
pre-commit install-hooks

Before committing run the hooks on all files:

pre-commit run --all-files