Download the PHP package clonix/geokit without Composer
On this page you can find all versions of the php package clonix/geokit. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download clonix/geokit
More information about clonix/geokit
Files in clonix/geokit
Package geokit
Short Description Geo-Toolkit for PHP
License MIT
Homepage https://github.com/jsor/geokit
Informations about the package geokit
Geokit
Geokit is a PHP toolkit to solve geo-related tasks like:
- Distance calculations.
- Heading, midpoint and endpoint calculations.
- Rectangular bounding box calculations.
- Installation
- Reference
- Math
- Distance calculations
- Transformations
- Other calculations
- Distance
- Position
- BoundingBox
- Polygon
- Math
- License
- Credits
Installation
Install the latest version with Composer.
Check the Packagist page for all available versions.
Reference
Math
A Math instance can be used to perform geographic calculations on Position and BoundingBox instances.
The World Geodetic System 1984 (WGS84) is exclusively used as the coordinate reference system.
Distance calculations
A math instance provides two methods to calculate the distance between 2 points on the Earth's surface:
distanceHaversine(Geokit\Position $from, Geokit\Position $to)
: Calculates the approximate sea level great circle (Earth) distance between two points using the Haversine formula.distanceVincenty(Geokit\Position $from, Geokit\Position $to)
: Calculates the geodetic distance between two points using the Vincenty inverse formula for ellipsoids.
Both methods return a Distance instance.
Transformations
The circle()
method calculates a closed circle Polygon given a center, radius
and steps for precision.
Other calculations
Other useful methods are:
heading(Geokit\Position $from, Geokit\Position $to)
: Calculates the (initial) heading from the first point to the second point in degrees.midpoint(Geokit\Position $from, Geokit\Position $to)
: Calculates an intermediate point on the geodesic between the two given points.endpoint(Geokit\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.
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.
License
Copyright (c) 2011-2019 Jan Sorgalla. Released under the MIT License.
Credits
Geokit has been inspired and/or contains ported code from the following libraries:
All versions of geokit with dependencies
ext-json Version *