Spatial
Representations of spatial data.
Installation
composer require aeris/spatial
Components
GeometryConverter
The GeometryConverter component may be used to convert geometry data between different formats. The following conversions are currently supported:
- GeoJson Polygon to WKT
- GeoJson MultiPolygon to WKT
Additional conversions can be made by using Geometry objects directly, via the ConvertibleGeometryInterface::FromArray() and ConvertibleGeometryInterface::toWkt() methods (see Geometry component documentation)
Examples
use Aeris\Spatial\GeometryConverter;
$geoJson = json_encode([
'type' => 'Polygon',
'coordinates' => [
[
[100, 0],
[101, 0],
[101, 1],
[100, 1],
[100, 0],
]
]
]);
$wkt = GeometryConverter::geoJsonToWkt($geoJson);
$this->assertEquals(
'POLYGON((100 0,101 0,101 1,100 1,100 0))',
$wkt
);Geometry
Geometry components are object representations of spatial data structures. Objects implementing \Aeris\Spatial\Geometry\ConvertibleGeometryInterface may be easily converted between array and WKT (string) formats using the FromArray(array $data) and toWkt() methods
Some Geometry components may implement additional conversion methods. For example, \Aeris\Spatial\Geometry\MultiPolygon implements a FromFeatureCollection() method, which makes it easy to convert a GeoJson feature collection to a MultiPolygon object.
Examples
The following example demonstrates converting a GeoJson FeatureCollection into a MultiPolygon object.
$geoJson = [
'type' => 'FeatureCollection',
'features' => [
[
'type' => 'Feature',
'geometry' => [
'type' => 'Polygon',
'coordinates' => [
[
[100, 0],
[100, 100],
[0, 100],
[0, 0],
[100, 0],
]
]
],
],
[
'type' => 'Feature',
'geometry' => [
'type' => 'Polygon',
'coordinates' => [
[
[200, 0],
[200, 200],
[0, 200],
[0, 0],
[200, 0]
]
]
]
]
],
];
$mPoly = MultiPolygon::FromFeatureCollection($geoJson);
$this->assertEquals([
Polygon::FromArray([
[
[100, 0],
[100, 100],
[0, 100],
[0, 0],
[100, 0]
]
]),
Polygon::FromArray([
[
[200, 0],
[200, 200],
[0, 200],
[0, 0],
[200, 0]
]
])
], $mPoly->getPolygons());You could then use the MultiPolygon object to execute a MySql spatial query:
$myQuery = 'SELECT * FROM `places` ' .
'WHERE ST_CONTAINS(GeomFromText(' . $mPoly->toWKT() . '), `places`.`point`)' Util
The Aeris\Spatial\Util namespace contains some utility function for working with spatial components.
Util\bearing
Returns the direction (in degrees) between two coordinates.
$minneapolis = new Coordinate(-93.251953125, 44.9336963896947);
$chicago = new Coordinate(-87.71484375, 41.80407814427237);
Util\bearing($minneapolis, $chicago); // 125.93766052151
Util\bearing($chicago, $minneapolis); // 309.74293632484
Util\compassDirection
Returns the compass rose direction between two coordinates.
$minneapolis = new Coordinate(-93.251953125, 44.9336963896947);
$edenPrarie = new Coordinate(-93.4768295288086, 44.85148787683413);
Util\compassDirection($minneapolis, $edenPrarie); // 'SW'
Util\compassDirection($edenPrarie, $minneapolis); // 'NE'Possible return values:
- NNE
- NE
- ENE
- E
- ESE
- SE
- SSE
- S
- SSW
- SW
- WSW
- W
- WNW
- NW
- NNW
- N
