Introduction to MapViewer 1-29
■
Use ips and ip_range elements to specify which IP addresses and ranges are allowed. Asterisk wildcards such as 20. are acceptable. Use a
comma-delimited list for addresses.
■
Use ips_exclude and ip_range_exclude elements to exclude IP addresses and address ranges from submitting administrative requests. If an
address falls into both the included and excluded category, it is excluded.
■
If you specify the asterisk wildcard in an ips element, all associated IP addresses are included except any specified in ips_exclude and ip_
range_exclude elements.
1.5.2.4 Specifying a Web Proxy
Sometimes the MapViewer server needs to make HTTP connections to external Web servers, such as to obtain a background image through a URL or to contact an external
WMS server to fetch its map images. In such cases, if there is a firewall between the MapViewer server and the target Web server, you may need to specify the HTTP proxy
information to MapViewer so that it will not be blocked by the firewall. The following example specifies Web proxy information:
web_proxy host=www-proxy.mycorp.com port=80
1.5.2.5 Specifying Global Map Configuration Options
You can specify the following global look and feel options for the display of each map generated by MapViewer:
■
Title
■
Note such as a copyright statement or a footnote
■
Logo custom symbol or corporate logo
■
Local geodetic data adjustment
■
Splitting geometries along the 180 meridian To specify any of these options, use the global_map_config element. For
example: global_map_config
note text=Copyright c 2009, Example Corporation font=sans serif
position=SOUTH_EAST title text=Map Courtesy of Example Corp.
font=Serif position=NORTH
logo image_path=C:\\images\\a.gif position=SOUTH_WEST
rendering allow_local_adjustment=false use_globular_projection=false
global_map_config
Set the map title through the title element of the global_map_config element. You can also set the map title in an individual map request by specifying the
title attribute with the map_request element, and in this case, the title in the map request is used instead of the global title in the MapViewer configuration file.
Note the following information about the attributes of the title element:
■
The text attribute specifies the title string.
1-30 Oracle Fusion Middleware Users Guide for Oracle MapViewer
■
The font attribute specifies a font. The font must exist on the system where MapViewer is running.
■
The position attribute provides a positioning hint to MapViewer when determining where the map title will be drawn on a map. Possible values are:
NORTH, EAST, SOUTH, WEST, NORTH_EAST, SOUTH_EAST, SOUTH_WEST, NORTH_ WEST, and CENTER.
Default value: NORTH Set the map note through the note element of the global_map_config
element. Note the following information about the attributes of the note element:
■
The text attribute specifies the note string.
■
The font attribute specifies a font. The font must exist on the system where MapViewer is running.
■
The position attribute provides a positioning hint to MapViewer when determining where the map note will be drawn on a map. Possible values are:
NORTH, EAST, SOUTH, WEST, NORTH_EAST, SOUTH_EAST, SOUTH_WEST, NORTH_ WEST, and CENTER.
Default value: SOUTH_EAST Set the map logo through the logo element of the global_map_config
element. The map logo image must be in either JPEG or GIF format. The image can be stored in a local file system where the MapViewer instance will have access to it, or it
can be obtained from the Web by specifying its URL. To specify a map logo, uncomment the map_logo element in the MapViewer configuration file and edit its
attributes as needed.
Note the following information about the attributes of the logo element:
■
The image_path attribute must specify a valid file path name, or a URL starting with http:.
■
The position attribute provides a positioning hint to MapViewer when determining where the map logo will be drawn on a map. Possible values are:
NORTH, EAST, SOUTH, WEST, NORTH_EAST, SOUTH_EAST, SOUTH_WEST, NORTH_ WEST, and CENTER.
Default value: SOUTH_WEST If the logo image is obtained through a URL that is outside your firewall, you may
need to set the Web proxy in order for MapViewer to retrieve the logo image. For information about specifying a Web proxy, see
Section 1.5.2.4 .
If you also specify a map legend, be sure that its position is not the same as any position for a map title, note, or logo. Map legends are explained in
Section 2.4.2 and
Section 3.2.11 . The default position for a map legend is SOUTH_WEST.
To have MapViewer automatically project geodetic data to a local non-geodetic coordinate system before displaying it if the map data window is less than 3 decimal
degrees, specify allow_local_adjustment=true in the rendering element.
To have MapViewer automatically apply a globular map projection that is, a map projection suitable for viewing the world, and specifically the azimuthal equidistant
projection for MapViewer, specify use_globular_projection=true in the rendering element. This option applies to geodetic data only.
Introduction to MapViewer 1-31
1.5.2.6 Customizing the Spatial Data Cache
