Module: ol/sphere

Methods

module:ol/sphere.getArea(geometry, opt_options){number}

sphere.js, line 180

Get the spherical area of a geometry. This is the area (in meters) assuming that polygon edges are segments of great circles on a sphere.

Name	Type	Description
geometry	module:ol/geom/Geometry~Geometry	A geometry.
options	Options for the area calculation. By default, geometries are assumed to be in 'EPSG:3857'. You can change this by providing a projection option. Name Type Default Description projection module:ol/proj~ProjectionLike 'EPSG:3857' Projection of the geometry. By default, the geometry is assumed to be in Web Mercator. radius number 6371008.8 Sphere radius. By default, the radius of the earth is used (Clarke 1866 Authalic Sphere).

Returns:

The spherical area (in square meters).

module:ol/sphere.getDistance(c1, c2, opt_radius){number}

sphere.js, line 44

Get the great circle distance (in meters) between two geographic coordinates.

Name	Type	Description
c1	Array	Starting coordinate.
c2	Array	Ending coordinate.
radius	number	The sphere radius to use. Defaults to the Earth's mean radius using the WGS84 ellipsoid.

Returns:

The great circle distance between the points (in meters).

module:ol/sphere.getLength(geometry, opt_options){number}

sphere.js, line 84

Get the spherical length of a geometry. This length is the sum of the great circle distances between coordinates. For polygons, the length is the sum of all rings. For points, the length is zero. For multi-part geometries, the length is the sum of the length of each part.

Name	Type	Description
geometry	module:ol/geom/Geometry~Geometry	A geometry.
options	Options for the length calculation. By default, geometries are assumed to be in 'EPSG:3857'. You can change this by providing a projection option. Name Type Default Description projection module:ol/proj~ProjectionLike 'EPSG:3857' Projection of the geometry. By default, the geometry is assumed to be in Web Mercator. radius number 6371008.8 Sphere radius. By default, the radius of the earth is used (Clarke 1866 Authalic Sphere).

Returns:

The spherical length (in meters).

Type Definitions

SphereMetricOptions{Object}

Object literal with options for the getLength or getArea functions.

Properties:

Name	Type	Argument	Default	Description
projection	module:ol/proj~ProjectionLike	<optional>	'EPSG:3857'	Projection of the geometry. By default, the geometry is assumed to be in Web Mercator.
radius	number	<optional>	6371008.8	Sphere radius. By default, the radius of the earth is used (Clarke 1866 Authalic Sphere).