Setting up an ESRI map determines the map that the citizen will see when they log on to the portal. It is the top level of configuration and acts as a container for all map-related settings. There are a couple of points that are helpful when setting up the maps

  • The settings are for the general appearance and feature set of a single map
  • The maps are reusable – can be shared amongst multiple ESRI Settings records
  • While ESRI Settings are the top level for configuration, you must setup the ESRI Server first.

To setup the ESRI settings,

  1. Navigate to Connect 365 -> ESRI Maps.
  2. The ESRI Maps form displays.
  3. Click New.
  4. The New ESRI Map form displays.
  5. Complete the fields.

Name

Description

Name

Name of the ESRI map

Description

Description of the ESRI map

Map Features

 

Enable Locate Widget

Determines if the map can find the person’s current location. Determines if the Locate Widget is enabled. Yes = Enabled; No = Not Enabled

The widget will not enable if the client portal is not using a HTTPS website.

Locate Position

The position in the view at which to add the component. If not specified, manual is used by default. Known Values: top-left | top-right | bottom-left | bottom-right | manual

Enable Zoom Widget

Determines if the person may adjust the zoom of the map. Determines if the Zoom Widget is enabled. Yes = Enabled; No = Not Enabled

Zoom Position

The position in the view at which to add the component. If not specified, manual is used by default. Known Values: top-left | top-right | bottom-left | bottom-right | manual

Enable Home Widget

Determines if the person may easily return to the default view of the map. Determines if the Home Widget is enabled. Yes = Enabled; No = Not Enabled

Home Position

The position in the view at which to add the component. If not specified, manual is used by default. Known Values: top-left | top-right | bottom-left | bottom-right | manual

Map Sketch And Search Tools Settings

 

Tool Position

The position in the view at which to add the component. If not specified, manual is used by default. Known Values: top-left | top-right | bottom-left | bottom-right | manual

Enable Search Widget

Determines if the Search Widget is enabled. Yes = Enabled; No = Not Enabled

Search Country Code

Determines the country within which the search will be limited. For example, Canada = CAN or CA, United States = USA or US.

Additional Country codes can be found here, or by searching for ArcGIS Geocode Coverage

Enable Intersections

Determines if the map will support finding an intersection from the clicking on the map. When enabled, the Intersection tool displays. Yes = Enabled; No = Not Enabled

Intersection Button Label

Determines the label associated with the Intersection tool, i.e., Intersect

Intersection Distance (Meter)

Determines the search radius for an intersection, i.e., distance within X meters. Minimum value = 1 and Maximum value = 10

Intersection Tool Information

Determines the guiding text that displays on the map when the Intersection Tool is selected. For example, Click in the map to find the nearest intersection. Cliquez sur la carte pour trouver l'intersection la plus proche.

If the information should display in multiple languages, enter the language versions within the field.
If multiple languages are entered, do not separate the languages by a line break. 

Intersection Not Found Message

Determines the text that display on the map when an intersection cannot be found within the parameters set in the Intersection Distance (Metre) field. For example, Intersection not found within 2 meters. Intersection introuvable -> moins de 2 mètres

Intersection Button CSS Class

Determines the icon used on the Intersection Tool button.

Additional icons can be found on the ESRI GitHub, here.

If replacing the icon, only replace the content displayed underlined and italicized as shown in the example.

For example, action-button esri-icon-plus-circled esri-component

Clear Button Label

Determines the label associated with the Clear tool, i.e., Clear

Clear Button CSS Class

Determines the icon used on the Clear Tool button. The icon used when delivered is, action-button esri-icon-trash

Additional icons can be found on the ESRI GitHub, here.

If replacing the icon, only replace the content displayed underlined and italicized as shown in the example.
For example, action-button esri-icon-plus-circled esri-component

Enable Push Pins

Determines if the Push Pins are enabled. Yes = Enabled; No = Not Enabled

Push Pin Button Label

Determines the label associated with the Push Pin tool, i.e., Point

Push Pin Tool Information

Determines the guiding text that displays on the map when the Push Pin Tool is selected. For example, Drop the pin in the map.

If the information should display in multiple languages, enter the language versions within the field.
If multiple languages are entered, do not separate the languages by a line break.

Address Not Found Message

Determines the text that display on the map when an address cannot be found in the location where the pin was dropped. For example, Address not found on selected location.

Push Pin Button CSS Class

Determines the icon used on the Clear Tool button.

Additional icons can be found on the ESRI GitHub, here.

If replacing the icon, only replace the content displayed underlined and italicized as shown in the example.
For example, action-button esri-icon-plus-circled esri-component

Enable Polygon

Determines if the Polygon tool is enabled. Yes = Enabled; No = Not Enabled

Polygon Button Label

Determines the label associated with the Polygon tool, i.e., Polygon

Polygon Tool Information

Determines the guiding text that displays on the map when the Polygon Tool is selected. For example, Draw in the map. Double click to finish.

If the information should display in multiple languages, enter the language versions within the field.
If multiple languages are entered, do not separate the languages by a line break

Polygon Out of Boundary

Determines the text that displays on the map when a location is outside the boundaries of the Polygon. For example, This location is outside the city boundary.

If the information should display in multiple languages, enter the language versions within the field.
If multiple languages are entered, do not separate the languages by a line break

Polygon Button CSS Class

Determines the icon used on the Polygon Tool button.

Additional icons can be found on the ESRI GitHub, here.

If replacing the icon, only replace the content displayed underlined and italicized as shown in the example.
For example, action-button esri-icon-plus-circled esri-component

Enable Address Validation

Determines if Address Validation is enabled. Yes = Enabled; No = Not Enabled

Address Validation Message

Determines the text that displays on the map when a location without a known address is entered on the map. For example, You selected a point that does not have an address do you wish to keep the point or select a new address?

If the information should display in multiple languages, enter the language versions within the field.
If multiple languages are entered, do not separate the languages by a line break.

This message will display to citizens if the ArcGIS account has no more tokens. To ensure this does not happen, the ArcGIS account must be maintained.

Consent Title

Determines the label associated with the message that displays when a location without an address is selected for a pin drop, i.e., User Consent.

Accept Button Text

Determines the label associated with the Accept button, i.e., Accept

Decline Button Text

Determines the label associated with the Decline button tool, i.e., Deny

Accept Button Class Name

Determines the icon used on the Accept Button.

Additional icons can be found on the ESRI GitHub, here.

If replacing the icon, only replace the content displayed underlined and italicized as shown in the example.
For example, action-button esri-icon-plus-circled esri-component

Decline Button Class Name

Determines the icon used on the Decline Button.

Additional icons can be found on the ESRI GitHub, here.

If replacing the icon, only replace the content displayed underlined and italicized as shown in the example.
For example, action-button esri-icon-plus-circled esri-component

Show Attribution

Determines is the map detail information displays below the map or not: Yes = Visible; No = Not Visible.

Primary Layer

Determines the map layer on which pins will be dropped, i.e., pins are dropped on layers and not on the actual map. While there can be multiple layers on a map, every map must have a Primary Layer.

Select the Primary Layer to be used on the map from the ESRI Map Layer Lookup.

The names of the map layers have no impact on the functionality of the layer. Ensure that the layers are named intuitively so they may be easily identified.

There is no Administrative configuration needed for this field.

Map Layers sub-grid

Determines all of the map layers that are associated with a map. To add additional map layers, select the Add ESRI Map Layer Record button (+) and select the appropriate layer from the look-up.

Map View Configuration

 

Basemaps

Determines the base map that will be shown to the citizen. A sample value for this field is “streets.” Additional values can be found here.

Center Latitude

Determines the latitudinal center of the map for the citizen. Contact your ArcGIS manager if assistance is needed to determine this value. For example, the latitudinal center of Toronto could be 43.653200

Center Longitude

Determines the longitudinal center of the map for the citizen. Contact your ArcGIS manager if assistance is needed to determine this value. For example, the longitudinal center of Toronto could be -79.383200

Initial Zoom

Determines the how close or far the map displays for the citizen. The size of the area will help to determine this value.

Some trial and error will be needed to determine this value. Typically, however, 10 is a good value.

Min Zoom

Determines the how close a citizen may zoom into the map. The size of the area will help to determine this value.

Some trial and error will be needed to determine this value. Typically, however, 0 is a good value.

Max Zoom

Determines the how far away a citizen may zoom out of the map. The size of the area will help to determine this value.

Some trial and error will be needed to determine this value. Typically, however, 30 is a good value.

Geological Boundary Settings

 

Active Boundary Type

Determines Boundary Type for current map settings.

VeloCITY 365 validates the location details returned from ESRI against the location details configured here. If the details match, a pin drop allowed. The selection options are:

· Feature Layer – the boundaries are determined based on the map layer identified as the feature layer when determining the map layers

· Polygon – the boundaries are based on the values entered into the Polygon Boundary field. Enter string values for longitude and latitude “[-79.54388, 43.58759]”. This field displays once Polygon is selected.

· Area/Region – the boundaries are based on the values entered into the Country Code, State/Province, City, and Neighbourhood fields (in that order). These values are validated with the result set returned from the ESRI ArcGIS server. These fields display once Area/Region is selected

Out of Boundary Message

Determines the text that displays on the map when a location outside of the determined area is entered on the map. For example, Selected location is out of city limits. Please select location within city limits.

If the information should display in multiple languages, enter the language versions within the field.
If multiple languages are entered, do not separate the languages by a line break

Country Code
(displays when Area/Region is selected within the Active Boundary Type field)

Determines the country within which the search will be limited. For example, Canada = CAN or CA, United States = USA or US.

Additional Country codes can be found here, or by searching for ArcGIS Geocode Coverage

State/Province
(displays when Area/Region is selected within the Active Boundary Type field)

Determines the state/province within which the search will be limited. For example, Alberta = AB, Texas = TX.

City
(displays when Area/Region is selected within the Active Boundary Type field)

Determines the city within which the search will be limited. For example, Toronto or Houston.

Neighborhood
(displays when Area/Region is selected within the Active Boundary Type field)

Determines if the neighborhood will be validated when the address is returned from ArcGIS.

Refer to the Active Boundary Type field for more information

Invalid Boundary Config Message
(displays when Area/Region is selected within the Active Boundary Type field)

Determines the text that displays on the boundary has been configured incorrectly. For example, Out of City

If the information should display in multiple languages, enter the language versions within the field.
If multiple languages are entered, do not separate the languages by a line break

Polygon Boundary
(displays when Polygon is selected within the Active Boundary Type field)

Determines the boundaries of the Polygon within which the addresses will be limited.

The coordinates must be within a latitude / longitude format, i.e.,
[-79.54388,43.58759];[-79.54388,43.58957;

The coordinates are generated on the client’s ESRI account and not provided within VeloCITY 365.

Boundary Marker Style

Determines how the line style which will used to identify the boundary.

Boundary Marker Color

Determines how the line color which will used to identify the boundary.

Boundary Outline Width (px)

Determines how the line width which will used to identify the boundary. The value entered impacts the displays once Polygon is selected from the Active Boundary Type

Default Graphic Setting

 

Pushpin Type

Determines if the push pin will display as a Marker or as an image.

Pushpin Image (WebResource/dataUrl)

Determines the image that will be used if Image has been selected in the Pushpin Type field. The URL to Web resource for the image must be entered

Pushpin Height (px)

Determines the height of the pushpin image

Pushpin Width (px)

Determines the width of the pushpin image

Pushpin Marker Style

Determines the style of the pushpin if Marker was selected in the Pushpin Type field

Pushpin Marker Color

Determines the color of the pushpin if Marker was selected in the Pushpin Type field

Pushpin Marker Size (px)

Determines the size of the pushpin if Marker was selected in the Pushpin Type field

Polygon Symbol Style

Determines the symbol style of the polygon if Polygon was selected in the Active Boundary Type field.

Polygon Symbol Color

Determines the symbol color of the polygon if Polygon was selected in the Active Boundary Type field.

Polygon Outline Style

Determines the outline line style of the polygon if Polygon was selected in the Active Boundary Type field.

Polygon Outline Color

Determines the outline line color of the polygon if Polygon was selected in the Active Boundary Type field.

Polygon Outline Width (px)

Determines the outline line width of the polygon if Polygon was selected in the Active Boundary Type field.