Preface

Oracle Application Server MapViewer User's Guide describes how to install and use MapViewer, a tool that renders maps showing different kinds of spatial data.

This preface contains these topics:

• Audience

• Documentation Accessibility

• Organization

• Related Documentation

• Conventions

Audience

This document is intended primarily for programmers who develop applications that require maps to be drawn. You should understand Oracle database concepts and the major concepts associated with XML, including DTDs. You should also be familiar with Oracle Spatial or Oracle Locator concepts, or at least have access to Oracle Spatial User's Guide and Reference.

This document is not intended for end users of Web sites or client applications.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Organization

This guide contains the following elements:

Chapter 1, "Introduction to MapViewer"

Explains what MapViewer is, and how to install and configure it.

Chapter 2, "MapViewer Concepts"

Explains important concepts that you must understand to use MapViewer.

Chapter 3, "MapViewer Map Request XML API"

Explains how to submit XML requests to MapViewer, and describes the XML document type definitions (DTDs) for the requests (input) and responses (output).

Chapter 4, "MapViewer JavaBean-Based API"

Explains how to use the JavaBean-based MapViewer API, which exposes all capabilities of MapViewer through a single JavaBean.

Chapter 5, "MapViewer JSP Tag Library"

Explains how to submit requests to MapViewer using JavaServer Pages (JSP) tags in an HTML file.

Chapter 6, "MapViewer Administrative Requests"

Explains how to submit various administrative (non-map) requests, such as to add a data source, through the MapViewer XML API.

Chapter 7, "Map Definition Tool"

Explains the console (Map Definition Tool) interface to MapViewer, which you can use to manage mapping metadata (styles, themes, and maps) used by MapViewer.

Appendix A, "XML Format for Styles, Themes, and Base Maps"

Explains the XML format for defining each type of style. (This is intended only for advanced users of MapViewer.)

Appendix B, "JavaScript Functions for SVG Maps"

Describes the MapViewer JavaScript application programming interface (API) for SVG maps.

Appendix C, "Creating and Registering a Custom Image Renderer"

Explains how to implement and register a custom image renderer for use with an image theme.

Appendix D, "OGC WMS Support in MapViewer"

Describes the support for the Open GIS Consortium (OGC) Web Map Service (WMS) protocol in MapViewer map requests.

Related Documentation

For more information, see the following documents in the Oracle Database documentation set:

• Oracle Spatial User's Guide and Reference

• Oracle Spatial GeoRaster

• Oracle Spatial Topology and Network Data Models

• Oracle Database Concepts

• Oracle Database SQL Reference

See also the following document in the Oracle Application Server documentation set:

• Oracle Application Server High Availability Guide

Printed documentation is available for sale in the Oracle Store at

http://oraclestore.oracle.com/

To download free release notes, installation documentation, white papers, or other collateral, go to the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at

http://www.oracle.com/technology/membership

If you already have a username and password for OTN, then you can go directly to the documentation section of the OTN Web site at

http://www.oracle.com/technology/documentation

Conventions

In examples, an implied carriage return occurs at the end of each line, unless otherwise noted. You must press the Return key at the end of a line of input.

The following conventions are also used in this manual:

Convention	Meaning
. . .	Ellipsis points in code examples mean that parts not directly related to the example have been omitted.
boldface	Boldface type indicates a term defined in the text.
italic	Italic type is used for book titles, emphasis, and some special terms.
monospace	Monospace type is used for the names of parameters, elements, attributes, styles, themes, files, and directory paths. It is also used for code examples.
monospace italic	Monospace italic type is used to represent placeholders as variables.
< >	Angle brackets enclose XML tags and user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.