jackpopp/geodistance

Search for locations within a radius using latitude and longitude values with your eloquent models.

1.2.3 2015-07-07 10:58 UTC

This package is not auto-updated.

Last update: 2024-10-02 07:42:51 UTC


README

GeoDistance allows you to search for locations within a radius using latitude and longitude values with your eloquent models.

###Setup

Add geodistance to your composer file.

"jackpopp/geodistance": "dev-master"

Add the geodistance trait to your eloquent model and lat/lng columns to your table.

<?php namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Jackpopp\GeoDistance\GeoDistanceTrait;

class Location extends Model {

    use GeoDistanceTrait;

    protected $fillable = ['name', 'lat', 'lng'];
    
}

You can now search for locations within a distance, using miles or kilometers:

$lat = 51.4833;
$lng = 3.1833;

$locations = Location::within(5, 'miles', $lat, $lng)->get();

$locations = Location::within(5, 'kilometers', $lat, $lng)->get();

// or 

$location = new Location();
$locations = $location->lat($lat)->lng($lng)->within(5, 'miles')->get();

You can also search for locations outside a certain distance:

$lat = 51.4833;
$lng = 3.1833;

$locations = Location::outside(100, 'miles', $lat, $lng)->get();

$locations = Location::outside(100, 'kilometers', $lat, $lng)->get();

// or 

$location = new Location();
$locations = $location->lat($lat)->lng($lng)->outside(100, 'miles')->get();

Distances Available

Miles (miles/m) Kilometers (kilometers/km) Nautical Miles (nautical_miles) Feet (feet)

If you wish to add addtional measurements, please create a new issue.

Credit to movable-type.co.uk for information on selecting points withing a bounding circle - http://www.movable-type.co.uk/scripts/latlong-db.html