@mapbox/point-geometry
Advanced tools
A Point class for representing point geometry with useful utility methods.
$ npm install @mapbox/point-geometry
A standalone point geometry with useful accessor, comparison, and modification methods.
x number the x-coordinate. This could be longitude or screen pixels, or any other sort of unit.y number the y-coordinate. This could be latitude or screen pixels, or any other sort of unit.const point = new Point(-77, 38);
Clone this point, returning a new point that can be modified without affecting the old one.
Returns Point the clone
Add this point's x & y coordinates to another point, yielding a new point.
p Point the other pointReturns Point output point
Subtract this point's x & y coordinates to from point, yielding a new point.
p Point the other pointReturns Point output point
Multiply this point's x & y coordinates by point, yielding a new point.
p Point the other pointReturns Point output point
Divide this point's x & y coordinates by point, yielding a new point.
p Point the other pointReturns Point output point
Multiply this point's x & y coordinates by a factor, yielding a new point.
k number factorReturns Point output point
Divide this point's x & y coordinates by a factor, yielding a new point.
k number factorReturns Point output point
Rotate this point around the 0, 0 origin by an angle a, given in radians
a number angle to rotate around, in radiansReturns Point output point
Rotate this point around p point by an angle a, given in radians
Returns Point output point
Multiply this point by a 4x1 transformation matrix
Returns Point output point
Calculate this point but as a unit vector from 0, 0, meaning that the distance from the resulting point to the 0, 0 coordinate will be equal to 1 and the angle from the resulting point to the 0, 0 coordinate will be the same as before.
Returns Point unit vector point
Compute a perpendicular point, where the new y coordinate is the old x coordinate and the new x coordinate is the old y coordinate multiplied by -1
Returns Point perpendicular point
Return a version of this point with the x & y coordinates rounded to integers.
Returns Point rounded point
Return the magnitude of this point: this is the Euclidean distance from the 0, 0 coordinate to this point's x and y coordinates.
Returns number magnitude
Judge whether this point is equal to another point, returning true or false.
other Point the other pointReturns boolean whether the points are equal
Calculate the distance from this point to another point
p Point the other pointReturns number distance
Calculate the distance from this point to another point, without the square root step. Useful if you're comparing relative distances.
p Point the other pointReturns number distance
Get the angle from the 0, 0 coordinate to this point, in radians coordinates.
Returns number angle
Get the angle from this point to another point, in radians
b Point the other pointReturns number angle
Get the angle between this point and another point, in radians
b Point the other pointReturns number angle
Find the angle of the two vectors, solving the formula for the cross product a x b = |a||b|sin(θ) for θ.
Returns number the angle in radians
Construct a point from an array if necessary, otherwise if the input is already a Point, or an unknown type, return it unchanged
// this
var point = Point.convert([0, 1]);
// is equivalent to
var point = new Point(0, 1);
Returns Point constructed point, or passed-through value.
point-cluster is a library for clustering points on a 2D plane. It provides functionality for grouping points that are close to each other. Unlike @mapbox/point-geometry, which focuses on individual point operations, point-cluster is more about managing collections of points.
point-in-polygon is a library for checking if a point is inside a polygon. It provides a simple API for performing point-in-polygon tests. While @mapbox/point-geometry focuses on point operations, point-in-polygon is specialized for spatial queries involving polygons.
turf is a comprehensive geospatial analysis library that includes a wide range of functions for handling points, lines, and polygons. It offers more advanced geospatial operations compared to @mapbox/point-geometry, which is more lightweight and focused on basic point geometry.
FAQs
a point geometry with transforms
The npm package @mapbox/point-geometry receives a total of 5,299,821 weekly downloads. As such, @mapbox/point-geometry popularity was classified as popular.
We found that @mapbox/point-geometry demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 28 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Five malicious NuGet packages impersonate Chinese .NET libraries to deploy a stealer targeting browser credentials, crypto wallets, SSH keys, and local files.
Security News
pnpm 11 turns on a 1-day Minimum Release Age and blocks exotic subdeps by default, adding safeguards against fast-moving supply chain attacks.
Security News
The remediated findings include organization permission bugs, stale project access after transfers, OIDC replay edge cases, audit logging gaps, and an IDOR in API token deletion.