Afonso\Emt\GeoClient

Complexity

Total Complexity

5

Size/Duplication

Total Lines	88
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

100%

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	getStreet()	0	9	1
A	getStopsFromStop()	0	8	1
A	getStopsFromXY()	0	9	1
A	getArriveStop()	0	5	1
A	callGeoService()	0	5	1

<?php

namespace Afonso\Emt;

use RuntimeException;

/**
 * The SDK client for the EMT OpenData API GEO service.
 *
 * @author Carlos Afonso Pérez <carlos.afonso.perez@gmail.com>
 */
class GeoClient extends Client
{
    /**
     * Return details about stops around a given address and, optionally,
     * within the specified radius.
     *
     * An optional radius can be passed as well.
     *
     * @param string $streetName
     * @param int $streetNumber
     * @param int|null $radius
     * @return \stdClass
     * @throws \RuntimeException
     */
    public function getStreet($streetName, $streetNumber, $radius = null)
    {
        $params = [
            'description' => $streetName,
            'streetNumber' => $streetNumber,
            'Radius' => $radius,
        ];
        return $this->callGeoService('GetStreet.php', $params);
    }

    /**
     * Return details about stops around a given stop and, optionally, within
     * the specified radius.
     *
     * @param int $stopId
     * @param int|null $radius
     * @return \stdClass
     * @throws \RuntimeException
     */
    public function getStopsFromStop($stopId, $radius = null)
    {
        $params = [
            'idStop' => $stopId,
            'Radius' => $radius,
        ];
        return $this->callGeoService('GetStopsFromStop.php', $params);
    }

    /**
     * Return details about stops around a given geographic coordinate and,
     * optionally, within the specified radius.
     *
     * @param int $stopId

There is no parameter named $stopId. Was it maybe removed?

     * @param int|null $radius
     * @return \stdClass
     * @throws \RuntimeException
     */
    public function getStopsFromXY($x, $y, $radius = null)
    {
        $params = [
            'coordinateX' => $x,
            'coordinateY' => $y,
            'Radius' => $radius,
        ];
        return $this->callGeoService('GetStopsFromXY.php', $params);
    }

    /**
     * Return incoming bus info for the given stop, such as distance and
     * waiting time.
     *
     * @param int $stopId
     * @return \stdClass
     * @throws \RuntimeException
     */
    public function getArriveStop($stopId)
    {
        $params = ['idStop' => $stopId];
        return $this->callGeoService('GetArriveStop.php', $params);
    }

    /**
     * Make an arbitrary call to the GEO service.
     *
     * @param string $endpoint
     * @param array $params
     * @return \stdClass
     */
    protected function callGeoService($endpoint, array $params = [])
    {
        $url = self::ENDPOINT . '/emt-proxy-server/last/geo/' . $endpoint;
        return $this->launcher->launchRequest($url, $params);
    }
}