Page tree

Versions Compared


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


  1. Log in to Nearmap at as a user who is a Nearmap administrator.

  2. Click the API Access tab at the top of the screen, then the API Applications. If you do not see that the tab, it is likely that you are not a Nearmap administrator.

  3. Click the Create New button.

  4. Enter an Application Name. This can be any string of characters. A good name would describe the integration that you intend to have with Nearmap imagery.

  5. You can optionally specify restrictions on which IP addresses or web sites can load Nearmap imagery via an API Key associated with this API Application:

    • IP restrictions: only IP addresses in the ranges you specify will be able to load Nearmap imagery. CIDR addresses are accepted. For example,

    • Referrer restrictions: only URLs that begin with one of the specified referrer prefixes are allowed access to Nearmap imagery. This is based on web browser support for the HTTP referrer header field. 

      Enter here your referrer address/addresses, in a comma-separated list. A referrer address can contain sub-directories. For example,

      You must explicitly include https:// or http:// at the start of a Referrer Restrictions URL, the restriction will not work if this is missing. 

      Note: There is a character limit of 1 to 100 characters for the referrer restrictions.

    If the purpose of these restrictions is not clear to you, we recommend that you do not enter any restrictions.

  6. Click the Save button.


  1. Log in to Nearmap at

  2. If you are a normal user, click the My API Keys button. If on the other hand you are an administrator, select API Access from the top menu, and click the My API Keys link tab.

  3. Choose an application from the drop-down list.

    If there is no application in the drop-down list, or the API Application you want is not there, contact your organisation's Nearmap administrator.

  4. Click Create API Key.