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 youby following the steps described here: Add or Remove 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 attribute, see AI Packs.

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.

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.

IMPORTANT

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.



NOTE

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.

4. Name the Export

the default name is the capture name, which you can optionally change. Naming the export can help you identify each of your downloads when you go back to them in the future. 

You see your allowable download amount in number of parcels and the size of the current export, also in number of parcels.


5. Perform the Export

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

An export summary is displayed, 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 - the 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: support@nearmap.com. You will not be charged for the download.

Export contents

The parcel rollup csv is a zip file called ParcelRollupCSV.zip. 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 VectorLayerGeopackage.zip. Expand the zip file to extract individual .gpkg files for each Parcel Data Attribute from the export.


NOTE

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?