This guide describes how to load georeferenced Nearmap imagery in Cityworks using Nearmap's Custom WMS 2.0. The process includes creating a web map in ArcGIS Online.

Note: Both Cityworks and ArcGIS Online are not Nearmap products, and as such any support you may need should be directed to Cityworks or Esri. Please contact Cityworks support by emailing

This guide is intended to give you general instructions on how to view Nearmap imagery in Cityworks, and might not reflect the latest version of the application.

  1. Obtain a Nearmap Custom WMS 2.0 URL. Using Nearmap’s new Custom WMS will allow you to geofence the area, and access historical imagery, as well as State Plane Coordinate Systems in NAD83 in the US, or GDA 2020 in Australia.

  2. Create a web map in ArcGIS Online using the Nearmap WMS 2.0 Service:
    1. Login to ArcGIS Online: and click the Map tab.
    2. Click Add Add Layer from Web:

    3. Select A WMS OGC Web Service from the drop-down menu, enter the URL you copied in step 1, and click GET LAYERS:

    4. Select the layers you would like to add, and click ADD LAYER.

  3. Save the map. Click the Save icon, then click Save and add Title, Tags, and Summary, then click SAVE MAP:

  4. Share the map with groups inside of your organization. Click the Share icon and select who can view the map, then click DONE:

    Note: Do not make the map public. 

  5. Copy the Web Map ID from the ArcGIS Online URL:

  6. Go to GIS Services in the Cityworks application:
    1. Login to Cityworks.

      Note: If you don't have a Cityworks account, you can request an account via this link:

    2. Go to the Designer screen, either via Admin Designer, or Site Manager → Designer:

    3. Select GIS Services:

  7. Add a new GIS Service Resource:
    1. Under GIS Service Resources click Add:

    2. Click Add again:

    3. Select Web Map as the Service Type. Name the service - it doesn't need to match the name of the Web Map in ArcGIS Online. Enter the Web Map ID that you copied in step 5, then click Add:
  8. Add the resource details:
    1. Set the Security Type to Token:
    2. Click Use AGO URLs to populate the field for Sharing URL:
    3. Enter your ArcGIS Online user ID in User Id.
    4. Click Set Password and enter your ArcGIS Online password.
    5. Enter as the Token URL

    6. Click Test Security. You should see a Security is Valid message:

  9. Go to the Service Definitions tab, and select the map, then select the Map Service that you just created, in this case it is the Cityworks Custom WMS 2.0:

  10. Go back to the Service Resources tab and add Geocode, Geometry, and Print services:

    Note: Once you add Geocode, Geometry and Print you don’t need to add them again. 

    1. Click Add, then name the service Geocode, enter the following URL, and select Geocode as the Service Type:

      Click Add.

    2. Click Add, then name the service Geometry, enter the following URL, and select Geometry as the Service Type:

      Click Add.

    3. Click Add, then name the service Print, enter the following URL, and select Print Task as the Service Type:

      Click Add.

  11. Click on the map icon in the top right to launch your map:

  12. When prompted enter your Cityworks credentials to proceed.

  13. Select Legend, then click Nearmap WMS Server. If you can't see Nearmap's imagery click the Zoom to layer's extents icon:

    You can zoom in further: