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 for each constellation by acquisition date. Even though the basemap is regularly updated with recent images, older images can still be be retrieved using individual images endpoints.

Retrieve Current Basemap Endpoints

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

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 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.