SPINEN's Laravel Geometry

Wrapper over the geoPHP Class to make it integrate with Laravel better.

Build Status

Branch	Status	Coverage	Code Quality
Develop
Master

Prerequisite

phayes/geophp

Install

Install Geometry:

    $ composer require spinen/laravel-geometry

For >= Laravel 5.5, you are done with the Install

The package uses the auto registration feature

For < Laravel 5.5, you have to register the Service Provider

Add the Service Provider to config/app.php:

    'providers' => [
        // ...
        Spinen\Geometry\GeometryServiceProvider::class,
    ];

[Optional] Add the Facade to config/app.php:

    'aliases' => [
        // ...
        'Geo' => Spinen\Geometry\GeometryFacade::class,
    ];

Using the package

The Geometry Class exposes parseType methods where "Type" is StudlyCase of the geometry type that geoPHP supports. Here is a full list...

parseEwkb($geometry)
parseEwkt($geometry)
parseGeoHash($geometry)
parseGeoJson($geometry)
parseGeoRss($geometry)
parseGoogleGeocode($geometry)
parseGpx($geometry)
parseJson($geometry)
parseKml($geometry)
parseWkb($geometry)
parseWkt($geometry)

The geometries are wrapped in a Spinen\Geometry\Geometries namespace with a little sugar to be able to do

toEwkb()
toEwkt()
toGeoHash()
toGeoJson()
toGeoRss()
toGoogleGeocode()
toGpx()
toJson()
toKml()
toWkb()
toWkt()

In addition to the above export methods, we have added a toArray that gives an array from the toJson method. For convenience, we have exposed all of the properties of the geometry through a getter, so you have direct access to the property without having ask for the keys in the array.

Area of the polygon

We are estimating the area in meters squared & acres. We expect the estimation to be within 1%, so it is not very accurate. We essentially refactored a js method that Mapbox has in their geojson-area package . You get the area by calling the getAcres or getSquareMeters. There is a shortcut to them as properties, so you can read the "acres" or "square_meters" property.

mikeu/laravel-geometry