Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

It is easy to access Nearmap Vertical imagery through Google Earth® or Google Earth Pro®.

...

 All you need is an API Key and this URL:

https://api.nearmap.com/super-overlays/v1/kml?apikey={YOUR_API_KEY}

If you haven’t created an API key yet, follow the steps in Managing API Keys.


Contents of this article:

Table of Contents
maxLevel1
stylenone

Setup steps

Follow these steps to set up Google Earth integration:  

  1. From the Add menu, select Network Link.
    Image Modified

  2. The

    In the Network Link window, at the Name field, enter Nearmap. At the Link field, enter enter https://kmlapi.nearmap.com/.
    Image Removed
    When prompted, enter your Nearmap User Name and Password, and click Sign In.
    Image Removed

Am I connected?

Check you are connected to Nearmap imagery:

Google Earth not accepting Nearmap login

This section should help if you try to login using correct Nearmap credentials in Google Earth, but the login window keeps appearing whatever you type, even if you click Cancel.
This can happen if Step 3 of our Google Earth integration instructions was missed. If Google Earth saves your validated credentials to disk, it will try to use the same saved Nearmap authentication cookie every time you try to log in. That may be fine if you haven't logged in elsewhere. However, if you have used the MapBrowser more recently, the original cookie becomes invalid but Google Earth tries to use it anyway.

...

  1. super-overlays/v1/kml?apikey={YOUR_API_KEY}

    Image Added

  2. Click OK and verify that Nearmap logo appears (1) and the node with the name of the network link from Step 1

    should have

    has a green dot (2).

    Expand this node to see further information related to the imagery.
  3. Check that the Nearmap logo is displaying in the top left corner of the imagery.
    The imagery shown for a given location is the most recent Nearmap image available for that location.

If you see a red dot on the Nearmap image node and/or no Nearmap logo, check the URL you entered in Step 2.

Info
iconfalse

You cannot access previous captures in Google Earth. Since low zoom levels may include imagery from many dates, zoom in close to a location of interest to be sure that you're seeing the appropriate date for its capture.

.

...

Troubleshooting

Table of Contents
maxLevel2
excludeTroubleshooting

Google Earth not accepting login credentials

This may be a cookies issue. To delete Google Earth's cookies, follow these steps:

...

Code Block
C:\Users\YOUR_USERNAME\AppData\LocalLow\Google\GoogleEarth\cookies

Image Removed

  1. Image Added

FAQs

Will the old URL still work?

A previous version of this API used a different URL and required you to log in with user name and password.

That URL is now deprecated. Please transition to the latest version of GoogleEarth integration.


Can I use my Username and Password?

This integration requires an API key and will not accept username and password.


What does the date under the Nearmap logo mean?

Currently Google Earth integration with Nearmap displays the most recent image capture available for a given location.

The date of the latest imagery appears under the Nearmap logo and may change while transitioning between different zoom levels.


What does “Outside your subscription” message mean?

This message means you have no access to the Nearmap imagery in the area you are viewing. (There may or may not be Nearmap coverage.)


What does “Outside coverage” message mean?

This message means that you have access to view this area, however Nearmap has no coverage.


...

Troubleshooting

Table of Contents
maxLevel3
minLevel3
excludeTroubleshooting

API not working

  1. Make sure your API key is valid.
  2. Check the format of the URL: here’s a format example: https://api.nearmap.com/super-overlays/v1/kml?apikey=YWGuYTJjNIUtYjhjMC87MjdjLThjKDEtNTYzYzUwYa74MTIz

Possible legacy cookies

If Google Earth previously saved cookies, follow these steps to clear them (on Windows):

  1. Find Google Earth's cookies file on your hard drive. It is typically at "C:\Users\YOUR_USERNAME\AppData\LocalLow\Google\GoogleEarth\cookies" where YOUR_USERNAME is your Windows username.

  2. Delete this file.

  3. Follow all steps of the Google Earth integration instructions above.

...

To keep Google Earth from storing cookies, follow these steps:

  1. In Google Earth, go to the Options menu.
    Image Added

  2. Switch to the General tab.

  3. Anchor
    step3
    step3
    Uncheck the Save cookies to disk box and click OK.

    Image Added

Issues with getting the integration to work

If you are still experiencing issues logging in or accessing Nearmap imagery, try clearing the Google Earth cache. Follow these steps:

  1. In Google Earth select File > Server Sign Out.
  2. Select Tools > Options and on the Cache tab.
  3. Press Delete cache file.

    Image Modified

  4. Select File > Server Sign In or restart Google Earth.

...