MarkLogic Server 11.0 Product Documentation
cts:geospatial-path-reference

cts:geospatial-path-reference(
   $path-expression as xs:string,
   [$options as xs:string*],
   [$map as map:map]
) as cts:reference

Summary

Creates a reference to a geospatial path range index, for use as a parameter to cts:value-tuples. This function will throw an exception if the specified range index does not exist.

Parameters

path-expression A path expression.

Parameters
path-expression	A path expression.
options	Options. The default is (). Options include: "type=type" Use the lexicon with the type specified by type (point or long-lat-point) "coordinate-system=`string`" Use the given coordinate system. Valid values are: wgs84 The WGS84 coordinate system with degrees as the angular unit. wgs84/radians The WGS84 coordinate system with radians as the angular unit. wgs84/double The WGS84 coordinate system at double precision with degrees as the angular unit. wgs84/radians/double The WGS84 coordinate system at double precision with radians as the angular unit. etrs89 The ETRS89 coordinate system. etrs89/double The ETRS89 coordinate system at double precision. raw The raw (unmapped) coordinate system. raw/double The raw coordinate system at double precision. "precision=value" Use the coordinate system at the given precision. Allowed values: `float` and `double`. "nullable" Allow null values in tuples reported from `cts:value-tuples` when using this lexicon. "unchecked" Read the scalar type and coordinate-system info only from the input. Do not check the definition against the context database.
map	A map of namespace bindings. The keys should be namespace prefixes and the values should be namespace URIs. These namespace bindings will be added to the in-scope namespace bindings in the interpretation of the path.

options

Options. The default is ().

Options include:

"type=type"

Use the lexicon with the type specified by type (point or long-lat-point)

"coordinate-system=string"

Use the given coordinate system. Valid values are:

wgs84
The WGS84 coordinate system with degrees as the angular unit.

wgs84/radians
The WGS84 coordinate system with radians as the angular unit.

wgs84/double
The WGS84 coordinate system at double precision with degrees as the angular unit.

wgs84/radians/double
The WGS84 coordinate system at double precision with radians as the angular unit.

etrs89
The ETRS89 coordinate system.

etrs89/double
The ETRS89 coordinate system at double precision.

raw
The raw (unmapped) coordinate system.

raw/double
The raw coordinate system at double precision.

"precision=value"

Use the coordinate system at the given precision. Allowed values: float and double.

"nullable"

Allow null values in tuples reported from cts:value-tuples when using this lexicon.

"unchecked"

Read the scalar type and coordinate-system info only from the input. Do not check the definition against the context database.

map A map of namespace bindings. The keys should be namespace prefixes and the values should be namespace URIs. These namespace bindings will be added to the in-scope namespace bindings in the interpretation of the path.

Usage Notes

The value of the precision option takes precedence over that implied by the governing coordinate system name, including the value of the coordinate-system option. For example, if the governing coordinate system is "wgs84/double" and the precision option is "float", then the reference uses single precision. An exception is thrown if an index with the specified precision does not exist.

Example

cts:geospatial-path-reference("//item/point")

=> cts:geospatial-path-reference("//item/point",
     ("type=point","coordinate-system=wgs84"))

MarkLogic Server 11.0 Product Documentationcts:geospatial-path-reference

Summary

Usage Notes

See Also

Example

MarkLogic Server 11.0 Product Documentation
cts:geospatial-path-reference