Skip to content

Latest commit

 

History

History
170 lines (150 loc) · 5.96 KB

search.md

File metadata and controls

170 lines (150 loc) · 5.96 KB

Search API documentation

Open API

The Open API specification can be downloaded or consulted directly in Airbus API Viewer.

Prerequisites

In order to use the Search API you need first to obtain an API key by requesting it to the customer care support or the Contact Us page.

Usage examples

Search and image and retrieve its identifier

This example demonstrate how to find a SPOT image and extract its identifier to be able to order it through the Order API.

First, define your API key so that the example commands can use it:

export MY_API_KEY=***INSERT YOUR API KEY HERE***

You can now request the desired images using a POST search request. Here we request all images that:

  • are in the bounding box 1.18, 43.52, 1.25, 43.56 expressed in geographic coordinates
  • are of type optical
  • were acquired with one of the satellite of the SPOT constellation (i.e. SPOT 1 to 7)
  • were acquired in July 2016
  • have an incidence angle less or equal to 20 degrees
  • have less than 10 percent of it covered by clouds
curl -X POST -H "Authorization: $MY_API_KEY" -H "Content-Type: application/json" -d '{
  "bbox": [
    1.18,
    43.52,
    1.25,
    43.56
  ],
  "sensorType": "optical",
  "constellation": [
    "SPOT"
  ],
  "acquisitionDate": "[2016-07-01,2016-07-31T23:59:59]",
  "incidenceAngle": "20]",
  "cloudCover": "10]",
  "count": 10,
  "startPage": 1
}' "https://search.geoapi-airbusds.com/api/v1/search"

Each mathing image is returned as a GeoJSON feature under the /features[] property. The response should look like:

{
   "totalResults" : 1,
   "itemsPerPage" : 10,
   "type" : "FeatureCollection",
   "features" : [
      {
         "properties" : {
            "sourceId" : "DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140",
            "satellite" : "SPOT7",
            "productName" : "SPOT 1.5-m",
            "provider" : "Airbus Defence and Space",
            "cloudCover" : 1,
            "incidenceAngle" : 19.9324257673857,
            "constellation" : "SPOT",
            "acquisitionDate" : "2016-07-29T10:38:18.749Z",
            "resolution" : 1.5,
            "viewingAngleAcrossTrack" : 17.909748,
            "viewingAngleAlongTrack" : 17.842472
         },
         "id" : "ea1575c9-a4e5-4748-9e1b-fbc37d7286e9::5f08c566-0c5e-4baf-bf66-05d6c530aaf5",
         "thumbnail" : "https://search.geoapi-airbusds.com/api/v1/productTypes/SPOT_1_5/products/DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140?size=SMALL",
         "geometry" : {
            "coordinates" : [
               [
                  [
                     1.00409636794572,
                     43.7046518627418
                  ],
                  [
                     1.83963153029114,
                     43.6915345718161
                  ],
                  [
                     1.84076579791152,
                     43.3869345568225
                  ],
                  [
                     1.0028176461841,
                     43.4014298007982
                  ],
                  [
                     1.00409636794572,
                     43.7046518627418
                  ]
               ]
            ],
            "type" : "Polygon"
         },
         "bbox" : [
            1.0028176461841,
            43.3869345568225,
            1.84076579791152,
            43.7046518627418
         ],
         "quicklooks" : [
            {
               "size" : "SMALL",
               "projection" : null,
               "image" : "https://search.geoapi-airbusds.com/api/v1/productTypes/SPOT_1_5/products/DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140?size=SMALL"
            },
            {
               "projection" : null,
               "image" : "https://search.geoapi-airbusds.com/api/v1/productTypes/SPOT_1_5/products/DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140?size=MEDIUM",
               "size" : "MEDIUM"
            },
            {
               "projection" : "http://www.opengis.net/def/crs/EPSG/0/4326",
               "image" : "https://search.geoapi-airbusds.com/api/v1/productTypes/SPOT_1_5/products/DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140?projection=EPSG:4326&size=MEDIUM",
               "size" : "MEDIUM"
            },
            {
               "size" : "LARGE",
               "image" : "https://search.geoapi-airbusds.com/api/v1/productTypes/SPOT_1_5/products/DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140?size=LARGE",
               "projection" : null
            },
            {
               "projection" : "http://www.opengis.net/def/crs/EPSG/0/3857",
               "image" : "https://search.geoapi-airbusds.com/api/v1/productTypes/SPOT_1_5/products/DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140?projection=EPSG:3857&size=MEDIUM",
               "size" : "MEDIUM"
            }
         ],
         "type" : "Feature"
      }
   ],
   "startIndex" : 1,
   "query" : {
      "cloudCover" : "10]",
      "incidenceAngle" : "20]",
      "acquisitionDate" : "[2016-07-01,2016-07-31T23:59:59]",
      "constellation" : [
         "SPOT"
      ],
      "count" : 10,
      "sensorType" : "optical",
      "bbox" : [
         1.18,
         43.52,
         1.25,
         43.56
      ],
      "startPage" : 1
   }
}

To verify that the image is of the desired quality, you can request one of the quicklooks of it (under /features[]/quicklooks[]). Here we choose to check the LARGE and unprojected quicklook:

curl -X GET -H "Authorization: $MY_API_KEY" "https://search.geoapi-airbusds.com/api/v1/productTypes/SPOT_1_5/products/DS_SPOT7_201607291038129_FR1_FR1_FR1_FR1_E001N44_01140?size=LARGE"

The quicklook should look like the following image:

quicklook