Overview
ArcGIS Online is an online hosted environment from ESRI with which you can make Nearmap imagery available on a public-facing ArcGIS web map.
You can make Nearmap imagery available in ArcGIS Online in one of two ways:
- Through a simple or custom WMS 2.0 URL. See WMS 2.0 Integration for more information.
- Through the Nearmap Tile API URL.
Once this is done, you can make that content public-facing.
NOTE: The license for public display of Nearmap imagery is granted by an additional agreement between your organization and Nearmap. If in doubt, please contact your Nearmap account manager.
As part of adhering to the pubic facing restrictions, you will need to limit the public map as per the following:
- No more detailed than 6" resolution
- Limited to your area of interest (best effort)
- No georeferenced image export
- No printing
- No measurement tools
Obtaining Nearmap imagery
You can obtain an offline copy of Nearmap imagery. Click the following links for instructions on how to do this:
Setting up Nearmap content in ArcGIS Online
To do this, follow these steps:
- Create a new API application with referrer restrictions.
NOTE: For public-facing maps, you must use the website URL referral restrictions, and not IP address range restrictions.
- Create and copy the API key.
- Build your tile request URL. After you copy your key, paste it to the end of the below URL to complete building your Tile API URL:
https://api.nearmap.com/tiles/v3/Vert/{level}/{col}/{row}.img?apikey=PASTE_YOUR_KEY_HERE. This URL is specific to working with ArcGIS Online. - Connect to the Tile API in ArcGIS Online.
- Select Add Layer from web from the Add dropdown.
NOTE: When adding imagery to an AGOL environment, it is recommended that the connections be made as layers rather than as basemaps. The Basemap widget in AGOL in particular can have issues with externally streaming APIs.
- Select the type of data you are referencing as A WMS OGC Web Service for a WMS connection.
- Set up the AOI.
- Select a Tile Layer as the type, and then paste your API Key. Give it a title and fill out the credits.
- Click the SET TILE COVERAGE button.
- Set tile coverage/extent. You must set the Tile Coverage for this to work. Skipping this step will result in the service not working.
- Click DRAW EXTENT. You only need to roughly limit the area to your AOI. You can only draw a 4 sided polygon, so it doesn’t need to be precise.
- Click OK. You will be taken back to the Add Layer from Web window.
- Click ADD LAYER
- Set the visibility range.
NOTE: This step is necessary to limit the resolution to 6 inches to comply with the terms and conditions of public-facing imagery. 6 inches is equivalent to 1:564 Scale.- Right-click on the tile layer
- Select Set Visibility Range
- Move the scale slider until Map Scale displays at least 1:564.
- Save your map.
Testing the URL and sharing it
Open the link in a public version of the map. For example: https://nearmap.maps.arcgis.com/home/webmap/viewer.html?webmap=30c96b03d76f468a97aa9131c4f30825.
In the link, replace the portion in front of ‘arcgis.com’ with www. This will take you to a public version of the map.
