MarkLogic 12 Product Documentation

Geospatial Region Index Configuration Help

A Geospatial Region Index accelerates geospatial queries over regions such as polygons, circles, and boxes.

Each Geospatial Region Index keeps track of the regions appearing in all XML elements or JSON properties with a given path.

Configure the following for each Geospatial Region Index:

• path expression specifies the path.
• coordinate system specifies the name of the coordinate sytem used for the geospatial data. The default of wgs84 is useful for most commercial geospatial data. Use raw when you want your points mapped onto a flat plane instead of onto the geometry of the earth. Adding /double to the end of the coordinate system name means that the coordinate system uses double precision floating point numbers instead of single precision floating point numbers. For example, wgs84/double uses double precision.
• units Indicates which unit of measure to use for distances, including radii of circles. Ignored for "raw" and "raw/double" coordinate systems.
• precision specifies the precision of geohashes used in a geospatial region index. Higher values result in faster queries at the cost of larger index size and slower ingestion speed. Must be an integer between 2 and 6 if using a single precision coordinate system, 3 to 6 for double precision. Ignored for "raw" and "raw/double" coordinate systems.
• invalid values specifies whether server should allow insertion of documents that contain XML elements or JSON properties on which range index is configured and their contents cannot be coerced to the index data type. It can be configured to either ignore or reject. By default server rejects insertion of such documents. However, if a user configures invalid values to ignore, these documents can be inserted. This setting does not change the behavior of queries on invalid values after documents are inserted in the database. Performing an operation on an invalid value at query time can still result in an error.

---

Buttons and Tabs:

• Use the Configure tab to edit existing geospatial region index configurations. Click the delete button corresponding to a geospatial region index to remove it.
• Use the Add tab to add new geospatial region indexes to the database configuration.