Skip to main content
Returns the spherical centroid of a geography as a Geography point, computed on the sphere using S2:
  • Polygon / MultiPolygon — area-weighted centroid via S2Polygon.getCentroid().
  • LineString / MultiLineString — length-weighted centroid via S2Polyline.getCentroid().
  • Point / MultiPoint — mean of the unit vectors.
  • GeographyCollection — recursive weighted sum across the children.
The result is the unit-length centroid on the sphere. Unlike a planar (lon/lat) centroid, it is correct for antimeridian-crossing and high-latitude geographies. As with JTS for non-convex shapes, the centroid may lie outside the input geometry. Returns NULL when the centroid is undefined (empty geometry, or antipodal points whose unit vectors cancel).

​
Signatures

​
Parameters

​
Geography
required
The geography whose spherical centroid is returned.

​
Return type

The centroid as a Geography point, or NULL when undefined.

​
Example

For an antimeridian-crossing polygon, the spherical centroid stays on the antimeridian instead of jumping to the opposite side of the planet, which a planar centroid would do: