This post describes how to create a simple thematic map, just a state population layer, with no underlying map tile layer. The map shows states color-coded by total population. The map is interactive with info-windows and can be panned and zoomed.
The sample code demonstrates the following:
Displaying an interactive vector layer with no background map tile layer (i.e. purpose and use of the Universe object)
Using a dynamic (i.e. defined via the javascript client API) color bucket style
Dynamically changing a layer's rendering style
Specifying which attribute value to use in determining the bucket, and hence style, for a feature (FoI)
The result is shown in the screenshot below.
The states layer was defined, and stored in the user_sdo_themes view of the mvdemo schema, using MapBuilder. The underlying
table is defined as
SQL> desc states_32775
Name Null? Type
----------------------------------------- -------- ----------------------------
STATE VARCHAR2(26)
STATE_ABRV VARCHAR2(2)
FIPSST VARCHAR2(2)
TOTPOP NUMBER
PCTSMPLD NUMBER
LANDSQMI NUMBER
POPPSQMI NUMBER
...
MEDHHINC NUMBER
AVGHHINC NUMBER
GEOM32775 MDSYS.SDO_GEOMETRY
We'll use the TOTPOP column value in the advanced (color bucket) style for rendering the states layers. The predefined theme (US_STATES_BI) is defined as follows.
SQL> select styling_rules from user_sdo_themes where name='US_STATES_BI';
STYLING_RULES
--------------------------------------------------------------------------------
<?xml version="1.0" standalone="yes"?>
<styling_rules highlight_style="C.CB_QUAL_8_CLASS_DARK2_1">
<hidden_info>
<field column="STATE" name="Name"/>
<field column="POPPSQMI" name="POPPSQMI"/>
<field column="TOTPOP" name="TOTPOP"/>
</hidden_info>
<rule column="TOTPOP">
<features style="states_totpop"> </features>
<label column="STATE_ABRV" style="T.BLUE_SERIF_10"> 1 </label>
</rule>
</styling_rules>
SQL>
The theme definition specifies that the state, poppsqmi, totpop, state_abrv, and geom columns will be queried from the states_32775
table. The state_abrv value will be used to label the state while the totpop value will be used to determine the color-fill from those defined in the states_totpop advanced style. The states_totpop style, which we will not use in our demo, is defined as shown below.
SQL> select definition from user_sdo_styles where name='STATES_TOTPOP';
DEFINITION
--------------------------------------------------------------------------------
<?xml version="1.0" ?>
<AdvancedStyle>
<BucketStyle>
<Buckets default_style="C.S02_COUNTRY_AREA">
<RangedBucket seq="0" label="10K - 5M" low="10000" high="5000000" style="C.SEQ6_01" />
<RangedBucket seq="1" label="5M - 12M" low="5000001" high="1.2E7" style="C.SEQ6_02" />
<RangedBucket seq="2" label="12M - 20M" low="1.2000001E7" high="2.0E7" style="C.SEQ6_04" />
<RangedBucket seq="3" label="> 20M" low="2.0000001E7" high="5.0E7" style="C.SEQ6_05" />
</Buckets>
</BucketStyle>
</AdvancedStyle>
SQL>
The demo defines additional advanced styles via the OM.style object and methods and uses those instead when rendering the states layer.
Now let's look at relevant snippets of code that defines the map extent and zoom levels (i.e. the OM.universe), loads the states predefined vector layer (OM.layer), and sets up the advanced (color bucket) style.
Defining the map extent and zoom levels.
function initMap()
{
//alert("Initialize map view");
// define the map extent and number of zoom levels.
// The Universe object is similar to the map tile layer configuration
// It defines the map extent, number of zoom levels, and spatial reference system
// well-known ones (like web mercator/google/bing or maps.oracle/elocation are predefined
// The Universe must be defined when there is no underlying map tile layer.
// When there is a map tile layer then that defines the map extent, srid, and zoom levels.
var uni= new OM.universe.Universe(
{
srid : 32775,
bounds : new OM.geometry.Rectangle(
-3280000, 170000, 2300000, 3200000, 32775),
numberOfZoomLevels: 8
});
The srid specifies the spatial reference system which is Equal-Area Projection (United States).
SQL> select cs_name from cs_srs where srid=32775 ;
CS_NAME
---------------------------------------------------
Equal-Area Projection (United States)
The bounds defines the map extent. It is a Rectangle defined using the lower-left and upper-right coordinates and srid.
Loading and displaying the states layer
This is done in the states() function. The full code is at the end of this post, however here's the snippet which defines the states VectorLayer.
// States is a predefined layer in user_sdo_themes
var layer2 = new OM.layer.VectorLayer("vLayer2",
{
def:
{
type:OM.layer.VectorLayer.TYPE_PREDEFINED,
dataSource:"mvdemo",
theme:"us_states_bi",
url: baseURL,
loadOnDemand: false
},
boundingTheme:true
});
The first parameter is a layer name, the second is an object literal for a layer config. The config object has two attributes: the first is the layer definition, the second specifies whether the layer is a bounding one (i.e. used to determine the current map zoom and center such that the whole layer is displayed within the map window) or not. The layer config has the following attributes:
type - specifies whether is a predefined one, a defined via a SQL query (JDBC), or in a json-format file (DATAPACK)
theme - is the predefined theme's name
url - is the location of the mapviewer server
loadOnDemand - specifies whether to load all the features or just those that lie within the current map window and load additional ones as needed on a pan or zoom
The code snippet below dynamically defines an advanced style and then uses it, instead of the 'states_totpop' style, when rendering the states layer.
// override predefined rendering style with programmatic one
var theRenderingStyle =
createBucketColorStyle('YlBr5', colorSeries, 'States5', true);
// specify which attribute is used in determining the bucket (i.e. color) to use for the state
// It can be an array because the style could be a chart type (pie/bar)
// which requires multiple attribute columns
// Use the STATE.TOTPOP column (aka attribute) value here
layer2.setRenderingStyle(theRenderingStyle, ["TOTPOP"]);
The style itself is defined in the createBucketColorStyle() function.
Dynamically defining an advanced style
The advanced style used here is a bucket color style, i.e. a color style is associated with each bucket. So first we define the colors and then the buckets.
numClasses = colorSeries[colorName].classes;
// create Color Styles
for (var i=0; i < numClasses; i++)
{
theStyles[i] = new OM.style.Color(
{fill: colorSeries[colorName].fill[i],
stroke:colorSeries[colorName].stroke[i],
strokeOpacity: useGradient? 0.25 : 1
});
};
numClasses is the number of buckets. The colorSeries array contains the color fill and stroke definitions and is:
var colorSeries = {
//multi-hue color scheme #10 YlBl.
"YlBl3": { classes:3,
fill: [0xEDF8B1, 0x7FCDBB, 0x2C7FB8],
stroke:[0xB5DF9F, 0x72B8A8, 0x2872A6]
},
"YlBl5": { classes:5,
fill:[0xFFFFCC, 0xA1DAB4, 0x41B6C4, 0x2C7FB8, 0x253494],
stroke:[0xE6E6B8, 0x91BCA2, 0x3AA4B0, 0x2872A6, 0x212F85]
},
//multi-hue color scheme #11 YlBr.
"YlBr3": {classes:3,
fill:[0xFFF7BC, 0xFEC44F, 0xD95F0E],
stroke:[0xE6DEA9, 0xE5B047, 0xC5360D]
},
"YlBr5": {classes:5,
fill:[0xFFFFD4, 0xFED98E, 0xFE9929, 0xD95F0E, 0x993404],
stroke:[0xE6E6BF, 0xE5C380, 0xE58A25, 0xC35663, 0x8A2F04]
},
etc.
Next we create the bucket style.
bucketStyleDef = {
numClasses : colorSeries[colorName].classes,
// classification: 'custom', //since we are supplying all the buckets
// buckets: theBuckets,
classification: 'logarithmic', // use a logarithmic scale
styles: theStyles,
gradient: useGradient? 'linear' : 'off'
// gradient: useGradient? 'radial' : 'off'
};
theBucketStyle = new OM.style.BucketStyle(bucketStyleDef);
return theBucketStyle;
A BucketStyle constructor takes a style definition as input. The style definition specifies the number of buckets (numClasses), a classification scheme (which can be equal-ranged, logarithmic scale, or custom), the styles for each bucket, whether to use a gradient effect, and optionally the buckets (required when using a custom classification scheme).
The full source for the demo
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Oracle Maps V2 Thematic Map Demo</title>
<script src="http://localhost:8080/mapviewer/jslib/v2/oraclemapsv2.js" type="text/javascript">
</script>
<script type="text/javascript">
//var $j = jQuery.noConflict();
var baseURL="http://localhost:8080/mapviewer"; // location of mapviewer
OM.gv.proxyEnabled =false; // no mvproxy needed
OM.gv.setResourcePath(baseURL+"/jslib/v2/images/"); // location of resources for UI elements like nav panel buttons
var map = null; // the client mapviewer object
var statesLayer = null, stateCountyLayer = null; // The vector layers for states and counties in a state
var layerName="States";
// initial map center and zoom
var mapCenterLon = -20000;
var mapCenterLat = 1750000;
var mapZoom = 2;
var mpoint = new OM.geometry.Point(mapCenterLon,mapCenterLat,32775);
var currentPalette = null, currentStyle=null;
// set an onchange listener for the color palette select list
// initialize the map
// load and display the states layer
$(document).ready( function()
{
$("#demo-htmlselect").change(function() {
var theColorScheme = $(this).val();
useSelectedColorScheme(theColorScheme);
});
initMap();
states();
}
);
/**
* color series from ColorBrewer site (http://colorbrewer2.org/).
*/
var colorSeries = {
//multi-hue color scheme #10 YlBl.
"YlBl3": { classes:3,
fill: [0xEDF8B1, 0x7FCDBB, 0x2C7FB8],
stroke:[0xB5DF9F, 0x72B8A8, 0x2872A6]
},
"YlBl5": { classes:5,
fill:[0xFFFFCC, 0xA1DAB4, 0x41B6C4, 0x2C7FB8, 0x253494],
stroke:[0xE6E6B8, 0x91BCA2, 0x3AA4B0, 0x2872A6, 0x212F85]
},
//multi-hue color scheme #11 YlBr.
"YlBr3": {classes:3,
fill:[0xFFF7BC, 0xFEC44F, 0xD95F0E],
stroke:[0xE6DEA9, 0xE5B047, 0xC5360D]
},
"YlBr5": {classes:5,
fill:[0xFFFFD4, 0xFED98E, 0xFE9929, 0xD95F0E, 0x993404],
stroke:[0xE6E6BF, 0xE5C380, 0xE58A25, 0xC35663, 0x8A2F04]
},
// single-hue color schemes (blues, greens, greys, oranges, reds, purples)
"Purples5": {classes:5,
fill:[0xf2f0f7, 0xcbc9e2, 0x9e9ac8, 0x756bb1, 0x54278f],
stroke:[0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3]
},
"Blues5": {classes:5,
fill:[0xEFF3FF, 0xbdd7e7, 0x68aed6, 0x3182bd, 0x18519C],
stroke:[0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3]
},
"Greens5": {classes:5,
fill:[0xedf8e9, 0xbae4b3, 0x74c476, 0x31a354, 0x116d2c],
stroke:[0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3]
},
"Greys5": {classes:5,
fill:[0xf7f7f7, 0xcccccc, 0x969696, 0x636363, 0x454545],
stroke:[0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3]
},
"Oranges5": {classes:5,
fill:[0xfeedde, 0xfdb385, 0xfd8d3c, 0xe6550d, 0xa63603],
stroke:[0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3]
},
"Reds5": {classes:5,
fill:[0xfee5d9, 0xfcae91, 0xfb6a4a, 0xde2d26, 0xa50f15],
stroke:[0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3, 0xd3d3d3]
}
};
function createBucketColorStyle(
colorName, colorSeries, rangeName, useGradient)
{
var theBucketStyle;
var bucketStyleDef;
var theStyles = [];
var theColors = [];
var aBucket, aStyle, aColor, aRange;
var numClasses ;
numClasses = colorSeries[colorName].classes;
// create Color Styles
for (var i=0; i < numClasses; i++)
{
theStyles[i] = new OM.style.Color(
{fill: colorSeries[colorName].fill[i],
stroke:colorSeries[colorName].stroke[i],
strokeOpacity: useGradient? 0.25 : 1
});
};
bucketStyleDef = {
numClasses : colorSeries[colorName].classes,
// classification: 'custom', //since we are supplying all the buckets
// buckets: theBuckets,
classification: 'logarithmic', // use a logarithmic scale
styles: theStyles,
gradient: useGradient? 'linear' : 'off'
// gradient: useGradient? 'radial' : 'off'
};
theBucketStyle = new OM.style.BucketStyle(bucketStyleDef);
return theBucketStyle;
}
function initMap()
{
//alert("Initialize map view");
// define the map extent and number of zoom levels.
// The Universe object is similar to the map tile layer configuration
// It defines the map extent, number of zoom levels, and spatial reference system
// well-known ones (like web mercator/google/bing or maps.oracle/elocation are predefined
// The Universe must be defined when there is no underlying map tile layer.
// When there is a map tile layer then that defines the map extent, srid, and zoom levels.
var uni= new OM.universe.Universe(
{
srid : 32775,
bounds : new OM.geometry.Rectangle(
-3280000, 170000, 2300000, 3200000, 32775),
numberOfZoomLevels: 8
});
map = new OM.Map(
document.getElementById('map'),
{
mapviewerURL: baseURL,
universe:uni
}) ;
var navigationPanelBar = new OM.control.NavigationPanelBar();
map.addMapDecoration(navigationPanelBar);
} // end initMap
function states()
{
//alert("Load and display states");
layerName = "States";
if(statesLayer)
{
// states were already visible but the style may have changed
// so set the style to the currently selected one
var theData = $('#demo-htmlselect').val();
setStyle(theData);
}
else
{
// States is a predefined layer in user_sdo_themes
var layer2 = new OM.layer.VectorLayer("vLayer2",
{
def:
{
type:OM.layer.VectorLayer.TYPE_PREDEFINED,
dataSource:"mvdemo",
theme:"us_states_bi",
url: baseURL,
loadOnDemand: false
},
boundingTheme:true
});
// add drop shadow effect and hover style
var shadowFilter = new OM.visualfilter.DropShadow({opacity:0.5, color:"#000000", offset:6, radius:10});
var hoverStyle = new OM.style.Color(
{stroke:"#838383", strokeThickness:2});
layer2.setHoverStyle(hoverStyle);
layer2.setHoverVisualFilter(shadowFilter);
layer2.enableFeatureHover(true);
layer2.enableFeatureSelection(false);
layer2.setLabelsVisible(true);
// override predefined rendering style with programmatic one
var theRenderingStyle =
createBucketColorStyle('YlBr5', colorSeries, 'States5', true);
// specify which attribute is used in determining the bucket (i.e. color) to use for the state
// It can be an array because the style could be a chart type (pie/bar)
// which requires multiple attribute columns
// Use the STATE.TOTPOP column (aka attribute) value here
layer2.setRenderingStyle(theRenderingStyle, ["TOTPOP"]);
currentPalette = "YlBr5";
var stLayerIdx = map.addLayer(layer2);
//alert('State Layer Idx = ' + stLayerIdx);
map.setMapCenter(mpoint);
map.setMapZoomLevel(mapZoom) ;
// display the map
map.init() ;
statesLayer=layer2;
// add rt-click event listener to show counties for the state
layer2.addListener(OM.event.MouseEvent.MOUSE_RIGHT_CLICK,stateRtClick);
} // end if
} // end states
function setStyle(styleName)
{
// alert("Selected Style = " + styleName);
// there may be a counties layer also displayed.
// that wll have different bucket ranges so create
// one style for states and one for counties
var newRenderingStyle = null;
if (layerName === "States")
{
if(/3/.test(styleName))
{
newRenderingStyle =
createBucketColorStyle(styleName, colorSeries, 'States3', false);
currentStyle =
createBucketColorStyle(styleName, colorSeries, 'Counties3', false);
}
else
{
newRenderingStyle =
createBucketColorStyle(styleName, colorSeries, 'States5', false);
currentStyle =
createBucketColorStyle(styleName, colorSeries, 'Counties5', false);
}
statesLayer.setRenderingStyle(newRenderingStyle, ["TOTPOP"]);
if (stateCountyLayer)
stateCountyLayer.setRenderingStyle(currentStyle, ["TOTPOP"]);
}
} // end setStyle
function stateRtClick(evt){
var foi = evt.feature;
//alert('Rt-Click on State: ' + foi.attributes['_label_'] +
// ' with pop ' + foi.attributes['TOTPOP']);
// display another layer with counties info
// layer may change on each rt-click so create and add each time.
var countyByState = null ;
// the _label_ attribute of a feature in this case is the state abbreviation
// we will use that to query and get the counties for a state
var sqlText =
"select totpop,geom32775 from counties_32775_moved where state_abrv="+
"'"+foi.getAttributeValue('_label_')+"'";
// alert(sqlText);
if (currentStyle === null)
currentStyle =
createBucketColorStyle('YlBr5', colorSeries, 'Counties5', false);
/* try a simple style instead
new OM.style.ColorStyle(
{
stroke: "#B8F4FF",
fill: "#18E5F4",
fillOpacity:0
}
);
*/
// remove existing layer if any
if(stateCountyLayer)
map.removeLayer(stateCountyLayer);
countyByState = new OM.layer.VectorLayer("stCountyLayer",
{def:{type:OM.layer.VectorLayer.TYPE_JDBC,
dataSource:"mvdemo",
sql:sqlText,
url:baseURL}});
// url:baseURL},
// renderingStyle:currentStyle});
countyByState.setVisible(true);
// specify which attribute is used in determining the bucket (i.e. color) to use for the state
countyByState.setRenderingStyle(currentStyle, ["TOTPOP"]);
var ctLayerIdx = map.addLayer(countyByState);
// alert('County Layer Idx = ' + ctLayerIdx);
//map.addLayer(countyByState);
stateCountyLayer = countyByState;
} // end stateRtClick
function useSelectedColorScheme(theColorScheme)
{
if(map)
{
// code to update renderStyle goes here
//alert('will try to change render style');
setStyle(theColorScheme);
}
else
{
// do nothing
}
}
</script>
</head>
<body bgcolor="#b4c5cc" style="height:100%;font-family:Arial,Helvetica,Verdana">
<h3 align="center">State population thematic map </h3>
<div id="demo" style="position:absolute; left:68%; top:44px; width:28%; height:100%">
<HR/>
<p/>
Choose Color Scheme:
<select id="demo-htmlselect">
<option value="YlBl3">
YellowBlue3</option>
<option value="YlBr3">
YellowBrown3</option>
<option value="YlBl5">
YellowBlue5</option>
<option value="YlBr5" selected="selected">
YellowBrown5</option>
<option value="Blues5">
Blues</option>
<option value="Greens5">
Greens</option>
<option value="Greys5">
Greys</option>
<option value="Oranges5">
Oranges</option>
<option value="Purples5">
Purples</option>
<option value="Reds5">
Reds</option>
</select>
<p/>
</div>
<div id="map" style="position:absolute; left:10px; top:50px; width:65%; height:75%; background-color:#778f99"></div>
<div style="position:absolute;top:85%; left:10px;width:98%" class="noprint">
<HR/>
<p> Note: This demo uses HTML5 Canvas and requires IE9+, Firefox 10+, or Chrome. No map will show up in IE8 or earlier.
</p>
</div>
</body>
</html>
