Available Map Themes Introduction to Geographic Maps

Using ADF Geographic Map Components 27-5

27.1.3.1 Geographic Map Parent Tags

The map component includes the following parent tags: ■ Map tag dvt:map: The parent tag for the main map component. Unlike other data visualization parent tags, the map tag is not bound to data. Instead, all the map theme child tags are bound individually to data collections. The map tag contains general information about the map including the identification of the base map, the URL for the remote server that is running Oracle Application Server MapViewer service and the URL for the Geocoder web service that converts street addresses into longitude and latitude coordinates for mapping. For a list and description of the child tags, see Section 27.1.3.2, Geographic Map Child Tags. ■ Map toolbar dvt:mapToolbar: A parent tag that allows the map toolbar to be placed in any location on a JSF page that contains a map. This toolbar contains a mapID attribute that points to the map associated with the toolbar. The toolbar lets you perform significant interaction with the map at runtime including the ability to display the map legend and to perform selection and distance measurement. The map toolbar tag has no child tags.

27.1.3.2 Geographic Map Child Tags

The dvt:map tag has the following child tags: ■ Color theme dvt:mapColorTheme: One of the optional map layers that you bind to a data collection. ■ Point theme dvt:mapPointTheme: One of the optional map layers that you bind to a data collection. The point theme identifies individual locations on a map. ■ Bar graph theme dvt:mapBarGraphTheme: One of the optional map layers that you must bind to a data collection. This theme displays a bar graph at points to represent multiple data values related to that location. For example, this tag might be used to display a graph that shows inventory levels at warehouse locations. ■ Pie graph theme dvt:mapPieGraphTheme: One of the optional map layers that you must bind to a data collection. This theme displays a pie graph at specific points to represent multiple values at that location. For example, this tag might be used to display a graph that shows inventory levels at warehouse locations. ■ Map legend dvt:mapLegend: Created automatically when you create a map. Use this tag to customize the map legend. ■ Overview map dvt:mapOverview: Created automatically when you create a map. Use this tag to customize the overview map that appears in the lower right-hand corner of the map.

27.1.3.3 Tags for Modifying Map Themes

The following tags modify various map themes: ■ Point style item dvt:mapPointStyleItem: An optional child tag of the dvt:mapPointTheme tag. Use this tag only if you want to customize the image that represents points that fall in a certain data value range. To define multiple images, create a tag for each image and specify the associated data value range and image. ■ Pie slice set dvt:mapPieSliceSet: A child of the dvt:mapPieGraphTheme tag. This is an optional tag that you use to wrap dvt:mapPieSliceItem tags, if you want to customize the color of the slices in a map pie graph. 27-6 Web User Interface Developers Guide for Oracle Application Development Framework ■ Pie slice item dvt:mapPieSliceItem: A child of the dvt:mapPieSliceSet tag. Each pie slice item tag customizes the color of one slice in a map pie graph. ■ Bar graph series set dvt:mapBarSeriesSet: A child of the dvt:mapBarGraphTheme tag. This is an optional tag that you use to wrap dvt:mapBarSeriesItem tags if you want to customize the color of bars in a map bar graph. ■ Bar graph series item dvt:mapBarSeriesItem: A child of the dvt:mapBarSeriesSet tag. Each bar graph series item tag customizes the color of one bar in a map bar graph.

27.2 Understanding Data Requirements for Geographic Maps

The following data requirements apply to the geographic map: ■ Configuration requirements include the following information: – Map Viewer URL: You must provide a URL for the location of the Oracle Application Server MapViewer service. This service is required to run the base map that provides the background for the layers in the ADF geographic map component. OracleAS MapViewer is a programmable tool for rendering maps using spatial data managed by Oracle Spatial. – Geocoder URL: If you want to convert street addresses into coordinates, then you must provide the URL for the Geocoder for the geographic map. A Geocoder is a Web service that converts street addresses into longitude and latitude coordinates for mapping. ■ Base map: You must have a base map created by the Map Builder tool in OracleAS MapViewer. This base map must define polygons at the level of detail that you require for your map themes to function as desired. For example, if you have a map pie graph or bar graph theme that you want to use for creating graphs in each state of a certain region, then you must have a base map that defines polygons for all these states at some zoom level. You can display only one graph in a polygon. ■ Data controls for map themes: Each map theme must be bound to a data control. The data control must contain location information that can be bound to similar information in the base map.

27.3 Customizing Map Size, Zoom Control, and Selection Area Totals

You can customize the map size, zoom strategy, appearance of selected regions, and the initial display of the information window and the scale bar.

27.3.1 How to Adjust the Map Size

You can control the width and height of the map by using the inlineStyle attribute in the dvt:map tag. To adjust the size of a map: 1. In the Structure window, right-click the dvt:map node and choose Go to Properties .

2. In the Style attributes category of the Property Inspector, enter the width and

height in the inlineStyle attribute. For example, to specify a width of 600 pixels and a height of 400 pixels, use the following setting: inlineStyle=width:600px;height:400px.