Creating an ESRI Map Visualization
You can display your data as locations on an interactive map using the
ESRI Map visualization. For example, you can create a visualization that
displays how customer households are clustered in different parts of the
country using a density map, or display retail locations as a series of
map markers that users can click to view additional information about
stores in their area.
You can display data in an ESRI Map visualization in the following ways:
Image markers
are fixed size images that mark locations on the map. You can color
image markers or replace image markers in the visualization with a
different image based on the value of a metric.
Bubble markers
provide two visual cues to help users analyze data displayed on a
map: size and color. You can choose to size each bubble marker in
the visualization based on the value of a metric, with the largest
bubbles being displayed for the largest metric values. You can have
bubble markers colored based on the value of a metric.
A density
map helps users understand patterns and trends for many geographic
locations by displaying color gradients based on the concentration
of geographic data. For example, you can display locations with a
high concentration of stores in red, and locations with a low concentration
of stores in blue.
Map areas
are colored, two-dimensional areas on a map that represent geographic
regions, such as countries, states, and counties. You can color-code
areas based on the value of a metric.
Steps are provided below to create and add data to an ESRI Map visualization:
Providing geographic information for an ESRI Map visualization that
displays map markers or a density map
To display map markers or a density map in the ESRI Map visualization,
you must provide the latitude and longitude of each location in the map.
You can provide this data in the following ways:
During the
Data Import process, you can define an attribute and assign it a geo
role to identify what type of geographic information it contains.
For example, you can create an attribute called City, which contains
the names of multiple cities, then assign it the City geo role. Web
automatically creates the City attribute with the attribute forms
Latitude and Longitude, which contain the latitude and longitude
of each city. You can then use the City attribute to provide latitude
and longitude information for locations in the visualization. Web
automatically adds latitude and longitude information as attribute
forms to data columns with the Country, State, Zip Code, City, or
Location geo roles. You can select which attribute forms are displayed
in the visualization; for steps, see Selecting
which attribute forms to display in a visualization.
You can also assign an attribute the Latitude
or Longitude geo role to identify it as containing latitude or longitude
information. The attribute can then be used to provide geographic information
for locations in the visualization, as described in the prerequisites
below.
For background information on importing data into
the application, including steps to assign a geo role to an attribute,
see About importing data.
Providing
geographic information for an ESRI Map visualization that displays areas
To display areas in the visualization, you must provide an attribute
whose values include the names of each area to display, as provided by
the visualization's base map. The base map is a map that contains the
shape of each area that can be displayed in the visualization. For example,
the base map for Countries of the World contains the shape information
required to display each country on a world map. The base maps available
in the application include the following:
US States
State Abbreviations
Zip Code
Countries
of the World
World Admin
Divisions
US Counties
For example, you want to display a map that contains a colored area
for each country in which your company has sales representatives. You
can create an attribute called Country, which contains the names of these
countries, then use the Country attribute to provide location information
in a visualization that uses the Countries of the World base map.
the application uses the attribute that contains location information
to determine the default base map to display in the visualization. If
a geo role, such as State or Country, has been assigned to this attribute,
the visualization will automatically display the first base map that supports
the geo role as the attribute. For example, if the attribute’s geo role
is State, the US States base map will be displayed in the visualization
by default. If a geo role has not been assigned to the attribute, you
select the appropriate base map to use.
You create and assign geo roles to attributes while you are importing
data. For background information about importing data into the application,
see About importing data.
Prerequisites
One attribute
contains the latitude and longitude of each location in the Latitude
and Longitude attribute forms. For example, you can provide an attribute
that has been assigned the Country, State, Zip Code, City, or Location
geo roles.
Two separate
attributes, as follows:
The
first attribute contains the latitude of each location. For example,
you can provide an attribute that has been assigned the Latitude
geo role.
The
second attribute contains the longitude of each location. For
example, you can provide an attribute that has been assigned the
Longitude geo role.
To display
map areas, you must have already created an attribute with the name
of each location that you want to display in the visualization. Each
element in the attribute should contain the name of a location defined
in the visualization's base map, as described
above. For example, if you want to display Japan on a map, you
select a base map that defines an area for Japan, such as Countries
of the World. The location attribute should contain an element named
Japan
This procedure
assumes that the you have already enabled the out-of-the-box Map visualization
provided with the application.
You must
have Edit Dashboard and Run Dashboard privileges.
If zip code
is used as the geo attribute for an area map displayed in the Oracle
XBRi mobile app, you must:
Download
shapesRepository2.zip and extract the contents of the
zip file.
Copy the
extracted file to your Mobile Server folder.
Restart
the Mobile Server.
To
create an ESRI Map visualization that displays map markers:
Click the name of the dashboard
to run it.
From the toolbar, click the Insert Visualization icon 
. A new blank visualization
is added to the dashboard and displayed.
From the Visualization Gallery,
click the ESRI Map icon. Note: If the Visualization Gallery
is not displayed, from the View
menu, select Visualization Gallery.
If
the Properties panel is not displayed, from the View
menu, select Properties Panel.
If the Properties panel is hidden behind another panel, click the
Properties icon 
to display the Properties
panel.
Select Map Options
from the drop-down list at the top of the Properties panel.
From the Map
Type drop-down list, select Marker.
From the Map
Style drop-down list, select the display theme to apply to
the map, such as Street Map
or Terrain Map.
You can enable map markers to
be clustered together when a large number of map markers must be displayed
in the same map area. Each cluster of markers is displayed as a separate
bubble or image marker. Users can double-click a cluster to zoom in
on the area and display individual map markers in the cluster. From
the Clustering drop-down list,
select one of the following:
To cluster
markers on the map, select On.
To display
items on the map as clustered with pie graphs, select Pie.
To display
items on the map without clustering, select Off
(default).
From the Marker
Type drop-down list, select the type of map marker to display,
as follows:
To display
bubble markers, select Bubbles.
To display
image markers, select Pins.
You can determine whether to display
a legend for the map. The legend shows the relationship between the
color of each marker and the metric value for that location. Do one
of the following:
To display
the legend, select the Show Legend
check box.
To hide
the legend, clear the Show Legend
check box (default).
To display the Editor panel, from
the View menu, select Editor Panel. If the Editor panel
is hidden behind another panel, click the Editor
icon 
to display the Editor panel.
If the Datasets panel is not displayed,
from the View menu, select
Datasets Panel.
From the Datasets
panel, click and drag dataset objects to the appropriate area in the
Editor panel, as follows:
To use attribute
forms to provide the locations in the visualization, click and drag
the attribute that contains the latitude and longitude information
to the Geo Attribute area.
Web automatically detects the Latitude and Longitude attribute forms
and displays their names in the Latitude and Longitude areas. Steps
to select which attribute forms to display in the map are included
in this procedure. For example, you can display the attribute’s description
form but not the latitude and longitude forms.
To use attributes
to provide the locations in the visualization, perform the following
steps:
Click
and drag the attribute that contains the latitude information to the
Latitude area.
Click
and drag the attribute that contains the longitude information to
the Longitude area.
Note:
You can also drag objects from the Datasets panel directly onto the visualization.
f on the Properties
tab you selected Pie for the Clustering
option, then the Angle and Color By
areas display on the Editor tab. The number shown
in the center of each pie graph indicates the number of items in the
cluster. Note the following regarding the pie graph slices:
The value
represented by pie graph slices and the color of the slices differ,
depending on whether a metric is dragged to the Angle
and Color By areas:
If no metric
is dragged to the Angle area, then the pie graphs
display an equal slice for each item in the cluster. Additionally,
if no metric is dragged to the Color By area,
then each slice is the same color. For example, the following pie
graph indicates there are five items in the cluster. And because no
metric is defined for Angle or Color By,
each pie slice is equal in size and appears in the same color.
If a metric
is dragged to the Angle area, then the pie graphs
display a proportional slice for each item in the cluster, based on
the metric. Additionally, if a metric is dragged to the Color By
area, then the color of each slice is based on the defined thresholds.
For example, the following pie graph indicates there are five items
in the cluster. Each pie slice is sized to represent the percentage
of the whole, based on the Angle metric. Additionally the color of
each pie slice is based on the defined thresholds, based on the Color By
metric. Notice, in the following example, a single slice takes up
approximately 75% of the pie graph, and that slice is darker in color.
Place the
mouse pointer over the center of the pie graph to display a tooltip
for all items in the cluster.
Place the
mouse pointer over a pie slice to display a tooltip for the item represented
by the slice.
Double-click
a pie graph to zoom in on the area and display individual map markers
in the cluster.
You can color map markers in the
visualization based on the value of a metric. From the Datasets
panel, click and drag the metric to the Color By
area.
You can customize the colors used
to display map markers or replace image markers with a different image
based on the value of the metric in the Color By area. To do
so, you must define a threshold on the metric used to display the
map markers. In the Color By area, right-click the metric and select
Thresholds. The Thresholds Editor opens. Select the
appropriate options to define
the formatting to apply to the map markers
If you have chosen to display
bubble markers in the visualization, you can size the bubble markers
based on the value of a metric, with the largest bubbles being displayed
for the largest metric values. From the Datasets
panel, click and drag the metric to use to size the bubble markers
to the Size By area.
For each attribute in the Editor
panel, you can select which attribute forms are displayed in the visualization.
An attribute form is a descriptive category for an attribute. For
a more detailed description, including how to select what attribute
information to display in the headers, see Selecting
which attribute forms to display in a visualization.
To select the attribute forms, in the Editor panel, right-click
the attribute and point to Display Attribute Form. Select
one of the following:
To display
an attribute form in the visualization, select the check box next
to its name.
To hide
an attribute form in the visualization, clear the check box next to
its name.
By default, when a user clicks
a map marker in the visualization, a tooltip containing additional
information about the location is displayed. You can include the values
of additional dataset objects, such as related attributes and metrics,
in the tooltip. To do this, from the Datasets panel,
click and drag the dataset objects to the Tooltip
section.
Click the Save
icon 
to save your changes.
To
create an ESRI Map visualization that displays a density map:
Click the name of the dashboard
to run it.
From the toolbar, click the Insert
Visualization icon 
. A new blank
visualization is added to the dashboard and displayed.
From the Visualization Gallery,
click the ESRI Map icon. Note:
If the Visualization Gallery is not displayed, from the View
menu, select Visualization Gallery.
If the Properties panel is not
displayed, from the View menu, select Properties
Panel. If the Properties panel is hidden behind another panel,
click the Properties icon 
to display the Properties panel.
Select Map Options
from the drop-down list at the top of the Properties panel.
From the Map Type
drop-down list, select Density.
From the Map Style
drop-down list, select the display theme to apply to the map, such
as Street Map or Terrain Map.
Under Density Map Color
Gradient, select the color theme to use to show locations
on the map. For example, to display areas with a low density of locations
of interest as blue, and areas with a high density as red, select
the color theme that changes from blue to red.
You can determine whether or not
a legend is displayed for the map. The legend shows the relationship
between the color of each marker and the metric value for that location.
Do one of the following:
To display
the legend, select the Show Legend check box.
To hide
the legend, clear the Show Legend check box (default).
To display the Editor panel, from
the View menu, select Editor Panel.
If the Editor panel is hidden behind another panel, click the Editor icon 
to display
the Editor panel.
If the Datasets panel is not displayed,
from the View menu, select Datasets Panel.
From the Datasets
panel, click and drag dataset objects to the appropriate area in the
Editor panel, as follows:
To use attribute
forms to provide the locations in the visualization, click and drag
the attribute that contains the latitude and longitude information
to the Geo Attribute area. Web automatically detects
the Latitude and Longitude attribute forms and displays their names
in the Latitude and Longitude areas. Steps to select which attribute
forms to display in the map are included in this procedure. For example,
you can display the attribute’s description form but not the latitude
and longitude forms.
To use attributes
to provide the locations in the visualization, perform the following
steps:
Click
and drag the attribute that contains the latitude information to the
Latitude area.
Click
and drag the attribute that contains the longitude information to
the Longitude area.
For each attribute in the Editor
panel, you can select which attribute forms are displayed in the visualization.
An attribute form is a descriptive category for an attribute. For
a more detailed description, including how to select what attribute
information to display in the headers, see Selecting
which attribute forms to display in a visualization.
To select the attribute forms, in the Editor panel, right-click
the attribute and point to Display Attribute Form. Select
one of the following:
To display
an attribute form in the visualization, select the check box next
to its name.
To hide
an attribute form in the visualization, clear the check box next to
its name.
By default, when a user clicks
a location in the visualization, a tooltip containing additional information
about the location is displayed. You can include the values of additional
dataset objects, such as related attributes and metrics, in the tooltip.
To do this, from the Datasets
panel, click and drag the dataset objects to the Tooltip
section.
Click the Save
icon 
to save your changes.
To
create an ESRI Map visualization that displays areas:
Click the name of the dashboard
to run it.
From the toolbar, click the Insert
Visualization icon 
. A new blank
visualization is added to the dashboard and displayed.
From the Visualization Gallery,
click the ESRI Map icon. Note:
If the Visualization Gallery is not displayed, from the View
menu, select Visualization Gallery.
If the Properties panel is not
displayed, from the View menu, select Properties
Panel. If the Properties panel is hidden behind another panel,
click the Properties icon 
to display the Properties panel.
Select Map Options
from the drop-down list at the top of the Properties panel.
From the Map Type
drop-down list, select Area.
From the Map Style
drop-down list, select the display theme to apply to the map, such
as Street Map or Terrain Map.
From the Boundaries
drop-down list, select the name of the base map to use to display
areas in the map, such as World Admin Divisions or US States.
Specify whether to display a legend
for the map:
To display
the legend, select the Show Legend
check box.
To hide
the legend, clear the Show Legend check box (default).
To display the Editor panel, from
the View menu, select Editor Panel.
If the Editor panel is hidden behind another panel, click the Editor
icon 
to display the Editor panel.
If the Datasets panel is not displayed,
from the View menu, select Datasets Panel.
From the Datasets
panel, click and drag the attribute containing the location information
for each area to the Geo Attribute section in the Editor panel. You
can also drag objects from the Datasets panel directly onto the visualization.
To display map areas in different
colors based on the value of a metric, from the Datasets
panel, click and drag the metric to the Color By
section.
For each attribute in the Editor
panel, you can select which attribute forms are displayed in the visualization.
An attribute form is a descriptive category for an attribute. For
a more detailed description, including how to select what attribute
information to display in the headers, see Selecting
which attribute forms to display in a visualization.
To select the attribute forms, in the Editor panel, right-click
the attribute and point to Display Attribute Form. Select
one of the following:
To display
an attribute form in the visualization, select the check box next
to its name.
To hide
an attribute form in the visualization, clear the check box next to
its name.
You can customize the colors used
to display map areas based on the value of the metric in the Color
By section. To do so, you must define a threshold on the metric. In
the Color By section, right-click the metric and select Thresholds.
The Thresholds Editor opens. Select the appropriate
options to define the formatting to apply to the map areas.
By default, when a user clicks
an area in the visualization, a tooltip containing additional information
about the location is displayed. You can include the values of additional
dataset objects, such as related attributes and metrics, in the tooltip.
To do this, from the Datasets panel, click and drag
the dataset objects to the Tooltip section.
Click the Save
icon 
to save your changes.
Related topics
Formatting
visualizations
Dashboard
Editor: ESRI Map: Properties
_____________________________
Copyright © 2019, Oracle and/or its affiliates. All rights reserved.
Legal Notices