TimeSeriesServiceV11 Resource

Computes times series for a product over a given polygon or point. Polygon queries aggregate all values in the polygon, taking nodata into account. Depending on the product, additional masking rules may be applied. For PROBA-V NDVI:

  • A land/sea mask based on ESA CCI landcover is applied
  • Only clear pixels (according to the status mask layer) are used.
The type of product to work on is specified by 'parametername', valid values are, amongst others:
  • PROBAV_L3_S10_TOC_NDVI_333M
  • CHIRPS_RAINFALL
  • ...
For a complete list of supported product types, check the use the GET /v1.x/ts request.

GET /v1.1/ts

Response Body
media type data type description
application/json LayersResponse (JSON)

Example

Request
GET /v1.1/ts
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "layers" : [ {
    "name" : "...",
    "dates" : [ "...", "..." ],
    "bounds" : {
      "xmin" : 12345.0,
      "ymin" : 12345.0,
      "xmax" : 12345.0,
      "ymax" : 12345.0
    }
  }, {
    "name" : "...",
    "dates" : [ "...", "..." ],
    "bounds" : {
      "xmin" : 12345.0,
      "ymin" : 12345.0,
      "xmax" : 12345.0,
      "ymax" : 12345.0
    }
  } ]
}

POST /v1.1/ts/{productId}/features

Computes a time series of means for a product, for each geometry in a given feature collection. Note: the geometries in the given feature collection should not overlap; if they do, the results for these overlapping polygons will be off.

Request Parameters
name type description default constraints
Accept header    
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded feature collection
Response Body
media type data type description
application/json StreamingOutput (JSON) a time series for each geometry in the collection; the order of the dates is undefined.
application/parquet (custom)

Example

Request
POST /v1.1/ts/{productId}/features
Content-Type: application/json
Accept: application/json

                
...
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{ }

POST /v1.1/ts/{productId}/geometries

Computes a time series of means for a product, for each geometry in a given geometry collection.

Request Parameters
name type description default constraints
Accept header    
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded geometry collection
Response Body
media type data type description
application/json StreamingOutput (JSON) a time series for each geometry in the collection; the order of the dates is undefined.
application/parquet (custom)

Example

Request
POST /v1.1/ts/{productId}/geometries
Content-Type: application/json
Accept: application/json

                
...
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{ }

POST /v1.1/ts/{productId}/geometry

Computes a mean time series given a geometry and a product.

Request Parameters
name type description default constraints
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded geometry

Example

Request
POST /v1.1/ts/{productId}/geometry
Content-Type: application/json

                
...
Response
HTTP/1.1 201 Created

GET /v1.1/ts/{productId}/point

Computes a time series given a coordinate and a product.

Request Parameters
name type description default constraints
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
lat query   double
lon query   double
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int

Example

Request
GET /v1.1/ts/{productId}/point
Content-Type: */*

                
...
Response
HTTP/1.1 200 OK

GET /v1.1/ts/{productId}/test

Request Parameters
name type description
productId path
Response Body
media type data type description
application/json string (JSON)

Example

Request
GET /v1.1/ts/{productId}/test
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...

POST /v1.1/ts/{productId}/features/histogram

Computes a time series of histograms for a product, for each geometry in a given feature collection. Note: the geometries in the given feature collection should not overlap; if they do, the results for these overlapping polygons will be off.

Request Parameters
name type description default constraints
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded feature collection
Response Body
media type data type description
application/json StreamingOutput (JSON) a time series of histograms for each geometry in the collection; the order of the dates is undefined.

Example

Request
POST /v1.1/ts/{productId}/features/histogram
Content-Type: application/json
Accept: application/json

                
...
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{ }

POST /v1.1/ts/{productId}/geometries/histogram

Computes a time series of histograms for a product, for each geometry in a given geometry collection.

Request Parameters
name type description default constraints
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded geometry collection
Response Body
media type data type description
application/json StreamingOutput (JSON) a time series for each geometry in the collection; the order of the dates is undefined.

Example

Request
POST /v1.1/ts/{productId}/geometries/histogram
Content-Type: application/json
Accept: application/json

                
...
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{ }

POST /v1.1/ts/{productId}/geometry/cv

Computes a coefficient of variation time series given a geometry and a product.

Request Parameters
name type description default constraints
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded geometry

Example

Request
POST /v1.1/ts/{productId}/geometry/cv
Content-Type: application/json

                
...
Response
HTTP/1.1 201 Created

POST /v1.1/ts/{productId}/geometry/histogram

Computes a histogram time series given a geometry and a product.

Request Parameters
name type description default constraints
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded geometry

Example

Request
POST /v1.1/ts/{productId}/geometry/histogram
Content-Type: application/json

                
...
Response
HTTP/1.1 201 Created

POST /v1.1/ts/{productId}/geometry/multiband

Computes a mean time series given a geometry and a multiband product.

Request Parameters
name type description default constraints
productId path Product identifier    
endDate query (Optional) "yyyy-MM-dd" maximum date of the time series (inclusive) 2099-01-01  
startDate query (Optional) "yyyy-MM-dd": minimum date of the time series (inclusive) 1970-01-01  
zoom query 2147483647 int
Request Body
media type data type description
application/json string (JSON) the GeoJSON encoded geometry

Example

Request
POST /v1.1/ts/{productId}/geometry/multiband
Content-Type: application/json

                
...
Response
HTTP/1.1 201 Created