OpenLayers v4.0.1 API - Class: Sphere

# Class: Sphere

This documentation is for OpenLayers v4.0.1. The latest is v.

## ol.Sphere

Class to create objects that can be used with `ol.geom.Polygon.circular`.

For example to create a sphere whose radius is equal to the semi-major axis of the WGS84 ellipsoid:

    var wgs84Sphere= new ol.Sphere(6378137);

#### new ol.Sphere(radius)

src/ol/sphere.js, line 29

  Name | Type | Description
  --- | --- | ---
  `radius` | number | Radius.

### Methods

#### geodesicArea(coordinates){number}

src/ol/sphere.js, line 53

  Returns the geodesic area for a list of coordinates.

  Reference Robert. G. Chamberlain and William H. Duquette, "Some Algorithms for Polygons on a Sphere", JPL Publication 07-03, Jet Propulsion Laboratory, Pasadena, CA, June 2007

  Name | Type | Description
  --- | --- | ---
  `coordinates` | Array.<ol.Coordinate> | List of coordinates of a linear ring. If the ring is oriented clockwise, the area will be positive, otherwise it will be negative.

  ##### Returns:

  Area.

#### haversineDistance(c1, c2){number}

src/ol/sphere.js, line 77

  Returns the distance from c1 to c2 using the haversine formula.

  Name | Type | Description
  --- | --- | ---
  `c1` | ol.Coordinate | Coordinate 1.
  `c2` | ol.Coordinate | Coordinate 2.

  ##### Returns:

  Haversine distance.