Merge pull request #9 from jameswilddev/fix/#5-toggle-address-validation-via-config

Add strict flag to configuration (fixes #5).

Author: DivineOmega

.gitignore

@@ -1,3 +1,4 @@
 /vendor/
 composer.lock
-.idea
+.idea
+.DS_Store

README.md

@@ -32,6 +32,15 @@ Note that by default, you require a Google Maps API key in order to provide
 address geocoding and distance calculations. If you do not wish to use geocoding,
 this can be disabled in the configuration.
 
+### Strict geocoding
+
+By default, geocoding is configured as "lenient"; if, for example, the name of a real city is given
+but the postcode and street address refer to a nonexistent place, it will geocode as the center of
+that city.
+
+Set the `geocoding.strict` flag to `true` in the configuration file to instead fail to geocode in
+this scenario.
+
 ## Usage
 
 Assign the `HasAddresses` trait to the model you wish to have associated addresses.

src/Models/Address.php

@@ -92,9 +92,13 @@ public function geocode(): void
             return;
         }
 
-        $latLng = GoogleMaps::instance()
-            ->allowPartialMatches()
-            ->geocode($this->human_readable);
+        $googleMaps = GoogleMaps::instance();
+
+        if (!config('addresses.geocoding.strict')) {
+            $googleMaps = $googleMaps->allowPartialMatches();
+        }
+
+        $latLng = $googleMaps->geocode($this->human_readable);
 
         if ($latLng) {
             $this->latitude = $latLng->lat;

src/config/addresses.php

@@ -9,6 +9,7 @@
         'enabled' => true,
         'google-maps' => [
             'api-key' => env('GEOCODING_GOOGLE_MAPS_API_KEY'),
-        ]
+        ],
+        'strict' => false,
     ]
 ];