How to Use the API

Instructions for using the DSM and True Ortho 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.

DSM

True Ortho

Projection

EPSG:3857 (Web Mercator)

EPSG:3857 (Web Mercator)

Horizontal Datum

WGS84 (ITRF2014 realization)

WGS84 (ITRF2014 realization)

Epoch

Date 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 Datum

AU: AHD (AusGeoid09)
US: EGM2008
Canada: CGVD2013

N/A