Scenario: Requesting and Using Copernicus Satellite Data

Snap4City provides a generic tool to access and exploit Copernicus Satellite data from IOT App and on Dashboards, see for example:

This tools allows to process Sentinel's satellite from European Union's Earth Observation Programme Copernicus and to create corresponding heatmaps as shown in the example above.

The access to this tool is available only for an Area Manager user.

To exploit the tool it is necessary to request the authorization to access the tool by sending an email to


From top to bottom the following info have to be inserted:

  • Map name: a name to be assigned to the heatmap. It is possible to specify yet existing heatmaps to be updated;
  • Metric name: select the interested metric from the list;
  • Description: a generic description;
  • Location: select at which level the heatmap has to be created. It is possible to specify one of the following: City, Country, State and Postal Code;
  • Location Name: specify here the location. It can be, for example, the name of a City or "Città Metropolitana di Firenze", or "Toscana" as State or "Italy" as Country, etc.;
  • Color Map: from the drop down list, select the corresponding color map to be used for the heatmap visualization;
  • Org: from the drop down list, select the organization in Snap4City to be assigned for the heatmap;
  • From Date - To Date: use these forms to specify the time period of the data to be downloaded. Please note that typically satellite data are updated 1 time per day. If a longer period is specified, all data included in the period will be downloaded and, according to the available data, more heatmaps will be generated covering the specified time period;
  • Length: specify here the dimension in meters of the geographical cluster, for example 700;
  • Write: select to write (1) or not (0) to database the data crawled/processed from Sci-Hub. Value (1) is useful to add the possibility to click in any point in the map and see the corresponding value.

Click Submit button to start the process. In the "Result:" the created token will be shown allowing you to check the process status.

To check the process status go to the following page:

Copy the token in the "Token" form, copy the password and click Submit to check the status. The following results can be shown:

  • completed: 0 = not completed), 1 = completed, -3 = no data found
  • indexed: 1 = indexed, 0  = not indexed

The access to this service is also possible by using microservices via an IOTApp.

To this aim, you have to import the microservices in your IOTApp flow:

1. open an IOTApp and on the top right menu icon, select Import

2. Click on the "S4C Nodes" tab and select the Sci-Hub microservices to be imported. Click the Import button to confim. You have to import one microservice node at a time;

3. You will find the new Sci-Hub microservices in the node list on the left;

4. Now you can use Sci-Hub microservices to build your flow and to create your heatmap, as shown in the following example: