Sign in

v1

latestOpenAPI 3.0.02026-07-243964175.3 KB
new transaction

Return the surveys intersecting/overlapping with a point + given radius or a parcel boundary

If parcelLookup is set to 'true', the API will perform a parcel lookup for the given point and return the surveys intersecting/overlapping with the parcel boundary if a parcel is found. When a parcel is not found and a radius parameter is provided, the API will return the surveys intersecting/overlapping with the given point + radius. radius is not required in this case.

If parcelLookup is not 'true', the API will return the surveys intersecting/overlapping with point + given radius. Radius is required in this case.

get/tx/point/{x},{y}

Path parameters

xnumber required

longitude co-ordinate.

ynumber required

latitude co-ordinate.

Query parameters

parcelLookupboolean

if true performs parcel lookup for the given point

radiusnumber double

Distance from the point in metres. Required in conjunction with point to define the token's bounding box (not a circle). Radius range is between 1 - 100. Must be used in conjunction with a point parameter or else it is invalid.

dates'all' | 'single' required

Whether the customer wishes to access all dates available or only one date (per resource type).

resourcesstring required

Comma separated list of resource types. Each resource type is a colon separated namespace/type tuple, for example raster:Vert.

Namespaces currently supported:

  • raster
  • aiPacks
  • aiImpactAssessment

Supported raster resource types:

  • Vert - vertical orthorectified imagery
  • DetailDtm - aka DTM or bare earth elevation model
  • DetailDsm - aka DSM or surface model
  • TrueOrtho - True Ortho (strict top down imagery, derived from 3D)
  • North, East, South, West - panorama imagery

Supported aiPacks resource types:

  • building
  • building_char
  • construction
  • debris
  • pavement_marking
  • poles
  • pool
  • postcat
  • roof_char
  • roof_cond
  • roof_objects
  • solar
  • surface_permeability
  • surfaces
  • trampoline
  • vegetation

Supported aiImpactAssessment resource types:

  • postcat
sincestring

First day from which to retrieve the surveys (inclusive). Must be of the form "YYYY-MM-DD" or as a relative date relative date "xxY", "xxM", "xxD" where 5M represents since 5 months ago.

untilstring

Last day from which to retrieve the surveys (inclusive). Must be of the form "YYYY-MM-DD" or as a relative date relative date "xxY", "xxM", "xxD" where 5M represents until 5 months ago.

limitinteger

Limit the number of surveys in the result. Default is 20, Maximum is 1000.

sort'captureDate' | 'location' | 'firstPhotoTime' | 'lastPhotoTime' | 'pixelSize' | 'timezone' | 'utcOffset' | 'onlineTime'

The field by which to sort the surveys. Only one field can be specified. If this parameter is not used in the URL request, then the surveys are sorted by captureDate in descending order.

offsetinteger

Zero-based index of first record in the result.

overlap'full' | 'all'

Whether or not to return metadata for imagery that only partially intersects the requested area. Default is to return all, such that surveys that only partially intersect the AOI will still be returned. If full is specified then only surveys completely within the given AOI are included.

filter'allTypes' | 'anyTypes'

Whether to match only surveys with all of the listed resource types (allTypes), or surveys with at least one of the resource types (anyTypes). Default is allTypes.

aiOn3dCoverageboolean

When set to true, performs coverage check using the 3D attribute coverage boundary of the resource.

previewboolean

When true, a coverage request will not be charged credits, however it will also not include a transaction token in the response. All other behaviour should remain the same. This allows a client to check the coverage status of a location before committing to the transaction request.

Response

Surveys returned that match point + radius

transactionTokenstring

Token used for all operations associated with this transaction

costOfTransactionnumber

Cost of transaction, in credits.

The pricing table specifies the cost of the resources in the coverage response. The cost only includes the resources that have coverage available - if some of the resource types in the request weren't available, they don't contribute to the cost. That cost is multiplied by 1.5 if dates=all; and by the area covered by the transaction divided by 1000m², rounded up.

referencestring

Reference string supplied via the X-Nearmap-Ext-Reference header

geocodedAddressstring

Geocoded address (if address originally provided)

geocodedConfidencenumber

Confidence level (0 -> 1) of geocoded address

bboxstring

Bounding box covering the area of interest. The format is minX, minY, maxX, maxY

resourceServersobject

Resource type to URL template

tileSizeInPixelsinteger

Size of staticmap tiles in pixels

limitinteger

Requested limit on the number of survey results

offsetinteger

Zero-based index of first record in the result

totalinteger

Total number of surveys available

errorsError[]

Example response

{
  "surveys": [
    {
      "tags": {
        "postCatEventType": "hurricane",
        "postCatEventName": "Hurricane Idalia",
        "postCatEventDate": "2023-08-30"
      }
    }
  ]
}