yoti-8.x-2.5/sdk/Yoti/ShareUrl/Extension/LocationConstraintContent.php

<?php

namespace Yoti\ShareUrl\Extension;

use Yoti\Util\Validation;

/**
 * Defines an expected device location constraint.
 */
class LocationConstraintContent implements \JsonSerializable
{
    /**
     * @var int|float
     */
    private $latitude;

    /**
     * @var int|float
     */
    private $longitude;

    /**
     * @var int|float
     */
    private $radius;

    /**
     * @var int|float
     */
    private $maxUncertainty;

    /**
     * @param int|float $latitude
     *   Latitude of the user's expected location
     * @param int|float $longitude
     *   Longitude of the user's expected location
     * @param int|float $radius
     *   Radius of the circle, centred on the specified location
     *   coordinates, where the device is allowed to perform the share
     * @param int|float $maxUncertainty
     *   Maximum acceptable distance, in metres, of the area of
     *   uncertainty associated with the device location coordinates.
     */
    public function __construct($latitude, $longitude, $radius, $maxUncertainty)
    {
        Validation::withinRange($latitude, -90, 90, 'latitude');
        $this->latitude = $latitude;

        Validation::withinRange($longitude, -180, 180, 'longitude');
        $this->longitude = $longitude;

        Validation::notLessThan($radius, 0, 'radius');
        $this->radius = $radius;

        Validation::notLessThan($maxUncertainty, 0, 'maxUncertainty');
        $this->maxUncertainty = $maxUncertainty;
    }

    /**
     * @inheritDoc
     *
     * @return array
     */
    public function jsonSerialize()
    {
        return [
            'expected_device_location' => [
                'latitude' => $this->latitude,
                'longitude' => $this->longitude,
                'radius' => $this->radius,
                'max_uncertainty_radius' => $this->maxUncertainty,
            ]
        ];
    }

    /**
     * @return string
     */
    public function __toString()
    {
        return json_encode($this);
    }
}