This guide includes the following sections:

Watch the video: MapBrowser - 3D Viewer & 3D Export

For 3D export to be available, it is required that your organisation have a 3D Export licence and that export credits are still available for your license. You also need to have 3D export permissions, which your account administrator can provide you.

Connection Requirements

For best results, we recommend the following:

• Use at least a 100 Mbit/s internet connection
• 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.

3D Content for Export

Using MapBrowser you can export (download) all Nearmap 3D Products, and then use the content in third-party applications (see INTEGRATIONS).

The following table lists the formats that can be exported from MapBrowser, and the typical download size for each format.

Check the 3D PRODUCTS page for more discussion about these formats:

* DEM is known as DTM in Australia.

3D Export Allowance

When you purchase 3D Export you get an allowance for a certain number of square kilometers or miles. When a user on your account  performs the export, the area of the export is deducted from the allowance. For example, if you start with 1200 km² and you export an area of 20 km², you will have 1180 km² left on your 3D export allowance.

Allowance is counted when the export completes and is ready for you to download

• You can download the exported files any number of times without incurring any additional usage charges.
• You can download any number of content types in a single export and it will be counted as if you downloaded one type.
• If you perform separate exports for different types, you will be charged for each export. 

Exporting 3D Imagery

1. Access 3D Export 

Click the Export tool and select 3D  from the drop-down menu:

2. Select a 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.

3. Choose a projection

A range of projections is available relative to the geographical area currently visible in MapBrowser.

Default projections

A default projection will be pre-chosen that is relevant for the area being viewed and which reflects country standards.

Country defaults are as follows:

• US – NAD83/UTM + NAVD88
• AU – GDA2020/MGA + AHD
• CA – NAD83(CSRS)/UTM + CGVD2013

If you are not sure which projection to use, stick to the default.

4. Select the Content Type and Format 

Select the types and formats of the content that you want to export. The available content types and file formats are listed under  3D Content for Export. You can select up to 4 content types and any number of available formats available per content type for your selected export projection.

If you've selected more than one content type, "Multi" is indicated in the dropdown.

Projections with Limited content types and format

There are some projections which are specific and limited to one content type and format. These are:

Similarly, when you select a projection other than ECEF or WGS84/Geodetic + EGM96, and you select Cesium or SLPK as one of the formats, they will be exported in ECEF and WGS84/Geodetic + EGM96 projections. This is reflected in the Export panel, as shown in the screenshot below:

5. 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. 

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

If your GeoJSON file is has more than 1000 vertices, you will see a warning dialog like the one shown below. You won't be able to upload that GeoJSON file. Close the dialog and either draw around your area for export, or use a simpler GeoJSON file.

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

Also to note:

• If you draw an area that does not have 3D coverage, you will see a warning message and will not be able to proceed with the export.
  
  
• If you draw an area that has only partial 3D content, the export will include only the area with 3D content and your allowance will only be deducted by the amount that was actually exported.

6. Perform the Export

Once you finish defining the export area, 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 available allowance, the export will not be able to proceed.

Click REVIEW 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. Once confirmed the export starts, and the exported area is deducted from your 3D allowance.

7. Download

The Downloads screen will open, showing your downloads list and the status of each download, including the current one.

When the download is ready, you can expand the row to see what files are included in the export. The 3D File Contents guide provides a detailed explanation of each file included in each content type.

Click on each content block to download the files. 

Once downloaded, you can use the files in one of the third-party applications. See INTEGRATIONS.

Downloads 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 size of the export area, the terrain of the export area, and the requested file types. 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 by submitting a support request.
  
  REQUEST SUPPORT
  
  You will not be charged for the download.

Tips for Exporting 3D

If you want to export a single building, select an area slightly bigger than the building you want to export, to avoid getting an incomplete 3D image.

Troubleshooting

• Page:
  Nothing Happens When I Press Export —

  When you click the EXPORT button the export process is supposed to start, as you will be able to see in the Downloads screen. If you clicked the EXPORT button and nothing happened, your corporate firewall or proxy server may be blocking these addresses:

  • All regions - api.nearmap.com
  • Australia - kepler-exports-prod-ap-southeast-2.s3.ap-southeast-2.amazonaws.com
• Page:
  Why am I not able to export 3D? —

  For export to be available,

  • Your organisation have a 3D Export licence and export credits are still available for your license.
  • You need to have 3D export permissions, which your account administrator can provide you. 
    Check with your Nearmap account administrator that they have granted you the correct licence and permissions for 3D Export. It is possible that if you do have a 3D Export licence, it is on a separate licence. If your administrator needs to change the licence, they can use these instructions: Manage a User's Licence.

FAQs

• Page:
  How do I get the other file types for my 3D export? —

  You sure can! When you export 3D content from MapBrowser, you can select up to four 3D content types, all for the price of one!

  Find out more here: Export 3D

• Page:
  What do I do if my 3D or AI export fails? —

  If your export fails in your downloads page you should see a red “Failed” status next to your download.

  As the download has not been processed you have not been charged at this point. Our developers will be automatically notified about the error and will investigate what went wrong.

  Please do not request a new export for the same location until we have had a chance to investigate and resolve the error.

• Page:
  When should a I use offline 3D as opposed to online export? —

  Offline 3D is preferable in the following cases:

  • For single exports that are bigger than 50 km²
  • For exports of formats that are not currently supported by online MapBrowser Export.
    Refer to 3D PRODUCTS for a list of Nearmap 3D products that are available via MapBrowser and offline.
• Page:
  What is the maximum allowed 3D export size?  —

  Any single export is limited to 50km2/20mi2. This could be any where between 25GB and 75GB in size depending on the format you have chosen.

• Page:
  Will the exported 3D look the same as the 3D displayed in MapBrowser? —

  The 3D displayed in MapBrowser 3D viewer is Cesium format.

  Exported 3D should have a very similar appearance to the 3D viewed in the Map Browser. If you are viewing the same capture, it will be the same content. However different formats and applications may display the extracted 3D in slightly different ways, which may make the content appear to be different.

• Page:
  Does your 3D work in all applications? —

  Nearmap's 3D content can be imported into many popular CAD and GIS applications. In general our different export formats should work with an application that supports that format.

  Demo samples are available to validate that a format works as expected in an application. Contact your Account Manager for demo content.

• Page:
  Can I preview my actual format (e.g. DSM) before I export it and get charged for it? —

  There is no way to preview DSM before it is exported, but the elevation values present in the DSM will reflect those seen in the 3D imagery in MapBrowser.

  For more information on exporting DSM, or any 3D content, read Export 3D.

• Page:
  How do I download additional 3D formats for an existing export without getting charged again? —

  You can select multiple formats in the export dialogue box when setting up a single export.

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

  Make sure you're on the correct tab - 3D EXPORTS or AI EXPORTS.

• Page:
  Can I get a small free export so I can test if the 3D export works in my application? —

  This is not possible, but you can get demo samples for testing application support of formats. These are available from your Nearmap account manager.

• Page:
  How can I export all the 3D you have for certain city? —

  Single 3D exports are limited to 50 sq km or 19.3 sq mi.

  If your city area is larger than this, you'll need to obtain your content via an offline 3D export process. Please contact your Nearmap account manager for this.

• Page:
  Does my normal imagery allowance get charged when I download 3D? —

  No, you have a separate allowance for 3D export.

  Find out more here: View Account Data Usage.

• Page:
  What is the 3D export size limit? —

  Single 3D exports are limited to 50 sq km or 19.3 sq mi.

  If your export area is larger than this, you'll need to obtain your content via an offline 3D export process. Please contact your Nearmap account manager for this.

• Page:
  Is downloading an existing export output counted against my allowance? —

  No, 3D Export allowance is counted at the time of the export. You are free to download the existing output files at any time without those being counted again.

• Page:
  How do I import a screenshot at the right scale? —

  You can use the Snapshot tool to export an image of:

  • Vertical
  • Panorama
• Page:
  How do I print the 3D I am viewing? —

  Use the Snapshot tool to print the 3D mesh from the MapBrowser view. 

  Learn more about the snapshot tool.