UKTowns\Models\HasCoordinates

Complexity

Total Complexity

12

Size/Duplication

Total Lines	95
Duplicated Lines	0 %

Test Coverage

Coverage

53.33%

Importance

Changes	1
Bugs	0	Features	0

11 Methods

Rating	Name	Duplication	Size	Complexity
A	getLongitude()	0	3	1
A	scopeNearest()	0	20	1
A	scopeNearestInMiles()	0	3	1
A	distanceColName()	0	3	1
A	latitudeColName()	0	3	1
A	scopeNearestInKilometers()	0	3	1
A	getDistanceAttribute()	0	7	2
A	getDistance()	0	3	1
A	scopeOrderByNearest()	0	3	1
A	longitudeColName()	0	3	1
A	getLatitude()	0	3	1

<?php

namespace UKTowns\Models;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Support\Facades\DB;

trait HasCoordinates
{
    /**
     * Table column name for latitude.
     */
    public function latitudeColName(): string
    {
        return $this->latitudeColumnName ?? 'latitude';
    }

    /**
     * Table column name for longitude.
     */
    public function longitudeColName(): string
    {
        return $this->longitudeColumnName ?? 'longitude';
    }

    /**
     * Filed name for distance. This field will be created only id use "nearest" scope.
     */
    public function distanceColName(): string
    {
        return $this->distanceColumnName ?? 'distance';
    }

    /**
     * Haversine formula (from Google solution example).
     * By default use radius in kilometers.
     */
    public function scopeNearest(Builder $query, float $lat, float $lng, float $radius, ?int $coef = null)
    {
        $coef = $coef ?? config('uk-towns.const.kilometers');

        $latColName        = $this->latitudeColName();
        $lngColName        = $this->longitudeColName();
        $distanceFieldName = $this->distanceColName();

        return $query->select([
            '*',
            DB::raw("
               ( {$coef} *
               acos(cos(radians({$lat})) *
               cos(radians({$latColName})) *
               cos(radians({$lngColName}) -
               radians({$lng})) +
               sin(radians({$lat})) *
               sin(radians({$latColName})))
            ) AS {$distanceFieldName} "),
        ])->having($distanceFieldName, '<=', $radius);
    }

    public function scopeNearestInKilometers(Builder $query, float $lat, float $lng, float $radius)
    {
        return $this->scopeNearest($query, $lat, $lng, $radius, config('uk-towns.const.kilometers'));
    }

    public function scopeNearestInMiles(Builder $query, float $lat, float $lng, float $radius)
    {
        return $this->scopeNearest($query, $lat, $lng, $radius, config('uk-towns.const.miles'));
    }

    /**
     * Order query results by distance.
     */
    public function scopeOrderByNearest(Builder $query, string $direction = 'asc')
    {
        return $query->orderBy($this->distanceColName(), $direction);
    }

    /**
     * Field has value only is use "nearest" scope.
     */
    public function getDistanceAttribute(): float
    {
        if (array_key_exists($this->distanceColName(), $this->attributes)) {
            return (float) $this->attributes[$this->distanceColName()];
        }

        return 0;
    }

    public function getLatitude(): ?float
    {
        return $this->{$this->latitudeColName()};
    }

    public function getLongitude(): ?float
    {
        return $this->{$this->longitudeColName()};
    }

    public function getDistance(): float
    {
        return $this->distance;
    }
}