|Oracle® Spatial User's Guide and Reference
10g Release 1 (10.1)
Part Number B10826-01
The Oracle Spatial User's Guide and Reference provides usage and reference information for indexing and storing spatial data and for developing spatial applications using Oracle Spatial and Oracle Locator.
Oracle Spatial requires the Enterprise Edition of Oracle Database 10g. It is a foundation for the deployment of enterprise-wide spatial information systems, and Web-based and wireless location-based applications requiring complex spatial data management. Oracle Locator is a feature of the Standard and Enterprise Editions of Oracle Database 10g. It offers a subset of Oracle Spatial capabilities (see Appendix B for a list of Locator features) typically required to support Internet and wireless service applications and partner-based geographic information system (GIS) solutions.
The Standard and Enterprise Editions of Oracle Database 10g have the same basic features. However, several advanced features, such as extended data types, are available only with the Enterprise Edition, and some of these features are optional. For example, to use Oracle Database 10g table partitioning, you must have the Enterprise Edition and the Partitioning Option.
For information about the differences between Oracle Database 10g Standard Edition and Oracle Database 10g Enterprise Edition and the features and options that are available to you, see Oracle Database New Features.
Note:The relational geometry model of Oracle Spatial is no longer supported, effective with Oracle release 9.2. Only the object-relational model is supported.
This preface contains these topics:
This guide is intended for anyone who needs to store spatial data in an Oracle database.
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
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.
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.
This guide has two main parts (conceptual and usage information, and reference information) and a third part with supplementary information. The first part is organized for efficient learning about Oracle Spatial; it covers basic concepts and techniques first, and proceeds to more advanced material (such as coordinate systems, the linear referencing system, geocoding, and extending spatial indexing).This guide has the following elements.
Contains chapters with conceptual and usage information.
Explains important concepts and techniques that you need to know to use Spatial.
Explains the data types and metadata for Spatial. It includes a complete simplified example of using Spatial, as well as several examples of spatial geometries.
Explains how to load spatial data.
Explains how to index and query spatial data.
Provides conceptual and usage information about support for geocoding.
Provides conceptual and usage information about coordinate system (spatial reference system) support.
Provides conceptual and usage information about the Oracle Spatial linear referencing system (LRS).
Provides conceptual and usage information about the Oracle Spatial analysis and mining features for data mining applications.
Explains how to extend the capabilities of Oracle Spatial indexing.
Contains chapters with reference information.
Provides the syntax and semantics for SQL indexing statements.
Provides the syntax and semantics for methods used with the spatial object data type.
Provides the syntax and semantics for operators used with the spatial object data type.
Provides the syntax and semantics for the geometric functions and procedures.
Provides the syntax and semantics for the spatial aggregate functions.
Provides the syntax and semantics for the coordinate system transformation functions and procedures.
Provides the syntax and semantics for the functions and procedures related to the Oracle Spatial linear referencing system (LRS).
Provides the syntax and semantics for the migration procedure.
Provides the syntax and semantics for the spatial tuning functions and procedures.
Provides the syntax and semantics for the spatial utility functions and procedures.
Provides the syntax and semantics for the geocoding functions and procedures.
Provides the syntax and semantics for the spatial analysis and mining functions and procedures.
Contains appendixes and a glossary.
Describes installation, compatibility, and upgrade issues.
Describes Oracle Locator.
Provides examples, with explanations, of queries that are more complex than the examples in the reference chapters.
Defines important terms.
Technologies of interest to spatial application developers, but not officially part of Oracle Spatial, are sometimes made available through the Oracle Technology Network (OTN). To access the Spatial page on OTN, go to
For more information, see the following documents:
Oracle Database Error Messages - Spatial messages are in the range of 13000 to 13499.
Oracle error message documentation is only available in HTML. If you only have access to the Oracle Documentation CD, you can browse the error messages by range. Once you find the specific range, use your browser's "find in page" feature to locate the specific message. When connected to the Internet, you can search for a specific error message using the error message search feature of the Oracle online documentation.
Printed documentation is available for sale in the Oracle Store at
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
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
The following conventions are used in this guide:
|Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.|
|. . .||Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted.|
|boldface text||Boldface text indicates a term defined in the text, the glossary, or in both locations.|
||Monospace text is used for the names of parameters, files, and directory paths. It is also used for SQL and PL/SQL code examples.|
|italic text||Italic text is used for book titles, emphasis, and some special terms.|
|< >||Angle brackets enclose user-supplied names.|
|[ ]||Brackets enclose optional clauses from which you can choose one or none.|