This guide includes the following sections:

Nearmap AI lets you export AI Parcel Data as parcel rollup spreadsheets (csv) and vector layer (geopackage) from within MapBrowser.

Before you start

To have access to AI parcel data export, your organisation must have a Nearmap AI licence and export credits for your license. Read this article How do I get access to my company's Nearmap subscription for more information. You also need to have Nearmap AI permissions, which your account administrator can provide for you by following the steps described here: Manage a User's 3D or AI Export Permissions.

Connection Requirements

For best results, we recommend the following:

  • Internet connection (As a rule of thumb approximately a gigabyte of data per million parcels for the download.)
  • Use a wired connection
  • If you are using a WiFi connection, avoid moving the computer whilst the download is in progress
  • Do not shut down, hibernate, or let the computer sleep during the download.

AI Content for Export

Using MapBrowser you can export (download) both Nearmap AI Content Types: parcel rollup (.csv) and vector layer (.gpkg).

For more detail about the content of each export file see:  Frequently Asked Questions - What's contained in each export file?

For a summary of each attri bute, see AI Packs.

Note that boundary layers are not included in the export.

Nearmap AI Export Allowance

Refer to - Nearmap AI - Allowance and Usage

Exporting AI Parcel Data

Open MapBrowser and find your area of interest.

It may be useful to view the AI Layers before you start exporting. To find out how, follow the instructions on this page: View AI Layers in MapBrowser.

1. Access AI Export 

Click the Export button and select AI  from the drop-down menu:

2. Define the Export Area

There are two ways to define your export area:

a. Draw the area you wish to export.
The area can be any shape of polygon, it doesn’t have to be rectangular. 

HINT: You might want to adjust the background so you can see the area better.

If you draw an area that has only partial AI content, the export will include only the area with AI content. Your allowance will only be deducted by the amount that was actually exported.

b. Alternatively, you can import a GeoJSON file to define your export area.
Follow these steps:

Import a GeoJSON file

  1. On the map inside MapBrowser, click the upload a GeoJSON file link.

  2. Browse to your GeoJSON file and click Open.

You can also simply drag and drop your GeoJSON file anywhere on the map.

Errors when defining the export area

There are a few error messages you might see if you import an invalid file or draw a polygon that doesn't define a clearly bound area for export.

Refer to Valid GeoJSON and Polygon Formats for Content Export for a detailed explanation of these errors and what you can do about them.

3. Select the Capture 

Select the capture, which is a combination of the capture region  and the month and year of the first survey in the capture. 

You must select a capture in order to proceed.


Note that each AI capture is made up of multiple surveys, flown at different dates, so the  entire scene could be made up of photos taken over one to three months.

This means that the "survey_date" may vary for different parcels included in the export.


If your area of interest covers multiple capture regions, we recommend you obtain your AI parcel data offline (and not via the MapBrowser). Contact your Nearmap Account Manager.

If you select a capture that is outside of the region you have drawn (or the region defined by the geoJSON file) you see the error shown in the screenshot below.

Select an appropriate capture from the dropdown list.

Once you select the capture, the total size of the selection is shown in the Summary section . The total allowance is shown as well. If the export area size is greater than the remaining allowance, the export will not be allowed to proceed.

5. Perform the Export

If the export is allowed to proceed  the CONTINUE  button will be enabled. Click CONTINUE to proceed with the export.

A dialog informs you of the export details.

By default, the name of the export file is set to the name of the selected capture.  You can change the export file name to help you identify each of your downloads in the future.  To change this name, type a new name in the Export Name field.  The name can contain letters, numbers and special characters such as #, * and so on. 

Click CONFIRM EXPORT to proceed,  or CANCEL to go back and change the export details.

The export starts once you click CONFIRM EXPORT. At this point  the exported parcels are deducted from your AI  allowance.

Expand the row and you will see the CSV and Vector Export are available for you to export.

To download parcel rollup csv file of all attributes, click the Parcel Rollup (CSV) button.
To download the Vector Layer geopackage, click the Vector Layer (GeoPackage) button.

NOTE: You can access your downloads at any time by clicking the Downloads button on MapBrowser.

Download Status

The download status can be any one of the following:

  • Pending  - the export is about to start being processed by our system. This lasts only for a few seconds after clicking the  EXPORT  button.
  • Running  - t he export is currently being processed by our system. This may take any time from seconds to a few hours depending on the number of parcels. At this point you  have not yet been charged.
  • Ready for Download - The export has been correctly processed and you can download the imagery. 
  • Failed  - the export failed to export properly. In the rare case where this may happen, please contact Nearmap Support: You will not be charged for the download.

Export contents

The parcel rollup csv is a zip file called . Expand the zip file to extract individual .csv files for each Parcel Data Attribute from the export.

  You can sort and filter by your preferred attribute such as confidence, address, etc.

The Vector Layer geopackage is a zip file called . Expand the zip file to extract individual .gpkg files for each Parcel Data Attribute from the export.


Each subsequent export will have the same file name, appended with the next subsequent number, e.g. VectorLayerGeopackage (1).zip VectorLayerGeopackage(2).zip, etc.

We encourage you to rename the parcel rollup zip file as soon as it's downloaded so you can better distinguish between your all the parcel rollups you have downloaded.

For export format contents see : AI - Frequently Asked Questions - What's contained in each export file?

Exporting AI Layers

The AI Layers viewable in MapBrowser cannot be exported directly. However, they (and a selection of other raster layers) are available via an offline delivery, as described here: AI Offline Raster. For the full list of AI Layers beyond what is included in AI Packs, please refer to the AI Layer Glossary.