SAP Earth Observation Analysis Microservices on YaaS
Introducing SAP Earth Observation Analysis for everyone..
It is planned to be generally available in the first quarter of 2017 with a new set of features. It will then be offered with a consumption-based pricing model. A set of related micro-services powered by SAP HANA will help entrepreneurs, partners, customers and businesses augment and build highly flexible solutions based on Earth observation data from European Space Agency (ESA).
At the moment, it can be used to:
- Access Copernicus Sentinel-2 data
- Browse through a catalog of historical and real-time satellite images
- Get metadata about specific satellite images
- Filter satellite images by time and space conditions
- Calculate classic RGB images of specific satellite images
- Calculate the NDVI based on specific satellite images
- Download geo-referenced images
The following describes the steps to use the SAP Earth Observation Analysis service:
- Sign In under My Account on YaaS. If not a member, you will need to Register under My Account on YaaS. It is free.
- Go to the YaaS Market and choose the option Worldwide (Beta) at the top-right corner of the window. Scroll down and click on the SAP Earth Observation Analysis package.
- Once the request for subscription is made, create a project for the organization to subscribe to a package. Enter the display name of the project as you want it to display in the Builder. The project identifier is a unique identifier.
- Click on the yellow API CONSOLE button in the API Docs page of SAP Earth Observation Analysis.
- Click on the blue GET button beside /wcs/getCapabilities.
- Click on the blue Try It tab.
- Open a new browser tab and follow the instructions how to “Create a Client” here. Choose the scope as sap.eoa_service and region as US. Click on the yellow Generate button to generate the authorization token.
- Paste your authorization token from the step before into the Authorization field. Remark: Make sure that the “Bearer” prefix is not lost. Then click on the blue GET.
- Scroll down to see the response.
- Celebrate your first SAP Earth Observation Analysis microservice experience on YaaS!
Getting Started using Curl:
This section describes how to use the SAP Earth Observation Analysis service via curl from your terminal. The alternative to query the offered service API as explained in Step 5 in the previous section, can be done by the following URL:
curl -H "Authorization: Bearer ACCESS_TOKEN" -X GET https://api.yaas.io/sap/earth-analysis/v1/wcs/getCapabilities
The authorization token as explained in Step 7 in previous section, can be generated alternatively by querying the following URL:
curl -X POST 'https://api.beta.yaas.io/hybris/oauth2/v1/token' -d \ 'grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET&scope=SERVICE_SCOPE' \ -H 'content-type: application/x-www-form-urlencoded'
More information about it can be found here. The CLIENT_ID and CLIENT_SECRET are the ones obtained from Step 7 in the previous section. The SERVICE_SCOPE needs to be replaced with sap.eoa_service as already discussed. Please note that the ACCESS_TOKEN (authorization token) expires in 3,600 seconds (1 hour). However, you may generate an arbitrary number of access tokens. An example output is as follows:
It is suggested to use curl to return an image using wcs/getCoverage. For instance, it can be done by the following URL, where, coverageId is the parameter for wcs/getCoverage as explained in the API reference tutorial:
curl -H "Authorization: Bearer ACCESS_TOKEN" -X GET https://api.yaas.io/sap/earth-analysis/v1/wcs/getCoverage?coverageId=COLORED_NDVI_ESAS2_T30NWN_S2A_OPER_PRD_MSIL1C_PDMC_20161121T222316_R108_V20161121T103332_20161121T103332 > image.tiff
The response for the above query is the following Geo-TIFF image:
Now that you have got started with YaaS, refer to Port of Antwerp from space perspective for an interesting beginners tutorial.
What is a microservice?
Microservices are small, independent processes that communicate with each other to form complex applications which utilize language-agnostic APIs. These services are small building blocks, highly decoupled and focused on doing a small task, facilitating a modular approach to system-building. [Source: Stackexchange.com]
Why SAP Hybris as a Service (YaaS)?
YaaS is a microservices platform that allows everyone to develop, extend, sell and consume microservices that make rich application development simpler. The platform is open so organizations can have the option to develop in a wide variety of programming languages and is reachable via multiple clouds including SAP HANA Cloud Platform (HCP).
This open framework ensures:
- Autonomy – each service is independent from each other
- Reusability – services can be deployed in any combination
- Scalability – elastically scale during workload spikes
- Flexibility – change and add functionality easily
Where is the YaaS Market available?
As commercial offerings (i.e. services for production) they are currently offered in the United States and Germany. UK and Switzerland will soon follow with other countries online for 2017. However, it’s possible to build proof of concepts outside of these territories.
No License? No Problem!
If you are not a licensed SAP customer, it’s not a problem. Any user can sign a standard contract and billing is via credit card on a monthly basis. Services are priced based on usage – you only get billed for the bandwidth of information sent, i.e. the volume of input data processed. Cancel your subscription at any time.