Transactional Content API

Use the Transactional Content API to access different Nearmap content types.

Overview

The Nearmap Transactional Content API is a single API platform that delivers majority of Nearmap content types, including Vertical, Panorama, DSM, DTM, and AI Packs and charges for them in "Transactional Credits".

You can use the Transactional Content API to:

  • Retrieve imagery or AI features using coordinates (latitude and longitude) or address
  • View additional imagery surrounding a property
  • View multiple datasets for a single location
  • Retrieve imagery for property assessment workflows related to real estate, insurance, solar panel installations and landscaping

Why you should use the Transactional Content API

The Transactional Content API provides several benefits over other Nearmap APIs such as Coverage and AI Feature APIs. These benefits are as follows:

  • It is a single platform to access all Nearmap content types
  • Both usage allocation and consumption are measured using transactional credits
  • Allows you to retrieve multiple datasets that are precisely aligned for the same Area of Interest (AOI) in a single transaction

Using the Transactional Content API

Retrieving imagery using the Transactional Content API is a two-step process, which comprises:

  1. Requesting coverage
  2. Requesting content

Requesting Coverage

You can request coverage via the API endpoint /coverage/v2/tx using one of the following:

  • Point/radius
  • Bounding box
  • Polygon
  • Address

The API returns the following information:

  • Resource information is returned as x and y coordinates
  • In addition to resource information, the Coverage call also returns a transactionToken, which is valid for 30 days from the time it's generated.
  • Not all content types are available in a single survey; different content types may be returned in separate surveys.
  • When the coverage call returns more surveys than will fit on one page (default 20 records), you may make subsequent calls to return remaining surveys by passing the transactionToken and setting an offset and/or a limit. Passing the token ensures that you are not charged again for the coverage call.

NOTE: Credits are deducted from your balance when making a coverage call. The exact amount of credits deducted is returned as costOfTransaction.

Requesting Content

You can request raster or AI content using one of the following endpoints:

  • For raster maps - [/staticmap/v3/surveys/{surveyId}/{type}.{format}](https://developer.nearmap.com/reference/get_surveys-surveyid-type-format-1)
  • For AI assessment - /ai/features/v4/tx/surveyresources/{aiResourceId}/features.json.
    You need this additional product to access AI assessment - https://api.nearmap.com/ai/assessment/v1/tx/surveyresources/{aiResourceId}