How to Use the API

The DSM and True Ortho API uses the new Staticmap API. The new Staticmap API has a path prefix of /staticmap/v2/. The v2 designation is to distinguish it from the existing legacy staticmap end point.

The sequence of calling the APIs is important and is as follows:

  1. Coverage API call
  2. Read the Survey ID and Transaction Token from the coverage response

Filtering surveys

By adding a filter, you can restrict the surveys that are returned. By retaining the default value of allTypes for the filter parameter, you will retrieve the the most recent survey that contains the requested DSM/ True Ortho imagery as well as Vertical imagery.

Setting this parameter to anyTypes returns the most recent survey with Vertical imagery or the next available survey that has the requested DSM/ True Ortho imagery.

Example

https://api.nearmap.com/staticmap/v2/surveys/dc26410e-6331-11ea-9feb-eb1617c46d8e/TrueOrtho.tif?point=151.0904291%2C-33.724291&radius=100&size=5000x5000&transactionToken={TRANSACTION_TOKEN}

Response

Image requested.

Datum and projection information

DSM and True Ortho content is delivered using the following specifications.

DSMTrue Ortho
ProjectionEPSG:3857 (Web Mercator)EPSG:3857 (Web Mercator)
Horizontal DatumWGS84 (ITRF2014 realization)WGS84 (ITRF2014 realization)
EpochDate of the imagery.
E.g. epoch of imagery captured on June 30 2017 is 2017.492
Date of the imagery.
E.g. epoch of imagery captured on June 30 2017 is 2017.492
Vertical DatumAU: AHD (AusGeoid09)
US: EGM2008
Canada: CGVD2013
N/A