DSM and True Ortho API

The DSM and True Ortho API provides access to a subset of Nearmap 3D content, namely the Digital Surface Model and the True Ortho.

The DSM and True Ortho API provides on-demand access to Nearmap's 3D content, Digital Surface Model (DSM) and True Ortho imagery, as well as standard Vertical imagery, for a user-specified area. The API is optimized for small areas such as residential and small commercial properties, with typical response times under one second.

Subscription

The DSM and True Ortho API requires a subscription. Contact your Nearmap Account Manager for more information. Before you start using your DSM and True Ortho API key, if there are multiple subscriptions on your Nearmap account, you need to ensure that you are allocated the correct subscription.

Your Nearmap administrator needs to do this for you via your subscription. See Manage Subscriptions.

Available content types

  • Digital Surface Model (DSM) - elevation data derived from captured imagery
  • True Ortho - geometrically corrected aerial imagery with no lean or perspective distortion
  • Vertical - standard top-down aerial imagery

Validity and Usage

Requests to this API follow a two-step transaction model:

  1. Request coverage for your area of interest to obtain a Transaction Token. Coverage is called once per AOI. Transaction Tokens are valid for 30 days from the coverage call. Once the first image is successfully retrieved, the transaction is counted against your monthly allowance.
  2. Use the Transaction Token to retrieve DSM, True Ortho, or Vertical imagery. Multiple content-type requests within the same AOI do not incur additional charges until the token expires.

Service Limits

As you use the API, you should be aware of the following limits.

ValueDescription
Maximum image width/height5000pxReturned images may be a maximum of 5000px on either side
Maximum radius100mImplies a maximum AOI of 200x200 m
Maximum rate limitAs per response headersThe API is rate limited and the rate limit is reported via API headers, see the Rate Limiting section in this article for more information.
Maximum transaction validity30 daysTransactions expire 30 days after the transaction token is issued

Available endpoints