Setting Up Map Profiles

Use map profiles to configure specific instances of map functionality in the system. Profiles set the default extent of the map (the area shown by default) as well as controlling the availability of certain map options.

A profile can be linked to multiple maps. All of a profile’s maps share the same map service URL, default map extent, and default base map, but the maps have individual configuration options to control end-user options for the map.

Every map must be associated with at least one map profile. If a map has multiple profiles, a Switch Map Profile button appears on the map toolbar, and end users can choose which profile to use.

Map Profiles list page — This example illustrates the Map Profile list page. Each row includes a thumbnail map, lists up to three maps that are associated with the profile, and states how many additional maps (if any) are associated with the profile.

Prerequisite

Mapping capabilities depend on integration with a map service such as Esri’s Geographic Information Systems (GIS). Before you set up map profiles, publish your map service so that it can be referenced from within the Oracle system.

Delivered Maps

The following tables describe the delivered maps in the Oracle Public Sector system.

Note: Make sure that every map you use is associated with a profile.

This table lists the main maps that display the agency’s permits, planning applications, and projects. There are separate maps for different users. For more information, see Using the Main Map and Explore Your City Map.

Map profiles for the main map
Map Name	Description
Agency main map	The main map that appears when an agency staff member clicks the Main Map icon in the page header.
Guest/anonymous user map	The main map that appears when an anonymous user clicks the Explore Your City tile on the landing page.
Registered public user map	The main map that appears when a public user who is signed in clicks the Explore Your City tile on the landing page. Registered users and anonymous users see different maps because registered users have additional options for starting permit and planning applications and for limiting searches to just the user’s own applications. These options are not configured on the map profile, but the existence of separate maps for public users and anonymous users means that you must configure them separately.

This table lists additional maps that support permits and planning applications:

Map profiles for permits and planning applications.
Map Name	Description
Application intake	The property picker map. This map appears in a modal window that is accessed from an application intake form or, for submitted applications, from the application details Property Information page. See Working with Property Information.
Mobile inspection	The map that inspectors see when using mobile inspection functionality for permits. See Viewing Inspection Tasks.
Permit list	The map that appears on the application list pages when they are in map view. The list page for agency staff is the Transactions page. This page includes lists for both permits and planning applications. The same map is used for both. The list page for registered public users is the Applications page. These list pages all include List View and Map View buttons for toggling between views. See Managing Transactions.
Public notification	The map that appears on the Public Notification page. Agency staff uses this page to define a notification area. See Creating Map-Based Public Notification Lists.

This table lists additional maps that support code enforcement:

Map profiles for code enforcement
Map Name	Description
Agency - code enforcement	The map that code enforcement technicians can view from certain tabs on the Worklist page. This map shows the location of issues that appear on the selected worklist tab. See Using the Code Technician Worklist.
Code enforcement issue intake	The map that appears on the page where public users who are reporting a code enforcement issue identify the location of the issue. See Reporting Issues.
Mobile code enforcement inspections	The map that inspectors see when using mobile inspection functionality for code enforcement. See Overview of Mobile Oracle Municipal Code Officer.
Public - code enforcement	The map where public users can view recent code enforcement issues. See Viewing Recent Issues.

This table describes the map that appears in transaction headers:

Map that appears in transaction headers
Map Name	Description
Transaction header	The map that appears at the top of various detail pages. For example, this map appears in the detail pages for permits, planning applications, incidents, cases, parcels, addresses, and owners. Note: Link this map to exactly one map profile. Profile switching is not allowed for this map.

Note: If your agency defines a new map page, the new map must be added to the Map Page lookup (ORA_PSC_COM_SYS_MAP_PROFILE) so that it is available to be associated with a map profile.

Adding a Map Profile

Select GIS Setup > Map Profile.
If no profiles exist, the Map Profile Details page opens so that you can create the first profile. If at least one profile exists, the Map Profile list page appears.
If the Map Profile list page appears, click Add Map Profile.
The Map Profile Details page appears.

Enter the following basic profile information:

Basic map profile information
Page Element	Description
Profile ID	Enter a unique identifier for the map profile.
Profile Name	Enter a descriptive name for the map profile. This identifies the profile on the Map Profile list page. When end users view a map with multiple profiles, they can switch profiles by choosing from a list that displays this name along with a map thumbnail.
Description	Enter a more detailed description of the map profile. This also appears on the Map Profile list page to help identify the profile.

Enter the URL for your map service in the Map Service URL field.
The URL to the profile provides default values for the map extent, which you will confirm or change later in this procedure.
If the Base Map field is editable, choose the type of map to display.
The Esri server settings control whether this field is editable.
The options are Dark gray canvas, Light gray canvas, Imagery with labels, National Geographic, Topographic, Open Street Map, Imagery, Streets, Terrain with labels, and Oceans.
When you link specific maps to the profile, you will configure whether users can change the map type.

Set the map extent.

The map extent defines the geographical area that the map initially displays. When you create a new map profile, a generic map illustration appears above the Choose Map Extent option. After you choose the map extent, a preview thumbnail of your actual map extent replaces the generic illustration.

Although the map service URL provides a default map extent, you still need to click Choose Map Extent to load the default extent into the profile and optionally modify it.

Note: Maps in transaction headers are initially centered on the transaction location. Therefore, the transaction header map uses the default extent from the map profile only if the transaction is not associated with a specific location.

Click Choose Map Extent.
The Choose Map Extent page appears. The map service URL that you previously provided sets the default map extent, and the page displays a map with that default extent.

If necessary, modify the default map extent supplied by the map service URL.

Oracle provides the ability to easily set a new map extent without making any changes to the GIS service. To change the extent, pan and zoom until you can see the desired extent, then use the Choose Map Extent toolbar button to draw a selection rectangle. This sets the new extent.

The following fields describe the map extent by identifying a coordinate system and listing the minimum and maximum X and Y values on the coordinate system.

Default map extent fields on the Map Profile Details page
Page Element	Description
X-Min of Default Map View	The top-left X-coordinate of the initial map extent.
X-Max of Default Map View	The bottom-right X-coordinate of the initial map extent.
Y-Min of Default Map View	The bottom-left Y-coordinate of the initial map extent.
Y-Max of Default Map View	The top-right Y-coordinate of the initial map extent.
Spatial Reference	The geographic coordinate system or map projection used by the mapping service to display the map. The map service URL that you previously supplied sets this value.

Click OK to close the Choose Map Extent window.
The thumbnail map on the Map Profile Details page is updated to match your map extent.

Link maps to the profile and define settings for each map:

Click Add Map Page.
In the Map Page field, select a map to link to the profile.
The maps are Agency main map, Application intake, Agency - code enforcement, Code enforcement issue intake, Mobile code enforcement inspections, Public notification, Transaction header, Guest/anonymous map, Mobile inspection, Permit list, Registered public user map, and Public - code enforcement.
These maps are described in detail above.

Configure map-specific options.

Depending on the map that you are configuring, some map options might not be available to enable or disable. For example, you cannot enable selection tools or window docking on the maps for mobile devices, and zoom tools are the only widgets available in the transaction header map.

If you create any custom maps, there are no restrictions on which widgets you can enable, so take extra care when configuring those maps.

Use these fields to configure map options:

User control settings on the Map Profile Details page
Page Element	Description
Enable Zoom	Indicate whether the map toolbar includes Zoom In and Zoom Out tools.
Enable Default Map View	Indicate whether the map toolbar includes the Show Default Map View tool. This tool restores the map to its initial extent after a user zooms or pans to change the display area.
Enable Base Map Gallery	Indicate whether the map toolbar includes the Select Base Map tool. This tool lets users change the base map from the one specified in the profile. For example, if the profile’s base map is topographic, users can change to a map with satellite imagery.
Enable Map Layers	Indicate whether the map toolbar includes the Select Layers tool and, depending on your GIS configuration, the Identify GIS Information tool. The Select Layers tool lets users see the list of layers and switch layer visibility on and off. Examples of layers include environmental, zoning, or infrastructure information provided by the map service. The Identify GIS Information icon gives users the ability to click map objects such as parcels to display a pop-up window with object information. This option is available if the GIS administrator has configured the GIS service to provide this information.
Enable Selection Tools	Indicate whether the map toolbar includes the Show/Hide Selection Tools icon. Clicking this icon opens a separate toolbar with tools for selecting and deselecting parcels on a map. The ability to select parcels on the agency main map, the registered public user map, and the guest/anonymous user map enables users to view associated transactions. Registered users and agency staff can additionally start an application for selected parcels. The ability to select parcels on the public notification map enables users to create a notification area around the selected parcels.
Enable Detail Window Docking	Indicate whether the map detail window is docked to the side of the view. The detail window is the pop-up window that appears when a user clicks a map marker or other GIS feature such as a parcel.
Detail Window Dock Position	Specify the position where the map detail window is initially docked: Auto, Bottom left, Bottom center, Bottom right, Top left, Top center, or Top right. This field is relevant only if you enable detail window docking. This field does not apply to mobile devices, where the detail window always appears at the bottom of the screen.

Configure the map layer display options for the Application Intake page. The Map Layer Display Options section of the page displays all of the layers defined with the map service associated with the map profile. Administrators use this section to enable layers for GIS object selection.

Note: The Map Layer Display Options section appears only for the Application Intake map page.

Elements in the Map Layer Display Options section
Page Element	Description
Enable Selection	When this switch is turned on for a layer, the GIS objects associated with that layer can be selected on the map.
Unique Identifiers and Display Attributes	Enter the identifiers and attributes that display for GIS objects when you select them on the map.

Note: If you change the map service in Esri to add, update, or delete the associated layers that were enabled for GIS object selection on the map page, you need to update this setup. Delete the map page and add it again. This ensures that the latest layer information is loaded when the administrator enables layers for selection and enters attributes.

Click Save to close the Add Map Page window.

If necessary, click a linked map to re-open the Add Map page.
- To edit settings, make your changes and then click Done.
- To remove the map from the profile, click the Delete button.
Click Save to save the map profile.

Modifying a Map Profile

Select GIS Setup > Map Profile.
On the Map Profile list page, click the row for the profile that you want to modify.
Update the settings as needed.
Click Save.

Deleting Map Profiles

To delete a map profile:

Select GIS Setup > Map Profile.
On the Map Profile list page, click the row for the profile that you want to delete.
On the Map Profile Details page, click Delete.