Page tree
Skip to end of metadata
Go to start of metadata

This guide includes the following sections:

In addition to the documentation, you can view our MapBrowser 3D video tutorial. 

3D Content for Export

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

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

Note: the typical download size per square km and square mile varies a lot, depending on the complexity of the scene.

FormatTypical download size per km2 / mi2
3D Textured Mesh
3MX0.5 GB / 1.28 GB
.SLPK0.8 GB / 2.05 GB
.OBJ1.4 GB / 3.58 GB
3D Point Cloud
.LAS1.1 GB / 2.8 GB
DSM
.TIF (GeoTIFF 32-bit floating point)150 GB / 358 GB
True Ortho
.TIF (GeoTIFF)

900 MB / 2.3 GB


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 km2 and you export an area of 20 km2, you will have 1180 km2 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.


Accessing 3D Export 

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


Exporting 3D Imagery

1. Define the Export Area

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

Note that the maximum export area is 50 km(20 mi2) and the minimum export area is 100 m2 (about 1000 ft2), which is roughly equivalent to a very small residential property).

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 remaining allowance, the export will not be allowed to proceed.

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.

2. Choose the Capture 

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

Each 3D 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.

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

In any export you perform you may select as many types of content for export, and you will be charged only for a single export. If you perform separate exports for different types, you will be charged for each export. 

You can only export one format per type, for example for textured mesh you can export 3MX or OBJ or SLPK.

4. Name the Export

This step is optional. Name the export, or use the default name of the export, which is the capture name. Naming the export can help you identify each of your downloads when you go back to them in the future. 

5. Perform the Export

If the export is allowed to proceed the Continue button will be enabled. Click Continue:


An export summary will be displayed. Click EXPORT to proceed, or CANCEL to go back and change the export details.

Only once you click EXPORT the export starts, and the exported area is deducted from your 3D allowance.

Downloads Screen

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 tab 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 Ready for Download to start downloading the files. Once downloaded, you can use the files in one of the third-party applications


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 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: support@nearmap.com. You will not be charged for the download.


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


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.


Exporting 3D FAQs

QuestionAnswer

Does my normal imagery allowance get charged when I download 3D?

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

Will the exported 3D look the same as the 3D displayed in MapBrowser?

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.

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.

Does your 3D work in all applications?

There are many different applications and we have not tested them all. We support specific formats that may work with an application that supports that format. Demo samples are available to validate that a format works as expected in an application.

For more information, please refer to 3D Content in Applications.

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 via your Nearmap account manager.

How do I download additional formats for an existing export without getting charged again?

Multiple formats can be selected in the export dialogue box when setting up the export.

Why am I not able to export 3D?

For 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. Check with your Nearmap account administrator that they have granted you the correct licence 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: Grant/Revoke/Change a Nearmap Licence.

How can I export all the 3D you have for certain city?

You need to do this via an offline 3D export process. Please contact your Nearmap account manager for this.


What is the maximum allowed 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.

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 km2
  • For exports of formats that are not currently supported by online MapBrowser Export

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 output files at any time without those being counted again.


Troubleshooting

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:

You will need to make sure these are whitelisted in order to be able to perform the export. 

You can check if your network is blocking the download by performing the following steps:

  1. Click on the following link: 
    1. Australia - https://kepler-exports-prod-ap-southeast-2.s3.ap-southeast-2.amazonaws.com/test.txt
    2. United States - https://kepler-exports-prod-us-east-1.s3.us-east-1.amazonaws.com/test.txt
  2. Save the text file.
  3. Open the saved file.

If the downloaded text file has the contents TEST SUCCESSFUL, then your network is not blocking the download. If your download still fails and you are unable to resolve the issue yourself, please contact Nearmap Support: support@nearmap.com.

  • No labels