Nearmap – ArcGIS Experience Builder Widget

Nearmap provide many organisations access to recent high-resolution imagery. They are an Esri partner, and their popular Vertical Imagery product is available via ArcGIS Marketplace. This provides ArcGIS users the ability to get the latest or historical imagery into their web maps.

The Nearmap MapBrowser interface provides the end-user with an intuitive and interactive way to pick and choose from the historical imagery. The Survey dates in the drop-down dynamically change every time the user pans/zooms the map around to let them know what dates are available for that particular area of interest. We want this same User Experience in ArcGIS, so we decided to put together an ArcGIS Experience Builder widget to do just that.

Provide ArcGIS user same UX as the Nearmap MapBrowser interface for browsing historical imagery

The Widget

A widget has been built with following key functions:

• Toggle Nearmap on/off. This lets you get your bearings with an underlying basemap for reference.
  • The Survey Date picker. This dynamically updates as you zoom and pan around the map to only provide the user with the available Survey Dates for that extent.
  • Changing the Survey Date in the dropdown will change the Nearmap tiles to match.
  • A Swipe tool to cross compare two Nearmap Survey dates in the same area of interest. Both will have a Date Picker so you can switch both to different dates as required.
  • Bring your own Nearmap API Key – the widget relies on this in order to function

The Nearmap Experience Builder Widget over the Canberra Space Center

Leveraging the draw/measure tools alongside the Nearmap widget and share with others

Deploying the Widget

For ArcGIS Online users, you can download the widget and use within ArcGIS Experience Builder Developer edition, and then host the Experiences that you publish out of there for others to use.

For ArcGIS Enterprise users on v11+ you can reference the Manifest file we provide and simply register the widget straight into your portal. Any updates pushed to Github will flow down into your deployed Experiences. Alternatively you can also download the widget and host on your infrastructure.

• Nearmap Widget for ArcGIS Experience Builder Developer Edition
• Nearmap Widget for ArcGIS Enterprise – steps to register the Manifest hosted on Github
• Source Code on GitHub for developers to extend and improve

Deployment Options

Further Reading on Deployment Options

• Nearmap Imagery in Public-Facing Web Maps
• Add Experience Builder Custom Widgets In ArcGIS Enterprise (v11+)
• Install ArcGIS Experience Builder Developer Edition
• Deploy Experience to a web server
• Esri Community:  Experience Builder Custom Widgets
• Unofficial guide from David Das

Download widget into your ArcGIS Developer Edition of Experience Builder

We encourage other developers to fork the code and make pull requests. Non-developers are welcome to raise issues via Github, but should point out this is an unsupported widget.

Best Practise is to use an API Key with a Referrer restriction to your ArcGIS environment/apps

Nearmap – ArcGIS Javascript API Sample

For those developing with the ArcGIS Javascript API, we have also provided a sample that you can build upon or incorporate into your existing applications.

Sample: https://github.com/bgtdevhub/nearmap-arcgis-integration

Those interested in including a Nearmap subscription can put in a purchase request via the listing on ArcGIS Marketplace.