x

The following image is the Map tab of the Map Properties dialog box.

The options may vary, depending on the Center Location type.

Map Options

Center Location

Sets the center view of the Google Map to a bound geographical point at run time. The center location can be set dynamically or by a constant value.

• Dynamic.If these values are being retrieved from an external source, the source must contain two fields called LATITUDE and LONGITUDE, or if using an Address, a field called ADDRESS.

  Select a Source Type and a Source. This binds a Source file that contains coordinates to set the center view of the Google Map.

  An external file should only return one Latitude and Longitude value for the center point.

  You can use the AS NAME command to rename an existing field to the required names.

• Constant value. Manually type in a center value.

Location Type

Geographical position can be defined by Latitude or Longitude, or by an address.

The default is Latitude/Longitude.

Source Type

When using a Dynamic center value, select the source of your location data. Source Type options are URL, XML File, and External procedure.

If using an External procedure, the report output must be XML.

Source

When using a Dynamic center value, enter the source file for the source type.

The Source field provides an ellipsis button when using XML File and External procedures. Select the source file from the Get source file dialog box.

Value

When using a constant value, enter the Address or Latitude and Longitude value.

If entering a Latitude/Longitude value, the value entered should be Latitude and then Longitude separated with a comma (and/or space).

If entering a Latitude and Longitude value, it must be defined as a numeric value. For example, the following is latitude and longitude for New York, NY 10001:

40 45’ 58.73” N, 73 59” 1.48” W and converts to 40.7663277, -73.9920777.

An example of an Address value is: 2 Penn Plaza New York, NY 10001.

Settings

Default Map Type

Sets the default Google Map rendered at run time. Select from Map, Satellite, or Hybrid. Each option is presented as part of the Google Map in the output, allowing you to change views.

• Map presents geographical borders and streets. This is the default map type.
• Satellite presents real imagery.
• Hybrid presents real imagery with borders and streets.

Language

Sets the language of the options on the Google Map at run time.

Dragging

Controls the ability to drag the map in order to reposition the center point to a new location. This option is set by default.

Info Window

Renders Google Map Info Window if added to the map. This option is set by default.

Zoom

Zoom Level

Sets the default zoom level of the Google Map at run time. The levels available are 0 through 18. If the zoom level is set to 8 or higher, the initial map will have only one point visible. The default value is 10.

You may also change the zoom level in the output with the scrolling and arrow buttons on the Google Map.

Double Click Zoom

Enables you to double-click to zoom in and out of the map.

Continuous Zoom

Enables smooth, continuous zooming for select browsers.

Scroll Wheel Zoom

Enables you to use the scroll wheel of your mouse to zoom in and out of the map.

Selected Marker Image

Sets the icon/image associated with a marker when selected. Click the Selected Marker Image ellipsis button to open the Get source file dialog box and select a marker image.

Map Drill Down

Map Drill Down enable you to add a hyperlink to the Google Map to create a drill down. Only one drill down can be associated to a hyperlink.

Select the Action, Source, Target Type, and Target/Template Name:

Action

Set the action of the drill down hyperlink:

• To link to a URL, select URL in the Action section, and enter the URL in the Source field.
• To open an HTML page, select HTML in the Action section, and enter the HTML page in the Source field.
• To execute an embedded procedure, select Embedded procedure and enter the procedure name in the Source field.
• To execute an external procedure, select External procedure and enter the procedure name in the Source field, or click the browse (...) button to browse to the procedure.

Source

The source of the drill down values.

Target Type

Optionally, direct the output to a specific location by selecting Window, Frame, or Info Window in the Target Type field.

Target/Template Name

Identifies the target window or frame in the output for the map drill down.

The Target/Template name is not applicable for an Info window.

x

The following image is the Layers tab of the Map Properties dialog box.

Layers

Layers bind sources to the Google Map in order to define Google Map markers. Markers are presented at run time in the Google Map, as indicated with images at specified geographical points. Clicking the Google Map marker results in a drill down to a Source file and optionally, a ToolTip when pausing on a Google Map marker.

Select a Source Type, Source and Marker. Each Layer row will yield a designated marker in the Marker Groups box. Optionally, a selected marker can be associated with an Image, Drill Down, and ToolTip.

Source Type

Select the source of your layer. Source Type options are URL, XML File, and External procedure.

If using an External procedure, the report output must be XML.

Source

Enter the source file for the source type.

Note: The Source field provides an ellipsis button which enables you to select the source file from the Get source file dialog box.

When the source is selected, the Marker Groups box is populated with the values from the field MARKERS in the WebFOCUS procedure.

Name (Unique)

Applies a unique name that is used to identify a layer in the layer control and in JavaScript calls.

Note: A default name of Layer1, Layer2, and so on, is applied when you click the Add New button on the Layers tab. You may double-click in the field and manually type a unique name.

Visible

Controls the initial visibility of the marker groups, from the layer, when the map runs. The visible option is useful when you want to make selections on the Google Map without other markers, from other layers, interfering. For example, when making selections and doing a drill down, only visible markers should be selected and passed along.

• True shows the marker groups when the map runs. This is the default visible setting.
• False hides the marker groups when the map runs.

Refresh (Seconds)

You can refresh the source for a layer when the map runs. You may refresh a layer on demand, or automatically at a timed interval. The default refresh time is set to 0 seconds, which indicates that the automatic refresh is disabled. The minimum automatic refresh time is 60 seconds.

Refresh is not applicable to markers in the Marker Groups.

For more information about refreshing a Google Map, see How to Refresh the Google Maps Output.

Marker Groups

The Marker Group box lists all unique markers defined in the source of the highlighted source row. When the source is selected, the Marker Groups box changes, listing all markers in the selected Layer. Optionally, a selected marker can be associated with an Image, Drill Down, and ToolTip.

The possible values for markers are generated by previously defined fields in the Layer source. For more information about defining marker fields in a source, see Creating WebFOCUS Procedures for Google Maps.

Image/ToolTip

Select the Image and/or ToolTip to be associated for the selected marker.

• Select an image to be used to mark a point on the Google Map at run time.
• When hovering over a Google Map marker, a ToolTip containing a description of the selected Google Map marker appears.

Source Type

• Images can be an image or a field.
• ToolTips can be a constant value or a field.

Source

Enter the source field, or constant value, for the source type.

When the Source Type is Image, the Source field provides an ellipsis button which enables you to select the image file from the Get source file dialog box.

Drill Down

Drill Down is used to configure a drill down on each Google Map marker. This enables you to click on a marker and open the drill-down source.

Select the Action, Source, Target Type, and Target/Template Name:

Action

Set the action of the drill-down marker:

• To link to a URL, select URL in the Action section, and enter the URL in the Source field.
• To open an HTML page, select HTML in the Action section, and enter the HTML page in the Source field.
• To execute an embedded procedure, select Embedded procedure and enter the procedure name in the Source field.
• To execute an external procedure, select External procedure and enter the procedure name in the Source field, or click the browse (...) button to browse to the procedure.

Source

The source of the drill-down values.

Target Type

Optionally, direct the output to a specific location by selecting Window, Frame, or Info Window in the Target Type field.

Target/Template Name

Identifies the target window or frame in the output for the drill-down.

Update Selected Layer

Saves the selected layer upon completion of configuring or changing a layer.

Select each marker from the Marker Groups list to edit the associated image, ToolTip, or drill-down selections. After configuring or changing a marker, you must click Update Selected Layer to save and apply your changes.

x

The following image is the Advanced tab of the Map Properties dialog box.

Polygon Features

You can select multiple markers on Google Maps at run time by creating polygon shapes. Polygon features enable you to add both ToolTips and actions to all polygons when you pause on them in the Google Map.

For details about how to create Polygon shape selectors in the Google Map, see How to Create Polygons in the Google Maps Output.

Actions

Enables actions such as such as Copy, Delete, Move, and Resize for the polygon shape selectors on the Google Map.

All action options are selected by default. For details about actions, see Enabling Actions for Shape Selectors on the Google Maps.

ToolTip

ToolTips appear when you pause on a shape selector in the Google Map. You may choose to show the Area, Dimensions, and Marker Count for the polygon in the ToolTip.

All ToolTip options are selected by default. Dimensions appears as Radius (for a circle polygon shape) in the ToolTip.

Bullseye Charts

You can select multiple markers on Google Maps at run time by creating a bullseye chart. A bullseye chart is used to show radius distance from a location using three rings of increasing size. You may customize the ring and radius options of the bullseye chart.

For details about how to create a bullseye chart in the Google Map, see How to Create Bullseye Charts in the Google Maps Output.

Units

Options for the location distance are miles (mi) or kilometers (km), where miles is the default unit selection.

Number or rings

The number of rings to draw for the bullseye chart, where three rings is the default number of rings.

Inner Ring Radius

The inner ring radius is the distance between the center of the bullseye chart to the first ring, where 10 miles is the radius of distance.

Outer Ring Radius

The outer ring radius is the distance from the center of the bullseye chart, where 100 miles in the radius of distance.

When you set the number of rings, the inner radius, and the outer radius, any rings between the innermost and the outermost ring, are proportionally separated.

Menu Controls

Enables you to set the default menu controls on the Google Map rendered at run time. Select from Layers, Polygon, or Run. Each option is presented as a menu control of the Google Map in the output, allowing you to select additional options.

Layers

The Layers menu control provides options to show or hide markers in the layers of the Google Map, and manually refresh the layer(s).

Polygon

The New Polygon menu control provides options to select multiple markers on Google Maps by creating shape selectors such as a freehand polygon, rectangle, or bullseye chart.

Run

The Run menu control runs the drill downs for the selected markers.

x

Customize the Google Map by selecting the map and layer options.

1. From the Map Properties dialog box, select the starting center point for the map in the Center Location section of the Map tab.
   • If you are using a Dynamic value, select the Location Type, Source Type and a Source.

     Source Type options are URL, XML File, and External procedure. If you are using an External procedure, the report output must be XML.

     For example, select Dynamic, Latitude/Longitude from the Location Type drop-down list, and External procedure from the Source Type drop-down list. Click the Source ellipsis button to open the Get source file dialog box and double-click setcentervalue.fex as the external XML file. For details about the starting center point, see How to Create the Starting Center Point of the Google Map.

   • If you are using a Constant value, select the Location Type and enter the Value.

     An example of an Address value is: 2 Penn Plaza New York, NY 10001.

     If entering a Latitude and Longitude value, it must be defined as a numeric value. For example, the following is latitude and longitude for New York, NY 10001: 40 45’ 58.73” N, 73 59” 1.48” W and converts to 40.7663277, -73.9920777.

2. To set the image for a highlighted marker at run time, click the Selected Marker Image ellipsis button to open the Get source file dialog box, and select a marker image.

   For example, click the Selected Marker Image ellipsis button to open the Get source file dialog box and double-click purplepin.png as the marker image file.

3. Change the Zoom level to 6 and keep the other Default Map Type options.

   For more information about these properties, see Map Tab in the Map Properties Dialog Box.

4. From the Layers tab, bind one or more WebFOCUS procedures to load data into the Google Map by selecting the Source Type and Source. Optionally, you may edit the Name, Visible, and Refresh options for the source of the layer.

   For example, click the Add new button to create a layer. The default Source Type is External procedure. Click the Source ellipsis button to open the Get source file dialog box and double-click gmlayer.fex as the external layers file. For details about the layers file, see How to Create Google Map Latitude/Longitude Coordinates in the Source File.

   When the source is selected, the Marker Groups box is populated with the values from the Field markers in the WebFOCUS procedure.

   For more information about these properties, see Layers Tab in the Map Properties Dialog Box.

5. Double-click a group from the Marker Groups box to see the associated Image, ToolTip, and Drill Downs.

   The following image is an example of the Marker Groups box populated with markers created from the gmalyer.fex source file. For more information about creating markers in the source, see How to Create Google Map Marker Fields and ToolTip Fields in the Source File.

   

6. You may edit the Image, ToolTip, or Drill Down for each marker selected.

   Each marker can have its own image and ToolTip.

   For example, select greenicon from the Marker Groups box. Double-click greenpin.png from the Image Source section. Click Update Selected Layer to apply the image to the greenicon marker. Repeat this process to apply individual images to each of the markers.

   Tip: To select multiple markers at one time:

   • Click and hold the Shift key while selecting markers from the Marker Groups box.
   • Edit the ToolTip and drill-down options to apply the selections to all of the markers selected.

   For example, apply the ToolTip to all of the markers by selecting Field as the Source Type and REVENUE_RANGE as the Source field. Click Update Selected Layer to apply the ToolTip all of the selected markers.

7. Click Update Selected Layer to save the Image, ToolTip, and Drill Down settings for each of the markers selected.

   Note: You must select Update Selected Layer for each marker field that is edited to update and apply the image, ToolTip, or drill-down selection.

8. Click OK to close the Map Properties dialog box.
9. Select the Google Map object from the HTML Composer canvas and set the size and position in the Properties window:
   • Position: Left 30 px.
   • Position: Top 30 px.
   • Size: Height 260 px.
   • Size: Width 640 px.
10. Save and run the report.

    You may use Google Map controls to navigate around the map, zoom in or out, drag the map to a new position, select different map types, and see markers. For example, click the minus icon on the Google Map to zoom out and see all of the colored markers.

    

    Note: The Zoom In and Zoom Out slider control appears on the Google Map since the Size: Height property is greater than 280px. For details about setting properties, see How to Access the Google Map Properties.

    For more information about using Google Map controls, see the Google Map documentation from the Google Web site.