Understanding Data Requirements for Geographic Maps

27-10 Web User Interface Developers Guide for Oracle Application Development Framework

27.4.4 How to Customize Point Images in a Point Theme

A map point theme uses a default image to identify each point. However, you can specify multiple custom images for a point theme and identify the range of data values that each image should represent. You define a dvt:mapPointStyleItem tag for each custom image that you want to use in a map point theme. To customize the images for points in a map point theme: 1. In the Structure window, right-click the dvt:mapPointTheme node and select Insert inside dvt:mapPointTheme Point Style Item. 2. In the ensuing Insert Point Style Item wizard, provide settings for the data value range of this custom point by doing the following: a. In Step 1 of the wizard Common Properties, you must specify the URL for the image that should be displayed on the map for a point that falls in the data value range for this custom image. b. In Step 2 of the wizard Advanced Properties, specify the data value range that this custom image should represent by entering values in MaxValue and MinValue fields. c. In the Id field, enter a unique identifier for the custom image that you are defining. d. In the Short Label field, specify the descriptive text that you want to display in front of the actual data value when a user hovers the cursor over a point that falls in the range represented by this tag. For example, you might want to enter the following text for a custom point that falls in the lowest data value range: Low Inventory. e. Optionally, specify different image URLs for a hover image and a selected image.

f. Click Finish.

3. Repeat Step 1 and Step 2 for each custom image that you want to create for your point theme.

27.4.5 What Happens When You Customize the Point Images in a Map

When you use the Insert Point Style Item wizard to specify a custom image representing a range of data values for a point theme, a child dvt:mapPointStyleItem tag is defined inside the parent dvt:mapPointTheme tag. Example 27–2 shows the code generated on a JSF page for a map point theme that has three custom point images that represent ranges of inventory at each warehouse point. The initial point style setting ps0 applies to values that do not exceed 500. This point style displays an image for very low inventory and provides corresponding tooltip information. The second point style setting ps1 applies to values between 500 and 1000. This point style displays an image for low inventory and provides corresponding tooltip information. The final point style setting ps2 applies to values between 1000 and 1600. This point style displays an image for high inventory and provides corresponding tooltip information.