Skip to main content
The Map Widget is a specialty widget that displays an embedded Google Map at given latitude/longitude coordinates. It is non-interactive apart from zooming in and out.

​
Example Code

​
Parameters

​
string
required
Must be “map” - defines the widget type
​
string
required
The name of the widget, shows up as the map title
​
string
required
Unique reference ID of the widget
​
Equation Object
required
Special equation object where the "result" should be of the form "{latitude: 0.000, longitude: 0.000}"
​
string (equation)
default:"true"
An equation that must result in true/false and can hide the widget if certain conditions are met. If visibleIf==false, any fields referencing this field will error
​
boolean
Flag for whether the widget should be always hidden from users

​
Coordinate Format

The equation result must provide latitude and longitude coordinates:

​
Dynamic Coordinates

You can make coordinates conditional based on user inputs:

​
Functionality

Display Only

Shows Google Maps embedded view at specified coordinates

Limited Interaction

Users can only zoom in and out of the map view

​
Common Use Cases

  • Site Location: Display project location for wind/seismic data
  • Geographic Context: Show building location for environmental loads
  • Reference Location: Display coordinates for code-specific regional parameters
  • GIS Integration: Visual reference for geospatial data inputs

​
Best Practices

  • Ensure latitude and longitude values are valid (lat: -90 to 90, lon: -180 to 180)
  • Use meaningful labels to indicate the purpose of the map
  • Consider making the map conditional if not always relevant
  • Test with different coordinate sources (user input vs project defaults)
  • Provide fallback coordinates for edge cases

​
Integration with Project Defaults

The Map Widget commonly integrates with project-level location settings:
This allows the map to automatically display the project location set in the project defaults, which is often used for determining regional load parameters and building codes.