Language

Search

DELETED

You can can download our new streaming process user guide here while the documentation update on this portal is in progress

OneAtlas Basemap is built using acquired images ordered first by constellation (Pléiades then SPOT) and then for each constellation by acquisition date. Our OneAtlas Basemap APIs provide easy methods to search the acquired images which used to generate the OneAtlas Basemap.

Endpoint

Below shows the endpoint to perform a OneAtlas Basemap search:

API Endpointhttps://view.geoapi-airbusds.com/api/v1/images
REST verbGET / POST
Authenticationyour Basemap API Key
API ReferenceSearch API

Geographical Filters

The OneAtlas Basemap API allows you to search using a bounding box with the /images endpoint. The box is defined by “west, south, east, north” coordinates of longitude, latitude, in a EPSG:4326 decimal degrees.


Here we will demonstrate an example of searching for images within San Francisco Airport:

curl -X GET -H "Authorization: Bearer <access_token>" \
   -H "Cache-Control: no-cache" \
   "https://view.geoapi-airbusds.com/api/v1/images?bbox=-122.385946512222,37.6203332456312,-122.382202148437,37.6176733171484&size=999999"

Results

{
    "last": true,
    "sort": [
        {
            "direction": "DESC",
            "property": "acquisitionDate"
        }
    ],
    "type": "FeatureCollection",
    "totalPages": 1,
    "startIndex": 1,
    "size": 5000,
    "first": true,
    "itemsPerPage": 5000,
    "features": [
        {
            "id": "00bb3352aa82a4510baafdbadd7621d1883cbfce",
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    ...
                ]
            },
            "properties": {
                "ags": "https://view.geoapi-airbusds.com/api/v1/map/images/00bb3352aa82a4510baafdbadd7621d1883cbfce.ags/soap/services",
                "agsRest4326": "https://view.geoapi-airbusds.com/api/v1/map/images/00bb3352aa82a4510baafdbadd7621d1883cbfce.ags/4326/rest/services/MapServer",
                "wmts": "https://view.geoapi-airbusds.com/api/v1/map/images/00bb3352aa82a4510baafdbadd7621d1883cbfce.wmts",
                "wms": "https://view.geoapi-airbusds.com/api/v1/map/images/00bb3352aa82a4510baafdbadd7621d1883cbfce.wms",
                "viewingAngle": null,
                "incidenceAngle": 6.61105185641899,
                "illuminationElevationAngle": 51.22716183593177,
                "kml": "https://view.geoapi-airbusds.com/api/v1/map/images/00bb3352aa82a4510baafdbadd7621d1883cbfce.kml",
                "satellite": "Pleiades 1A",
                "wmtsUrl": "https://view.geoapi-airbusds.com/api/v1/map/preview/00bb3352aa82a4510baafdbadd7621d1883cbfce/{z}/{y}/{x}",
                "resolution": 0.5,
                "insertionDate": "2018-09-26T08:54:32.490000+00:00",
                "vehicle": "Pleiades 1A",
                "azimuthAngle": 40.81340643821625,
                "creationDate": "2018-09-26T08:54:32.490000+00:00",
                "cloudCover": 0,
                "bbox": [
                    -122.61005555555549,
                    37.55379629626887,
                    -122.38165740738907,
                    37.89662037037037
                ],
                "acquisitionDate": "2018-09-19T19:04:49.600000+00:00",
                "illuminationAzimuthAngle": 155.7433722383768,
                "constellation": "Pleiades"
            }
        },
        ...
        {
            "id": "52a6130078a2463bee91550d9cc595a09f2ca4a2",
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [...]
                ]
            },
            "properties": {
                "ags": "https://view.geoapi-airbusds.com/api/v1/map/images/52a6130078a2463bee91550d9cc595a09f2ca4a2.ags/soap/services",
                "agsRest4326": "https://view.geoapi-airbusds.com/api/v1/map/images/52a6130078a2463bee91550d9cc595a09f2ca4a2.ags/4326/rest/services/MapServer",
                "wmts": "https://view.geoapi-airbusds.com/api/v1/map/images/52a6130078a2463bee91550d9cc595a09f2ca4a2.wmts",
                "wms": "https://view.geoapi-airbusds.com/api/v1/map/images/52a6130078a2463bee91550d9cc595a09f2ca4a2.wms",
                "viewingAngle": null,
                "incidenceAngle": 15.89712895431384,
                "illuminationElevationAngle": 54.60668400339697,
                "kml": "https://view.geoapi-airbusds.com/api/v1/map/images/52a6130078a2463bee91550d9cc595a09f2ca4a2.kml",
                "satellite": "Pleiades 1A",
                "wmtsUrl": "https://view.geoapi-airbusds.com/api/v1/map/preview/52a6130078a2463bee91550d9cc595a09f2ca4a2/{z}/{y}/{x}",
                "resolution": 0.5,
                "insertionDate": "2018-09-13T20:16:22.654000+00:00",
                "vehicle": "Pleiades 1A",
                "azimuthAngle": 102.76809819633122,
                "creationDate": "2018-09-13T20:16:22.654000+00:00",
                "cloudCover": 0,
                "bbox": [
                    -122.41824537037031,
                    37.54962499998492,
                    -122.17532870368422,
                    37.73819444444445
                ],
                "acquisitionDate": "2018-09-07T18:57:27.400000+00:00",
                "illuminationAzimuthAngle": 148.8645615091253,
                "constellation": "Pleiades"
            }
        },
    ],
    "query": {
        "criteria_endpoint": "https://api-h5p9/api/v1/images/criteria",
        "xuid": "exists()",
        "criteria_ids": "{cf12972a-4f20-11e6-b6b5-b384084f60e5}",
        "count": "999999",
        "sortKeys": "constellation,1 acquisitionDate,0",
        "geometry": "POLYGON ((-122.3822021484370026 37.6203332456312012, -122.3822021484370026 37.6176733171484017, -122.3859465122220058 37.6176733171484017, -122.3859465122220058 37.6203332456312012, -122.3822021484370026 37.6203332456312012))",
        "pw": "1"
    },
    "totalResults": 10,
    "numberOfElements": 10,
    "totalElements": 10,
    "id": "fc0170c2-613c-4118-b727-921dfb24d5fc",
    "number": 1
}

You will notice for each resulting image, the API provides an identifier:

 {
            "id": "52a6130078a2463bee91550d9cc595a09f2ca4a2",
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [...]
            ...
            }
  }

OneAtlas Basemap keeps an archive of all images previously used. Within this example of ten images, the first result will be the image used for the current OneAtlas Basemap, while the other nine results will be previously archived images.


A search response body contains the following components for each feature:

  • geometry : Represents the footprint of the image. It’s a GeoJSON Polygon in WGS84 coordinates that represents the geographic area used in the basemap.
  • properties : Contains detailed metadata of the image. The most meaningful data is displayed in the table below.

Let’s look at some of the parameters in more detail:

Field nameDescription
idUnique identifier of the image within OneAtlas Basemap
acquisitionDateCorresponds to he acquisition date of the image
cloudCoverCorrespond to the average cloud coverage of an image, 0 meaning that the image is cloud free and 100 that the image is totally cloudy
constellationName of the constellation, in the case of OneAtlas Data this value could be equal to SPOT of Pléiades
incidenceAngleThe incidence angle is the angle from the target point of view. It represents the angle between the ground normal and look direction from the satellite, combining the pitch and roll angles.
resolutionThis corresponds to the satellite used. 0.5 for Pléiades and 1.5 for SPOT.
Contact Us