|
|
mcgm:geospatial-query(
|
|
$regions as cts:region*,
|
|
[$options as xs:string*],
|
|
[$weight as xs:double?]
|
| ) as cts:query |
|
|
|
Summary:
Returns a cts:query matching points within given regions.
|
Parameters:
|
$regions
:
One or more geographic boxes, circles, polygons, or points. Where multiple
boxes, circles, polygons, or points are specified, the query matches if
any box, circle, polygon, or
point matches.
|
$options
(optional):
Options to this query. The default is ().
Options include:
- "coordinate-system=wgs84"
- Use the WGS84 coordinate system.
- "boundaries-included"
- Points on boxes' and circles' boundaries are counted as matching. This is the default.
- "boundaries-excluded"
- Points on boxes' and circles' boundaries are not counted as matching.
- "boundaries-latitude-excluded"
- Points on boxes' latitude boundaries are not counted as matching.
- "boundaries-longitude-excluded"
- Points on boxes' longitude boundaries are not counted as matching.
- "boundaries-south-excluded"
- Points on the boxes' southern boundaries are not counted as matching.
- "boundaries-west-excluded"
- Points on the boxes' western boundaries are not counted as matching.
- "boundaries-north-excluded"
- Points on the boxes' northern boundaries are not counted as matching.
- "boundaries-east-excluded"
- Points on the boxes' eastern boundaries are not counted as matching.
- "boundaries-circle-excluded"
- Points on circles' boundary are not counted as matching.
|
|
$weight
(optional):
A weight for this query. The default is 1.0.
|
|
Usage Notes:
The point value is expressed in the content of the element as a pair
of numbers, separated by whitespace and punctuation (excluding decimal points
and sign characters).
Point values and boundary specifications of boxes are given in degrees
relative to the WGS84 coordinate system. Southern latitudes and Western
longitudes take negative values. Longitudes will be wrapped to the range
(-180,+180) and latitudes will be clipped to the range (-90,+90).
If the northern boundary of a box is south of the southern boundary, no
points will match. However, longitudes wrap around the globe, so that if
the western boundary is east of the eastern boundary,
then the box crosses the anti-meridian.
Special handling occurs at the poles, as all longitudes exist at latitudes
+90 and -90.
|
Example:
xquery version "1.0-ml";
(: create a document with test data :)
xdmp:document-insert("/points.xml",
<root xmlns:mcgm="http://marklogic.com/geospatial/mcgm">
<item><Dot Latitude="10.5" Longitude="30.0"/></item>
<item><Dot Latitude="15.35" Longitude="35.34"/></item>
<item><Dot Latitude="5.11" Longitude="40.55"/></item>
</root> );
xquery version "1.0-ml";
import module namespace mcgm = "http://marklogic.com/geospatial/mcgm"
at "/MarkLogic/geospatial/mcgm.xqy";
cts:search(doc("/points.xml")//item,
mcgm:geospatial-query(
cts:box(10.0, 35.0, 20.0, 40.0)))
(:
returns the following node:
<item><Dot Latitude="15.35" Longitude="35.34"/></item>
:)
,
cts:search(doc("/points.xml")//item,
mcgm:geospatial-query(cts:box(10.0, 40.0, 20.0, 35.0)))
(:
returns the following nodes (wrapping around the Earth):
<item><Dot Latitude="10.5" Longitude="30.0"/></item>
:)
,
cts:search(doc("/points.xml")//item,
mcgm:geospatial-query(
cts:box(10.0, 35.0, 20.0, 40.0)))
(:
returns the following node:
<item><Dot Latitude="15.35" Longitude="35.34"/></item>
:)
|
|
|
|
mcgm:geospatial-query-from-elements(
|
|
$regions as element()*,
|
|
[$options as xs:string*],
|
|
[$weight as xs:double?]
|
| ) as cts:query |
|
|
|
Summary:
Returns a cts:query matching points within given regions.
|
Parameters:
|
$regions
:
One or more geographic regions, represented by MCGM elements. Where multiple
regions are specified, the query matches if
any region matches.
|
$options
(optional):
Options to this query. The default is ().
Options include:
- "coordinate-system=wgs84"
- Use the WGS84 coordinate system.
- "boundaries-included"
- Points on boxes' and circles' boundaries are counted as matching. This is the default.
- "boundaries-excluded"
- Points on boxes' and circles' boundaries are not counted as matching.
- "boundaries-latitude-excluded"
- Points on boxes' latitude boundaries are not counted as matching.
- "boundaries-longitude-excluded"
- Points on boxes' longitude boundaries are not counted as matching.
- "boundaries-south-excluded"
- Points on the boxes' southern boundaries are not counted as matching.
- "boundaries-west-excluded"
- Points on the boxes' western boundaries are not counted as matching.
- "boundaries-north-excluded"
- Points on the boxes' northern boundaries are not counted as matching.
- "boundaries-east-excluded"
- Points on the boxes' eastern boundaries are not counted as matching.
- "boundaries-circle-excluded"
- Points on circles' boundary are not counted as matching.
|
|
$weight
(optional):
A weight for this query. The default is 1.0.
|
|
Usage Notes:
The point value is expressed in the content of the element as a pair
of numbers, separated by whitespace and punctuation (excluding decimal points
and sign characters).
Point values and boundary specifications of boxes are given in degrees
relative to the WGS84 coordinate system. Southern latitudes and Western
longitudes take negative values. Longitudes will be wrapped to the range
(-180,+180) and latitudes will be clipped to the range (-90,+90).
If the northern boundary of a box is south of the southern boundary, no
points will match. However, longitudes wrap around the globe, so that if
the western boundary is east of the eastern boundary,
then the box crosses the anti-meridian.
Special handling occurs at the poles, as all longitudes exist at latitudes
+90 and -90.
|
|
|