Product Documentation

Cityworks - Nearmap Image Integration Using the REST Image Server Option

This guide describes how to load georeferenced Nearmap imagery in Cityworks using the REST Image Server option associated with our ArcGIS Marketplace item. The process includes creating an image 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 support@cityworks.com.

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.

Copy the URL you need from below:

US: https://aom-us.nearmap.com/arcgis/rest/services/nearmap_us/ImageServer
CA: https://aom-us.nearmap.com/arcgis/rest/services/nearmap_ca/ImageServer
AU: https://aom-au.nearmap.com/arcgis/rest/services/nearmap_au/ImageServer
NZ: https://aom-au.nearmap.com/arcgis/rest/services/nearmap_nz/ImageServer

Alternatively you can also obtain the URL from the ArcGIS Marketplace.
Go to GIS Services in the Cityworks application:
1. NOTE: If you don't have a Cityworks account, you can request an account via this link: https://mycityworks.force.com/s
2. Go to the Designer screen, either via Admin ? Designer, or Site Manager ? Designer.
3. Select GIS Services.
Add a new GIS Service Resource:
1. Under GIS Service Resources click Add.
2. Click Add again.
3. Select Image Map as the Service Type. Name the service - it doesn't need to match the name of the Web Map in ArcGIS Online. Pate the URL that you copied in step 1, then click Add.
Add the resource details:
1. Set the Security Type to Token.
2. Enter https://www.arcgis.com/sharing/rest/generateToken as the Token URL.
3. Enter your ArcGIS Online user ID in User Id.
4. Click Set Password and enter your ArcGIS Online password.
5. Click Test Security. You should see a Security is Valid message.
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 Nearmap REST Service.
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: https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer, and select Geocode as the Service Type, click Add.
2. Click Add, then name the service Geometry, enter the following URL: https://utility.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer, and select Geometry as the Service Type, click Add.
3. Click Add, then name the service Print, enter the following URL: https://utility.arcgisonline.com/arcgis/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task, and select Print Task as the Service Type, click Add.
Click on the map icon in the top right to launch your map.
When prompted enter your Cityworks credentials to proceed.
Select Legend, then click Nearmap REST Service (being the name of the service you set up). If you can't see Nearmap's imagery click Zoom to layer's extent.