turf point-on-surface module


Keywords
turf, centroid, geojson, point, surface, polygon
License
MIT
Install
npm install turf-point-on-surface@3.0.12

Documentation

turf-point-on-surface

build status

turf point-on-surface module

turf.point-on-surface(input)

Takes a feature and returns a Point guaranteed to be on the surface of the feature.

  • Given a Polygon, the point will be in the area of the polygon
  • Given a LineString, the point will be along the string
  • Given a Point, the point will the same as the input

Parameters

parameter type description
input Feature\,FeatureCollection any feature or set of features

Example

// create a random polygon
var polygon = turf.random('polygon');

//=polygon

var pointOnPolygon = turf.pointOnSurface(polygon);

var resultFeatures = polygon.features.concat(pointOnPolygon);
var result = {
  "type": "FeatureCollection",
  "features": resultFeatures
};

//=result

Returns Feature, a point on the surface of input

Installation

Requires nodejs.

$ npm install turf-point-on-surface

Tests

$ npm test