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

Coverage API call

• This API provides the details on the available coverage for the requested area.
• The area is given bounding box, defined by a point and a distance from the point.
• This is separate from the existing Coverage APIs.
• The Coverage call creates a transaction token that should be used to retrieve the image.

API URL format

https://api.nearmap.com/staticmap/v2/coverage.json?point={x},{y}&radius={radiusMetres}&apikey={YOUR_API_KEY}

Read the coverage response

The transaction token encodes the user credentials and restricts the image to be returned for the same area as the one requested by the coverage request.

IMPORTANT: Keep your Transaction Token in a safe place. Persist your token if you want to reuse it and download multiple images.