Language
OneAtlas Basemap Guide
  1. Access Image
    1. Retrieve Current Basemap Endpoints
    2. Retrieve Individual Images Endpoints

Access Image

OneAtlas Basemap allows you to stream the current basemap layer or individual images. These basemap layers are built using images by ordering them first by constellation (Pléiades then SPOT) and then for each constellation by acquisition date. Even though the basemap is regularly updated with recent images, older images can still be retrieved using individual images endpoints.

Retrieve Current Basemap Endpoints

Each of the supported protocols use a different endpoint to access the imagery. All the endpoints can be found under the maps.imagery.links JSON path within the /me endpoint:

API Endpointhttps://view.geoapi-airbusds.com/api/v1/images
REST verbGET
Authenticationyour Basemap API Key
API Reference[Personal API][api-catalog/oneatlas-basemap/index.html)
curl -X GET -H "Authorization: Bearer <API_KEY>" "https://view.geoapi-airbusds.com/api/v1/me"

An example showing the imagery endpoints is shown below:

{...
  "maps": {...
    "imagery": {
      "id": "...",
      "layers": [
        <LAYER TO STREAM>
      ],
      "links": [
              "links": {
        "ags": "https://view.geoapi-airbusds.com/api/v1/map/imagery.ags/services",
        "agsRestDirect": "https://view.geoapi-airbusds.com/mugg/rest/services/CF69E122-9999-11E6-B6B4-3F1489348498/MapServer",
        "agsSoapDirect": "https://view.geoapi-airbusds.com/mugg/soap/CF69E122-9999-11E6-B6B4-3F1489348498/services",
        "kml": "https://view.geoapi-airbusds.com/api/v1/map/imagery.kml",
        "kmlDirect": "https://view.geoapi-airbusds.com/mugg/kml/CF69E122-9999-11E6-B6B4-3F1489348498",
        "wms": "https://view.geoapi-airbusds.com/api/v1/map/imagery.wms",
        "wmsDirect": "https://view.gRetrieve eoapi-airbusds.com/mugg/wms/CF69E122-9999-11E6-B6B4-3F1489348498?",
        "wmts": "https://view.geoapi-airbusds.com/api/v1/map/imagery.wmts",
        "wmtsDirect": "https://view.geoapi-airbusds.com/mugg/wmts/CF69E122-9999-11E6-B6B4-3F1489348498?"
      }
      ]...
}

An example showing the metadata endpoints is show below:

{...
  "metadata": {
      "id": "CF11E595-9999-11E6-B6B3-0F918242EB09",
      "layers": [
        {
          "id": "59945568-9999-11E7-80B3-424854475111",
          "offerName": "OneLive-Metadata"
        }
      ],
      "links": {
        "ags": "https://view.geoapi-airbusds.com/api/v1/map/imagery-composition-detail.ags/services",
        "agsRestDirect": "https://view.geoapi-airbusds.com/mugg/rest/services/CF11E595-9999-11E6-B6B3-0F918242EB09/MapServer",
        "agsSoapDirect": "https://view.geoapi-airbusds.com/mugg/soap/CF11E595-9999-11E6-B6B3-0F918242EB09/services",
        "kml": "https://view.geoapi-airbusds.com/api/v1/map/imagery-composition-detail.kml",
        "kmlDirect": "https://view.geoapi-airbusds.com/mugg/kml/CF11E595-9999-11E6-B6B3-0F918242EB09",
        "wfs": "https://view.geoapi-airbusds.com/api/v1/map/imagery-composition-detail.wfs",
        "wfsDirect": "https://view.geoapi-airbusds.com/mugg/wfs/885964C9-9999-4DB5-815D-48A01941BF0D?",
        "wms": "https://view.geoapi-airbusds.com/api/v1/map/imagery-composition-detail.wms",
        "wmsDirect": "https://view.geoapi-airbusds.com/mugg/wms/CF11E595-9999-11E6-B6B3-0F918242EB09?",
        "wmts": "https://view.geoapi-airbusds.com/api/v1/map/imagery-composition-detail.wmts",
        "wmtsDirect": "https://view.geoapi-airbusds.com/mugg/wmts/CF11E595-9999-11E6-B6B3-0F918242EB09?"
      }
    }...
}

Retrieve Individual Images Endpoints

You can retrieve your individual images endpoints simply by performing a search. For more information see the Search Guide which demonstrates how you can explore our archive of images within the OneAtlas Basemap.

A snippet of the endpoints taken from a search result is shown below:

   "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",

You can find the full set of results within the Search Guide.

Contact Us