Use this API to access to a subset of Nearmap 3D content, namely the Digital Surface Model and the True Ortho

Overview

The DSM and True Ortho API provides access to a subset of Nearmap 3D content, namely the Digital Surface Model and the True Ortho. Additionally, users of the API can access Nearmap's vertical content. This API is designed to work with smaller areas, such as typical residential and small commercial properties. For such small areas, this API provides low latency access, typically completed in under a second.

Before you start

The DSM and True Ortho API requires a special 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 license.

Your Nearmap administrator needs to do this for you by following the steps in this article: Manage Subscriptions.

Validity and Usage

The coverage response provides a Transaction Token. This token is valid 30 days form the coverage call.
Once you've successfully requested the first image, this is counted against your monthly transaction allowance. You can subsequently make multiple calls to retrieve DSM/TrueOrtho/Vertical imagery within the original Area of Interest (AOI) without being charged, until the Transaction Token expires.

Service Limits

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

	Value	Description
Maximum Image Width/Height	5000px	Returned images may be at most 5000px on either side
Maximum radius	100m	A maximum radius of 100 m implies a maximum 200x200 m
Maximum rate limit	As per response headers	The 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 validity	30 days	Transactions expire 30 days after the transaction token is issued
Available content types	- DSM - True Ortho - Vertical