Right Click Widget

[Brian_McLeer]

Introduction

The Right Click widget adds contextual map tools to ArcGIS Experience Builder. When a user right-clicks on the map, a menu appears offering a set of configurable actions. This provides access to functions like zoom, measurement, coordinate copying, marker plotting, text placement, and reverse geocoding.

End User Interaction

Once deployed, users can right-click anywhere on the map to open a context menu. Depending on the configuration, the following actions may be available:

Navigation Actions:

• Zoom In / Zoom Out: Adjusts the zoom level at the click location
• Center Here: Pans the map to center on the clicked point

Coordinate Actions:

• Copy Coordinates: Copies the location to the clipboard using the configured coordinate system
• Plot Coordinates: Places numbered coordinate markers with configurable styling and coordinate labels
• Plot Marker: Places simple markers with customizable appearance

Graphics Actions:

• Add Text: Places custom text graphics on the map with configurable font properties
• Clear All Graphics: Removes all placed markers and text (displays count when graphics are present)

External Services:

• Open in Google Street View: Opens the location in Google Street View using projected coordinates
• Open in Pictometry: Opens the location in Pictometry aerial imagery viewer using projected coordinates

Measurement Tools:

• Measure Distance / Measure Area: Opens measurement tools with the following features:
  • Automatic segment and total labeling for distance measurements
  • Filtered unit options
  • Single or dual unit display options
  • Close button for tool termination

Information Services:

• What's Here?: Performs location identification using:
  • Reverse geocoding via configured locator service for address lookup
  • Feature layer queries against configured ArcGIS Feature Services
  • Popup display showing results from both geocoding and feature layer queries

The context menu adapts based on administrator settings. Tools close automatically after use or on map interaction.

Measurement Tools

The measurement functionality includes the following specifications:

Available Units

• Distance measurements: Feet, Yards, Miles, Meters, Kilometers
• Area measurements: Square Feet, Square Yards, Square Miles, Square Meters, Square Kilometers, Acres

Unit Display Options

• Single Unit Only: Displays measurements in the selected default unit
• Show Both Units: Displays measurements in both the primary unit and its converted equivalent (e.g., "150.00 feet (45.72 meters)")

Interface Elements

• Distance measurement tool includes a Close button
• Area measurement tool includes a Close button
• Default "New measurement" buttons are removed

Coordinate and Marker Plotting

The widget provides two types of marker placement:

Coordinate Markers:

• Numbered sequentially starting from 1
• Display configurable coordinate information in popups
• Support multiple coordinate systems (map native, WGS84, custom WKID)
• Optional coordinate labels displayed on map
• Configurable marker styles, colors, outlines, and positioning
• Support decimal degrees or degrees/minutes/seconds format for lat/lon

Simple Markers:

• Basic point markers without numbering
• Fully customizable appearance including style, size, color, outline, rotation, and offsets
• Support transparency settings

Text Graphics:

• Custom text placement at clicked locations
• Configurable font family, size, weight, and color
• Optional text outlines (halo) and backgrounds
• Persistent during browser session

Developer Configuration

Map Widget Selection

• Connects the Right Click widget to map widgets in the application
• Enables right-click functionality on selected maps

Enabled Actions

Each action can be individually toggled:

• Zoom In
• Zoom Out
• Center Here
• Copy Coordinates
• Plot Coordinates
• Plot Marker
• Add Text
• Open in Google Street View
• Open in Pictometry
• Measure Distance
• Measure Area
• What's Here?

Coordinate System Settings

The format for copied coordinates can be configured:

• Use the current map's coordinate system
• Use WGS84 (latitude/longitude)

Plot Coordinates Settings

Comprehensive marker configuration options:

• Coordinate System: Map native, WGS84, or custom WKID
• Format Options: Decimal degrees or degrees/minutes/seconds for lat/lon
• Marker Style: Circle, Square, Cross, X, Diamond, Triangle, Pin
• Visual Properties: Size, color, outline color/width, opacity, rotation angle
• Positioning: X/Y offset controls for precise placement
• Text Settings: Number text size and color
• Labels: Optional coordinate labels with customizable offset, size, and color
• Popup Content: Toggle coordinate display in marker popups

Simple Marker Settings

Independent styling controls for basic markers:

• Style Options: Circle, Square, Cross, X, Diamond, Triangle, Pin
• Appearance: Size, color, outline properties, opacity
• Positioning: Rotation angle and X/Y offsets

Text Settings

Font and display configuration for text graphics:

• Typography: Font family, size, weight (normal/bold)
• Colors: Text color and outline (halo) color
• Effects: Outline size, optional background color
• Background: Transparent or colored background options

Reverse Geocoding Configuration

• Reverse geocoding service URL field for "What's Here?" functionality
• Optional WKID setting for coordinate projection
• Feature layer configuration for "What's Here?" queries:
  • Add multiple ArcGIS Feature Service layers
  • Select specific fields to display from each layer
  • Configure search radius and maximum results per layer
  • Set spatial relationship parameters for queries

Feature Layer Configuration

Advanced settings for "What's Here?" functionality:

• Layer Management: Add/remove feature layers with custom names
• Field Selection: Choose specific fields to display from each service
• Service Integration: Automatic field loading from Feature Service URLs
• Display Options: Configure field aliases and grouping

Popup Display Settings

Customization options for information popups:

• Layout: Popup width and maximum height settings
• Content Organization: Show/hide layer names, group by layer option
• Field Display: Use field aliases or raw field names
• Styling: Responsive design with scrolling for large content

Measurement Settings

• Default Units: Select from Feet, Yards, Miles, Meters, or Kilometers
• Unit Display: Choose between single unit display or dual unit display with conversions

External Service URLs

• Pictometry Integration: Configure Pictometry service URL with coordinate parameters
• Geocoding Services: Set reverse geocoding service endpoints

Widget Placement

The widget does not display interface components and operates in the background. Recommended configuration:

• Set widget size to 20×20 pixels
• Place in unused corner of the layout
• Use "Send to back" option in layout settings
• Keep widget visible and active
• Recommended for desktop only, not for tablet/phone viewers

Technical Notes

• Unit dropdown options are filtered to show only the specified available units
• Invalid unit selections are blocked and revert to default units
• Console logging is limited to warnings and errors
• Widget includes cleanup procedures for memory management
• Graphics persist during browser session but are cleared on page refresh
• Coordinate projections support multiple spatial reference systems
• Field metadata is automatically loaded from configured Feature Services

Changelog

06/20/2025:

• Add enhanced marker styling with 7 different shape options (circle, square, cross, x, diamond, triangle, pin)
• Add marker rotation, opacity, and X/Y offset positioning controls
• Add text graphics functionality with custom font controls, outlines, and background options
• Add support for custom coordinate systems via WKID input
• Add coordinate format options (decimal degrees vs degrees/minutes/seconds)
• Add simple marker plotting separate from coordinate markers
• Add comprehensive field selection for feature layers with automatic field loading
• Add popup display customization options (width, height, grouping, field aliases)
• Add real-time graphics counting in clear all option
• Add marker preview functionality in settings interface
• Add enhanced coordinate label positioning and formatting
• Add separate styling controls for coordinate markers vs simple markers

06/13/2025:

• Resolve a bug where browser default window sometimes appear on right click in addition to custom right click window
• Add Pictometry as a right-click option
• Add feature layers to What's Here? function to be queried against

Summary

The Right Click widget enables configurable map-based actions through a context menu. It supports zooming, measurements with filtered unit control, coordinate retrieval, marker and text placement with extensive styling options, and reverse geocoding with feature layer integration. Configuration is available through Developer Edition and applies to connected map widgets.

Feedback on bugs and enhancements can be submitted in the comments section of this blog post.

rightclick.zip