Compare commits

..

4 Commits
0.0.3 ... 0.0.6

Author SHA1 Message Date
Brabli
31d29f2460 Fix broken latlong model 2022-10-17 15:38:10 +01:00
Brabli
6edbed9dfe Add attributes above lat long properties 2022-10-17 12:21:35 +01:00
Brabli
3c23d5e88d Require doctrine orm 2022-10-17 12:21:07 +01:00
Brabli
ee418a4844 Improvements 2022-09-26 11:50:04 +01:00
5 changed files with 44 additions and 19 deletions

View File

@@ -18,7 +18,8 @@
"symfony/http-client": "^6.1", "symfony/http-client": "^6.1",
"symfony/dependency-injection": "^6.1", "symfony/dependency-injection": "^6.1",
"symfony/framework-bundle": "^6.1", "symfony/framework-bundle": "^6.1",
"symfony/yaml": "^6.1" "symfony/yaml": "^6.1",
"doctrine/orm": "^2.13"
}, },
"require-dev": { "require-dev": {

View File

@@ -4,6 +4,8 @@ declare(strict_types=1);
namespace Pcm\GeocodeBundle\Entity\Trait; namespace Pcm\GeocodeBundle\Entity\Trait;
use Doctrine\ORM\Mapping as ORM;
/** /**
* Allows an entity to be mapped via latitude and longitude coordinates * Allows an entity to be mapped via latitude and longitude coordinates
* *
@@ -13,8 +15,10 @@ namespace Pcm\GeocodeBundle\Entity\Trait;
*/ */
trait MappableTrait trait MappableTrait
{ {
#[ORM\Column(type: 'decimal', precision: 10, scale: 6, nullable: true)]
private ?float $latitude = null; private ?float $latitude = null;
#[ORM\Column(type: 'decimal', precision: 10, scale: 6, nullable: true)]
private ?float $longitude = null; private ?float $longitude = null;
public function getLatitude(): ?float public function getLatitude(): ?float

View File

@@ -9,17 +9,17 @@ namespace Pcm\GeocodeBundle\Model;
* *
* @package Pcm\GeocodeBundle * @package Pcm\GeocodeBundle
*/ */
class LatLonModel class LatLongModel
{ {
public function __construct(private float $latitude, private float $longitude) {} public function __construct(private float $latitude, private float $longitude) {}
public function getLatitude(): float public function getLatitude(): float
{ {
return $this->getLatitude(); return $this->latitude;
} }
public function getLongitude(): float public function getLongitude(): float
{ {
return $this->getLongitude(); return $this->longitude;
} }
} }

View File

@@ -4,8 +4,7 @@ declare(strict_types=1);
namespace Pcm\GeocodeBundle\Service; namespace Pcm\GeocodeBundle\Service;
use Pcm\GeocodeBundle\Entity\GeocodeData; use Pcm\GeocodeBundle\Model\LatLongModel;
use Pcm\GeocodeBundle\Model\LatLonModel;
use Symfony\Contracts\HttpClient\HttpClientInterface; use Symfony\Contracts\HttpClient\HttpClientInterface;
use Symfony\Contracts\HttpClient\ResponseInterface; use Symfony\Contracts\HttpClient\ResponseInterface;
@@ -16,19 +15,19 @@ class Geocoder
public function __construct(private HttpClientInterface $client) {} public function __construct(private HttpClientInterface $client) {}
/** /**
* Returns a LatLonModel object * Convert a postcode into latitude and longitude
* *
* @param string $postcode * @param string $postcode
* @return GeocodeData * @return LatLongModel
*/ */
public function geocodePostcode(string $postcode): LatLonModel public function geocodePostcode(string $postcode): LatLongModel
{ {
$client = $this->createClient(); $client = $this->createClient();
$response = $this->requestGeocodeData($client, $postcode); $response = $this->makeApiRequest($client, $postcode);
$data = $response->toArray(); $data = $this->getDataFromResponse($response);
$this->throwIfNoResponseData($data); $this->throwIfDataIsEmpty($data);
return $this->createLatLonObject($data); return $this->createLatLongModel($data);
} }
private function createClient(): HttpClientInterface private function createClient(): HttpClientInterface
@@ -38,7 +37,7 @@ class Geocoder
]); ]);
} }
private function requestGeocodeData(HttpClientInterface $client, string $postcode): ResponseInterface private function makeApiRequest(HttpClientInterface $client, string $postcode): ResponseInterface
{ {
return $client->request( return $client->request(
method: 'GET', method: 'GET',
@@ -52,14 +51,32 @@ class Geocoder
); );
} }
private function throwIfNoResponseData(array $data): void private function getDataFromResponse(ResponseInterface $response): array
{
return $response->toArray(false);
}
private function throwIfDataIsEmpty(array $data): void
{ {
if (empty($data)) if (empty($data))
throw new \Exception("No data was received from API response! Were the arguments valid?"); throw new \Exception("No data was received from API response! Were the arguments valid?");
} }
private function createLatLonObject(array $data): LatLonModel private function createLatLongModel(array $data): LatLongModel
{ {
return new LatLonModel((float) $data[0]['lat'], (float) $data[0]['lon']); $lat = $this->getLatitudeFromData($data);
$long = $this->getLongitudeFromData($data);
return new LatLongModel($lat, $long);
}
private function getLatitudeFromData(array $data): float
{
return (float) $data[0]['lat'];
}
private function getLongitudeFromData(array $data): float
{
return (float) $data[0]['lon'];
} }
} }

View File

@@ -6,11 +6,14 @@ namespace Pcm\GeocodeBundle\Tests;
use Pcm\GeocodeBundle\Entity\Interface\MappableInterface; use Pcm\GeocodeBundle\Entity\Interface\MappableInterface;
use Pcm\GeocodeBundle\Entity\Trait\MappableTrait; use Pcm\GeocodeBundle\Entity\Trait\MappableTrait;
use Pcm\GeocodeBundle\Model\LatLonModel; use Pcm\GeocodeBundle\Model\LatLongModel;
use Pcm\GeocodeBundle\Service\Geocoder; use Pcm\GeocodeBundle\Service\Geocoder;
use Pcm\GeocodeBundle\Tests\AppKernel; use Pcm\GeocodeBundle\Tests\AppKernel;
use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase; use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
/**
* Note we sleep 1s after requests to prevent breaking the API T&Cs
*/
class GeocodeTest extends KernelTestCase class GeocodeTest extends KernelTestCase
{ {
// Buckingham Palace // Buckingham Palace
@@ -41,7 +44,7 @@ class GeocodeTest extends KernelTestCase
{ {
sleep(1); sleep(1);
$result = $this->geocoder->geocodePostcode(self::POSTCODE); $result = $this->geocoder->geocodePostcode(self::POSTCODE);
$this->assertInstanceOf(LatLonModel::class, $result); $this->assertInstanceOf(LatLongModel::class, $result);
} }
private function getMappableEntity(): MappableInterface private function getMappableEntity(): MappableInterface