Download the PHP package donotcarry/geokit without Composer

Geokit

Geokit is a PHP toolkit to solve geo-related tasks like:

• Distance calculations.
• Heading, midpoint and endpoint calculations.
• Rectangular bounding box calculations.

• Geokit
  • Installation
  • Reference
  • Distance
  • Position
  • BoundingBox
  • Polygon
  • Functions
    • Distance calculations
    • Transformations
    • Other calculations
  • License

Installation

Install the latest version with Composer.

Check the Packagist page for all available versions.

Reference

Distance

A Distance instance allows for a convenient representation of a distance unit of measure.

A Distance can also be created from a string with an optional unit.

Position

A Position is a fundamental construct representing a geographical position in x (or longitude) and y (or latitude) coordinates.

Note, that x/y coordinates are kept as is, while longitude/latitude are normalized.

• Longitudes range between -180 and 180 degrees, inclusive. Longitudes above 180 or below -180 are normalized. For example, 480, 840 and 1200 will all be normalized to 120 degrees.
• Latitudes range between -90 and 90 degrees, inclusive. Latitudes above 90 or below -90 are normalized. For example, 100 will be normalized to 80 degrees.

BoundingBox

A BoundingBox instance represents a rectangle in geographical coordinates, including one that crosses the 180 degrees longitudinal meridian.

It is constructed from its left-bottom (south-west) and right-top (north-east) corner points.

With the expand() and shrink() methods, you can expand or shrink a BoundingBox instance by a distance.

The toPolygon() method converts the BoundingBox to an equivalent Polygon instance.

Polygon

A Polygon instance represents a two-dimensional shape of connected line segments and may either be closed (the first and last point are the same) or open.

Functions

Geokit provides several functions to perform geographic calculations.

Distance calculations

• distanceHaversine(Position $from, Position $to): Calculates the approximate sea level great circle (Earth) distance between two points using the Haversine formula.
• distanceVincenty(Position $from, Position $to): Calculates the geodetic distance between two points using the Vincenty inverse formula for ellipsoids.

Both functions return a Distance instance.

A static method from Distance can also be used to calculate the distance. The default function callback is distanceHaversine but can be modified at call time:

Transformations

The circle() function calculates a closed circle Polygon given a center, radius and steps for precision.

Other calculations

Other useful functions are:

• heading(Position $from, Position $to): Calculates the (initial) heading from the first point to the second point in degrees.
• midpoint(Position $from, Position $to): Calculates an intermediate point on the geodesic between the two given points.
• endpoint(Position $start, float $heading, Geokit\Distance $distance): Calculates the destination point along a geodesic, given an initial heading and distance, from the given start point.

License

Copyright (c) 2011-2022 Jan Sorgalla. Released under the MIT License.