Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/resource-watch/adapter-earth-engine
Google Earth Engine Adapter
https://github.com/resource-watch/adapter-earth-engine
Last synced: 1 day ago
JSON representation
Google Earth Engine Adapter
- Host: GitHub
- URL: https://github.com/resource-watch/adapter-earth-engine
- Owner: resource-watch
- Created: 2017-01-11T14:23:30.000Z (almost 8 years ago)
- Default Branch: dev
- Last Pushed: 2024-01-24T09:09:15.000Z (10 months ago)
- Last Synced: 2024-06-11T17:17:58.904Z (5 months ago)
- Language: Python
- Homepage:
- Size: 177 KB
- Stars: 3
- Watchers: 8
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Google Earth Engine Adapter Microservice
[](https://travis-ci.com/resource-watch/adapter-earth-engine)
[](https://codeclimate.com/github/resource-watch/adapter-earth-engine/test_coverage)
This repository implements the Google Earth Engine Adapter services that are available in the Resource Watch API.
If you are looking for the API Doc (Info and Usage) please go to the next link:
[View the documentation for this
API] ()(NOT YET)
## Dependencies
Dependencies on other Microservices:
- [Geostore](https://github.com/gfw-api/gfw-geostore-api)
- [GFW OGR](https://github.com/gfw-api/gfw-ogr-api)
## Quick Overview
### Create a GEE Dataset
To create a new GEE dataset it's necessary to execute the following request.
Important:
- the connectorType value has to be "rest"
- the provider value has to be "gee"
```
POST: /dataset -> payload:
{
"dataset": {
"application": [],
"name": ,
"connectorType": "rest",
"provider": "gee",
"tableName":
}
}
```
### Example (copy&paste)
```
POST: https://staging-api.globalforestwatch.org/dataset -> payload:
{
"dataset": {
"application": ["rw"],
"name": "Data about whatever",
"connectorType": "rest",
"provider": "gee",
"tableName": "ft:1qpKIcYQMBsXLA9RLWCaV9D0Hus2cMQHhI-ViKHo"
}
}
```
Once the dataset has been saved (a few seconds after the creation) you can start doing queries to GEE.
### Fields
This endpoint returns the available fields in the dataset
```
GET: /fields/:dataset
```
Example (copy&paste)
```
GET: https://staging-api.globalforestwatch.org/fields/68353d61-0f47-4836-9699-72e008cd9f5f
```
### Query
This endpoint returns the execution of the SQL query (sql queryParam is required)
```
GET: /query/:dataset?sql=
```
Example (copy&paste)
```
GET: https://staging-api.globalforestwatch.org/query/68353d61-0f47-4836-9699-72e008cd9f5f?sql=select * from ft:1qpKIcYQMBsXLA9RLWCaV9D0Hus2cMQHhI-ViKHo where width > 100
```
### Download
Download the data in json format (csv coming soon)
```
GET: /download/:dataset?sql=
```
Example (copy&paste)
```
GET: https://staging-api.globalforestwatch.org/download/68353d61-0f47-4836-9699-72e008cd9f5f?sql=select * from ft:1qpKIcYQMBsXLA9RLWCaV9D0Hus2cMQHhI-ViKHo where width > 100
```
## Tests
As this microservice relies on Google Earth Engine, tests require a valid `storage.json` or equivalent file.
At the time of this writing, actual tests use mock calls, so the real credential are only needed because Google's
library actually validates the credentials on startup.
Before you run the tests, be sure to install the necessary development libraries, using `pip install -r requirements_dev.txt`.
Actual test execution is done by running the `pytest` executable on the root of the project.