Fork from https://gitlab.com/qgisapi/networkapi. Adding functions for visualization of earth engine tile server in QGIS.
This plugin provides a web service API that exposes QGIS' data processing and canvas drawing functionalities. The plugin provides a way to include QGIS in the data processing workflow of other (‘mapping-deficient’) programming languages over a HTTP interface which mirrors the existing QGIS API, without precluding the ability to make use of its interactive editing components. It is currently under development as part of this Google Summer of Code 2017 project.
The motivation behind this plugin is to make QGIS interface components available and scriptable from other mapping-deficient programming languages, in particular R. Development versions of the corresponding R package making use of this Network API can be found here.
The plugin is currently under development and not available from the QGIS Plugin repository yet. The basic architecture of the plugin is stable though, with most work focussing on adding new functionality. This is how you can try out and help test the current development version of the plugin:
- Install the plugin into your $QGIS_HOME/plugins/ folder, either by
git cloneing this repository or by downloading the latest snapshot as a zip file. - In QGIS (2.*), activate the plugin under Plugins > Manage and Install Plugins > 'Network API'
- The API is disabled by default, but can by activated through the 'Network API' check box in the status bar at the bottom right of the main QGIS window. By default the plugin will listen for requests on port 8090 and only accept local connections. Port and security settings can be changed in the plugin config dialog which can be accessed from the Plugin menu as well as a 'Network API' button added to the QGIS toolbar.
- Once the API is enabled you can submit requests from other clients, for example from
Rusing the qgisremote package. To see what functionalities are exposed by the Network API as well as their documentation, point your browser to http://localhost:8090/api (adjust the port accordingly). Currently implemented requests/paths can also be found in the source file.
Here is just a very limited number of example functionalities of the plugin that can be invoked from a Linux console:
# make sure QGIS Desktop 2.* is running with the Network Plugin enabled, then:
curl --silent http://localhost:8090/qgis/mapLayers## {}
# start a new blank project
curl --silent http://localhost:8090/qgis/newProject## null
# add some vector data from the web
curl --silent 'http://localhost:8090/qgis/addVectorLayer?url=https://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_50m_populated_places.geojson&name=url-layer'## {
## "crs": {
## "postgisSrid": 4326,
## "proj4": "+proj=longlat +datum=WGS84 +no_defs",
## "srsid": 3452,
## "description": "WGS 84"
## },
## "valid": true,
## "name": "url-layer OGRGeoJSON Point",
## "extent": [
## -175.22056447761656,
## -89.99999981438727,
## 179.21664709402887,
## 78.21668438639699
## ],
## "publicSource": "https://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_50m_populated_places.geojson",
## "type": 0,
## "id": "url_layer20170714152153776",
## "isEditable": false
## }
# add another layer as POST data
if [ ! -f "ne_50m_populated_places.geojson" ]; then
wget --no-verbose --no-check-certificate https://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_50m_populated_places.geojson
fi
curl --silent -d @ne_50m_populated_places.geojson http://localhost:8090/qgis/addVectorLayer?name=geojson-layer## {
## "crs": {
## "postgisSrid": 4326,
## "proj4": "+proj=longlat +datum=WGS84 +no_defs",
## "srsid": 3452,
## "description": "WGS 84"
## },
## "valid": true,
## "name": "geojson-layer OGRGeoJSON Point",
## "extent": [
## -175.22056447761656,
## -89.99999981438727,
## 179.21664709402887,
## 78.21668438639699
## ],
## "publicSource": "/tmp/tmpAOnpgE",
## "type": 0,
## "id": "geojson_layer20170714152159798",
## "isEditable": false
## }
# retrieve layer information
curl --silent http://localhost:8090/qgis/mapLayers## {
## "geojson_layer20170714152159798": {
## "crs": {
## "postgisSrid": 4326,
## "proj4": "+proj=longlat +datum=WGS84 +no_defs",
## "srsid": 3452,
## "description": "WGS 84"
## },
## "valid": true,
## "name": "geojson-layer OGRGeoJSON Point",
## "extent": [
## -175.22056447761656,
## -89.99999981438727,
## 179.21664709402887,
## 78.21668438639699
## ],
## "publicSource": "/tmp/tmpAOnpgE",
## "type": 0,
## "id": "geojson_layer20170714152159798",
## "isEditable": false
## },
## "url_layer20170714152153776": {
## "crs": {
## "postgisSrid": 4326,
## "proj4": "+proj=longlat +datum=WGS84 +no_defs",
## "srsid": 3452,
## "description": "WGS 84"
## },
## "valid": true,
## "name": "url-layer OGRGeoJSON Point",
## "extent": [
## -175.22056447761656,
## -89.99999981438727,
## 179.21664709402887,
## 78.21668438639699
## ],
## "publicSource": "https://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_50m_populated_places.geojson",
## "type": 0,
## "id": "url_layer20170714152153776",
## "isEditable": false
## }
## }
curl --silent http://localhost:8090/qgis/mapCanvas/extent## [
## -261.7367641877365,
## -94.20541691940687,
## 265.73284680414883,
## 82.42210149141658
## ]
# adjust view
curl --silent http://localhost:8090/qgis/mapCanvas/zoomToFullExtent## 188518408.41324273
# read current canvas content
wget --no-verbose http://127.0.0.1:8090/qgis/mapCanvas/saveAsImage
file "saveAsImage"## 2017-07-14 15:22:01 URL:http://127.0.0.1:8090/qgis/mapCanvas/saveAsImage [2502] -> "saveAsImage.1" [1]
## saveAsImage: PNG image data, 1093 x 337, 8-bit/color RGBA, non-interlaced
wget --no-verbose http://127.0.0.1:8090/qgis/mapCanvas/saveAsImage?format=jpeg
file "saveAsImage?format=jpeg"## 2017-07-14 15:22:01 URL:http://127.0.0.1:8090/qgis/mapCanvas/saveAsImage?format=jpeg [6975] -> "saveAsImage?format=jpeg.1" [1]
## saveAsImage?format=jpeg: JPEG image data, JFIF standard 1.01, resolution (DPI), density 96x96, segment length 16, baseline, precision 8, 1093x337, frames 3
# retrieve current scale
curl --silent http://localhost:8090/qgis/mapCanvas/scale## 188518408.41324273
# some more canvas manipulation
curl --silent http://localhost:8090/qgis/mapCanvas/zoomIn## 94259204.20662136
curl --silent http://localhost:8090/qgis/mapCanvas/zoomScale?scale=1234567.8## 1234567.7999999993