Gen 3 uses the same raster AI Layers as Gen 2, but with a fundamentally new vectorisation process that we call "Open World". At the most basic level, Open World vectorises all features, regardless of parcel boundaries, allowing us to remove a number of caveats around large or missing parcels, buildings being cut to parcel boundaries,  and regional variation in parcel quality.

New Content

Gen 3 introduces three new AI Packs:

NEW - AI Pack: Building Characteristics

AI Data

  • Building Peak Height (ground to peak) attached to building footprints.
  • Storey Count (1, 2, 3+) with confidence scores attached as metadata to building footprints.

NEW - AI Pack: Vegetation

Three vectorised vegetation layers, from very low vegetation to shrubs and trees.

AI Data

  • Vectorised polygons of all included AI Layers

AI Layers

These AI Layers have been included for visualisation in MapBrowser:

NEW - AI Pack: Surfaces

A variety of ground surfaces, both natural and man-made.

AI Data

  • Vectorised polygons of all included AI Layers

AI Layers

These AI Layers have been included for visualisation in MapBrowser:

ENHANCED - AI Pack: Building Footprints

AI Pack: Building Footprints  gains a new vectorisation algorithm, and benefits substantially from vectorising prior to use of property parcels. See page for more details. With these enhancements, we now consider our building footprints fit for purpose in Commercial and Industrial areas (outside complex downtown/CBD zones), so have removed the "Residential" tag on the Building Footprint and Roof Characteristics AI Packs.

ENHANCED - AI Pack: Roof Characteristics

AI Pack: Roof Characteristics gains the new "Dutch Gable" roof type, and the dominant pitch in degrees calculated from our 3D mesh.

AI Data

  • Dominant Roof pitch (degrees) attached to roof features.
  • Dutch Gable added as a roof type.

AI Layers


Note that Gen 3 content is currently available via three methods:

  • The AI Feature API
  • AI Offline Export
  • Visualisation of raster AI Layers in MapBrowser.

Gen 3 is NOT yet available for export through MapBrowser. If you wish to access Gen 3 data and have existing Nearmap AI credits, you may either do so via the AI Feature API (which can be added to your subscription), or by asking your Account Manager to organise an offline delivery of Gen 3 data.


Initial coverage is identical to Gen 2 data - approximately the Spring 2020 season in the USA, and latest data as at June 2020 in Australia. Additional coverage may be published from time to time at customer request.

Version History


Adds a new field "geomatchedAddress" to the response if geocoding query parameters such as streetAddress, city, state, zip are used to make an API request. The  "geomatchedAddress" field will contain the full address that the geocoder has matched based on the given input.


Resolves an issue whereby the areaSqm, areaSqft, and ratio fields of the Roof Material, Roof Types, and Roof Tree Overhang attributes were calculated inaccurately. The issue affects all winter_sunrise releases from gen3-winter_sunrise-1.3 onwards.

gen3- winter_sunrise-2.2

Adds new fields "extentMinX " " extentMaxX " " extentMinY " " extentMaxY "  to the top level of the response. These represent the approximate extent of the AOI (either user supplied, or the result of geocoding).

Adds new fields  " clippedAreaSqm "  and  " clippedAreaSqft "  to the top level of each feature in the response. These represent the area of each feature as if it were cropped to match the AOI.

This upgrades all previously processed data from gen3-winter_sunrise-2.1 to gen3-winter_sunrise-2.2.

gen3- winter_sunrise-2.1

Adds new fields "clippedAreaSqm" and "clippedAreaSqft" to all feature classes behind AI Feature API.  "clippedArea..." is the area of intersection between the provided Query AOI (usually a property boundary), and the feature. This makes it possible to look up the area of an object such as a building that falls within the AOI, and then calculate the proportion falling within or outside the AOI. This is important for determining which features to include and exclude. This pairs with the existing "unclippedArea..." attribute that gives the area of the entire feature independent of the Query AOI.


With this release, a response includes all children of any feature that intersects with the query AOI, whether or not each child feature intersects with the parcel boundary. Previously, response returned only features (children and parents) that intersected with the parcel.

This upgrades all previously processed data from gen3-winter_sunrise-1.x to gen3-winter_sunrise-2.0


Adds new "unclippedAreaSqm" and "unclippedAreaSqft" fields to connected classes behind AI Feature API (vegetation and surfaces AI Packs). "areaSqm" and "areaSqft" will continue to give the area of the feature returned from the API. The "unclippedArea" includes the full area of the connected feature, which may be very large. This is to make it easier to determine if e.g. a property borders on a small stand of trees vs a large forest, or a pond vs an ocean.


No customer facing changes.


The first production data released, as per the specifications above.