Loading TOC...

geo.approxCenter

geo.approxCenter(
   $region as cts.region,
   [$options as String[]]
) as cts.point

Summary

Return a point approximating the center of the given region. For a point, this is the point itself. For a circle, it is the center point. For a box, it is the point whose latitude is half-way between the northern and southern limits and whose longitude is half-way between the western and eastern limits. For polygons, complex polygons, and linestrings, an approximate centroid is returned. This approximation is rough, and useful for quick comparisons.

Parameters
$region A geospatial region.
$options Options. The default is ().

Options include:

"box-percent=n"
An integer between 0 and 100 (default is 100) that indicates what percentage of a polygon's bounding box slivers should be used in constructing the approximate centroid. Lower numbers use fewer slivers, giving faster but less accurate results; larger numbers use more slivers, giving slower but more accurate results.
"coordinate-system=string"
Use the given coordinate system. Valid values are:
wgs84
The WGS84 coordinate system.
wgs84/double
The WGS84 coordinate system at double precision.
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"
The precision use for this operation, including the interpretation of input values. Allowed values: float, double. Default: The precision of the governing coordinate system.

Usage Notes

The value of the precision option always takes precedence over the 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 operation uses single precision.

The precision of the returned region is determined by the precision option, if present. Otherwise, the precision of the returned region is determined by the precision of the governing coordinate system.

See Also

Example

// Approximate center of London Zoo
geo.approxCenter(
    cts.polygon([
      cts.point(51.5361190,-0.1590335),
      cts.point(51.5366529,-0.1568234),
      cts.point(51.5372001,-0.1537657),
      cts.point(51.5372868,-0.1527464),
      cts.point(51.5334561,-0.1509440),
      cts.point(51.5332359,-0.1517808),
      cts.point(51.5348643,-0.1584756),
      cts.point(51.5355250,-0.1592481),
      cts.point(51.5360522,-0.1590765)
  ]));

==> cts.point(51.535511,-0.15516526)

Comments

    Powered by MarkLogic Server 7.0-4.1 and rundmc | Terms of Use | Privacy Policy