Improve method names

src/Interface/Entity/GeocodeInterface.php

@@ -18,7 +18,14 @@ interface GeocodeInterface
     public function setLongitude(float $lon): self;
 
     /**
-     * @return bool True if both latitude and longitude is set
+     * Used by {@see Pcm\GeocodeBundle\Service\Geocoder} to retrieve raw data for geocoding.
+     *
+     * @return string Data to use when geocodind an entity
+     */
+    public function getGeocodeData(): string;
+
+    /**
+     * @return bool True if both latitude and longitude are set and are not (0, 0)
      */
     public function isGeocoded(): bool;
 }

src/Service/Geocoder.php

@@ -6,6 +6,7 @@ namespace Pcm\GeocodeBundle\Service;
 
 use Pcm\GeocodeBundle\Exception\ApiErrorException;
 use Pcm\GeocodeBundle\Exception\NoResultsFoundException;
+use Pcm\GeocodeBundle\Interface\Entity\GeocodeInterface;
 use Pcm\GeocodeBundle\Model\GeoCoordinates;
 use Symfony\Contracts\HttpClient\HttpClientInterface;
 use Symfony\Contracts\HttpClient\ResponseInterface;
@@ -20,27 +21,28 @@ final class Geocoder
     public function __construct(private HttpClientInterface $client) {}
 
     /**
-     * Find and return the geo-coordinates of a postcode
+     * Find and return the geo-coordinates of an entity
      *
-     * @param string $postcode
+     * @param GeocodeInterface $entity
      *
      * @return GeoCoordinates
      *
      * @throws NoResultsFoundException when no results were found for the provided postcode
      * @throws ApiErrorException when the API response contains an error
      */
-    public function geocodePostcode(string $postcode): GeoCoordinates
+    public function geocode(GeocodeInterface $entity): GeoCoordinates
     {
+        $geocodeData = $entity->getGeocodeData();
         $client = $this->createClient();
-        $response = $this->makeApiRequest($client, $postcode);
+        $response = $this->makeApiRequest($client, $geocodeData);
         $data = $this->getDataFromResponse($response);
 
         if (array_key_exists('error', $data)) {
-            throw new ApiErrorException($postcode, $data['error']['message']);
+            throw new ApiErrorException($geocodeData, $data['error']['message']);
         }
 
         if (empty($data)) {
-            throw new NoResultsFoundException($postcode, "No results found.");
+            throw new NoResultsFoundException($geocodeData, "No results found.");
         }
 
         return $this->createGeoCoordinates($data);
@@ -53,7 +55,7 @@ final class Geocoder
         ]);
     }
 
-    private function makeApiRequest(HttpClientInterface $client, string $postcode): ResponseInterface
+    private function makeApiRequest(HttpClientInterface $client, string $geocodeData): ResponseInterface
     {
         return $client->request(
             method: 'GET',
@@ -61,7 +63,7 @@ final class Geocoder
             options: [
                 'query' => [
                     'format' => 'json',
-                    'postalcode' => $postcode
+                    'q' => $geocodeData
                 ]
             ]
         );

tests/Service/GeocoderTest.php

@@ -16,7 +16,7 @@ use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 /**
  * We sleep 1 second after API calls to prevent breaking the API T&Cs.
  */
-final class GeocodeTest extends KernelTestCase
+final class GeocoderTest extends KernelTestCase
 {
     // Buckingham Palace
     private const string POSTCODE = 'SW1A 1AA';
@@ -30,38 +30,36 @@ final class GeocodeTest extends KernelTestCase
         $this->geocoder = $kernel->getContainer()->get('pcm_geocode.geocoder');
     }
 
-    public function testGeocodeInstance(): void
+    public function testGeocodeThrowsOnEmptyInput(): void
-    {
-        $this->assertInstanceOf(Geocoder::class, $this->geocoder);
-    }
-
-    public function testGeocodePostcodeThrowsOnEmptyInput(): void
     {
         sleep(1);
         $this->expectException(ApiErrorException::class);
+        $entity = $this->createEntity('');
         $this->expectExceptionMessageMatches("/Nothing to search for.$/");
-        $this->geocoder->geocodePostcode('');
+        $this->geocoder->geocode($entity);
     }
 
-    public function testGeocodePostcodeThrowsOnInvalidPostcode(): void
+    public function testGeocodeThrowsOnInvalidPostcode(): void
     {
         sleep(1);
         $this->expectException(NoResultsFoundException::class);
         $this->expectExceptionMessageMatches("/No results found.$/");
-        $this->geocoder->geocodePostcode('ZZZZZZZZZZZZ');
+        $entity = $this->createEntity('Invalid Postcode');
+        $this->geocoder->geocode($entity);
     }
 
-    public function testGeocodePostcodeReturnsGeoCoordinates(): GeoCoordinates
+    public function testGeocodeReturnsGeoCoordinates(): GeoCoordinates
     {
         sleep(1);
-        $geoCoords = $this->geocoder->geocodePostcode(self::POSTCODE);
+        $entity = $this->createEntity(self::POSTCODE);
+        $geoCoords = $this->geocoder->geocode($entity);
         $this->assertNotNull($geoCoords);
 
         return $geoCoords;
     }
 
     /**
-     * @depends testGeocodePostcodeReturnsGeoCoordinates
+     * @depends testGeocodeReturnsGeoCoordinates
      */
     public function testCoordinatesAreSet(GeoCoordinates $geoCoordinates): void
     {
@@ -76,5 +74,23 @@ final class GeocodeTest extends KernelTestCase
             use GeocodeTrait;
         };
     }
+
+    private function createEntity(string $data): GeocodeInterface
+    {
+        $entity = new class implements GeocodeInterface {
+            use GeocodeTrait;
+
+            public string $data;
+
+            public function getGeocodeData(): string
+            {
+                return $this->data;
+            }
+        };
+
+        $entity->data = $data;
+
+        return $entity;
+    }
 }
 

tests/Trait/GeocodeTraitTest.php

@@ -94,6 +94,11 @@ final class GeocodeTraitTest extends TestCase
         return new class implements GeocodeInterface
         {
             use GeocodeTrait;
+
+            public function getGeocodeData(): string
+            {
+                return '';
+            }
         };
     }
 }