Geojson-polygon-labels NPM

geojson-polygon-labels

Command line tool to generate point labels from GeoJSON polygons.

Features include:

Supports GeoJSON FeatureCollections or GeoJSON Features separated by a newline
Point and LineString features present in the input are ignored
Supports GeometryCollections and MultiPolygons with options to label each part (--collections=explode), only the largest part (--collections=largest), or treat all parts as one (--collections=combine)
Label placement algorithm supported are:
- polylabel pole of inaccessibility, the most distant internal point from the polygon outline
- center, simple center by finding the midpoint between the extents of the polygon
- center of mass, imagine the polygon is a sheet of paper, finds where the sheet would balance on a fingertip
- center mean, takes the average of all the coordinates, unlike center it is sensitive to clusters and outliers
- center median, takes the mean center and tries to find, iteratively, a new point that requires the least amount of travel from all points in the polygon. not as sensitive to outliers as center-mean
- centroid, find the mean of all the verticies within the polygon
- point in polygon, finds an arbitrary point guaranteed to be within the polygon
Source feature properties are retained
Optionally adds an _area property (in m²) (--include-area)
Optionally adds a _bbox property ([west, south, east, north]) (--include-bbox)
Optionally adds a tippecanoe minzoom to each label (--include-minzoom)

Install

npm install --global geojson-polygon-labels

Command Line

geojson-polygon-labels [--polylabel-precision=0.001] [--coordinate-precision=5] [--include-area] [--include-bbox] [--method=polylabel] [--collections=explode] [--include-minzoom=0-16] [--verbose] layer.geojson > labels.geojson

--polylabel-precision Polylabel precision. Defaults to 0.000001.
--coordinate-precision Output coordinate precision. Defaults to 5.
--method Label placement algorithm. Options are polylabel, centroid, center-of-mass, center-mean, center-median, centroid, point-in-polygon.
--include-area Adds an _area property in m².
--include-bbox Adds a _bbox property as [west, south, east, north]
--include-minzoom will try to determine a suitable minzoom for the label to appear at and save it in the tippecanoe key for use in tippecanoe. Value in the form min-max where min is the smallest minzoom and max the largest minzoom.
--collections How to place labels for GeometryCollections or Multi* Geometry types. Options are explode, largest, combine.
--input-format Input format. Options are geojson, geojsonseq.
--output-format Output format. Options are geojson, geojsonseq.