Nearmap WMS integration

To consume Nearmap imagery via WMS, you must first create a Simple or Custom WMS Service, which generates a URL that Civillo can use.

Important

Nearmap API usage can significantly increase the account data usage. Please monitor your usage carefully.

Step 1

1. Sign in to Nearmap

2. Click on the Integrations tab in your account.

3. Click on the CREATE APP button.

4. Using the Create API App form, add a Civillo application. Add https://app.civillo.com/ to the Referrer restrictions.

   

   Nearmap API create

5. Click CREATE

Simple WMS

A Nearmap Simple WMS provides a URL to access latest Nearmap imagery, with no geographic restrictions.

To create a simple Nearmap connection:

1. Click on the API Keys tab in the Integrations tab in your account.

2. Choose the Civillo API App that was created in Step 1.

   

   Create API Key

1. Click CREATE KEY

2. Click on the API Services tab in the Integrations tab in your account.

3. In the Simple API Service form, select the Civillo API Key and the Simple WMS integration type.

   

   Create Simple WMS link

4. Click COPY LINK

5. In Civillo, create a online services layer, select a “WMS (Web Map Service)” as the Layer type.

6. Paste the copied link (Step 6) into URL.

7. Click ADD LAYER.

Custom API Service

A Nearmap Custom Services allows for imagery to be provided in distinct areas, similar to Civillo’s project boundaries. Custom Services should result in a lower account data usage.

1. Click on the API Services tab in the Integrations tab in your account.

2. Under the title Custom API Service, click on the CREATE SERVICE button.

3. Rename the service to something appropriate.

   

   Rename the custom service

1. Click the **ADD AREA** button. 1. Navigate to the area of interest and trace a polygon boundary. Double click on the starting point to close the polygon.

  ![Drawing the area of interest polygon in Nearmap](/images/admin-guide/nearmap/create-nearmap-api-5.jpg)

<figcaption>Draw the area of interest</figcaption>

1. Click **CONTINUE**. 1. Add additional areas, or click **FINISH**. 1. Click the **Copy** icon for the new service.  1. Associate the service with an **API Key**. Choose the **Civillo** API App that was created in [Step 1](#step-1). The link has been successfully copied to the clipboard. 1. In Civillo, [create a online services layer](/admin-guide/create-a-onlineservice-layer/), select a "WMS (Web Map Service)" as the **Layer type**. 1. Paste the copied link (Step 9) into URL. 1. Click **ADD LAYER**.

Nearmap Export

If you choose not to use the Nearmap API to create a WMS layer, users can export Nearmap imagery and upload directly to Civillo if required.