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. In the Network Link window, at the Name field, enter Nearmap. At the Link field, enter https://api.nearmap.com/super-overlays/v1/kml?apikey.={YOUR_API_KEY}

    Image Modified

NOTE that you do not need to enter your username and password.

Am I connected?

Check you are connected to Nearmap imagery:

...


  1. The

    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.
    If you see a red dot on the Nearmap image node and/or no Nearmap logo, check the URL and API key that you entered in Step 2.
    Image Removed
    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 are accessing a region not covered by your subscription OR not covered by Nearmap imagery, you see a message: "Outside your subscription"
    Image Removed

...

iconfalse

  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
maxLevel32
minLevel3
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

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.

...

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.

...