Language
OneAtlas Basemap Guide
  1. Search
    1. Endpoint
    2. Geographical Filters
    3. Results

Search

OneAtlas Basemap is built using acquired images ordered first by constellation (Pléiades then SPOT) and for each constellation by acquisition date. Our APIs provide easy methods to search acquired images which are 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
AuthenticationBearer access token
API ReferenceSearch API

Geographical Filters

The OneAtlas Basemap API allows you to search using bounding box using 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 Pleiades
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 Pleiades and 1.5 for SPOT.