feat: 🔧 Resolve container-bound providers instead of via reflection.

Author: mikebronner

config/geocoder.php

@@ -53,6 +53,19 @@
     | can explicitly call subsequently listed providers by
     | alias: `app('geocoder')->using('google_maps')`.
     |
+    | Providers that require a static factory method (e.g. `Nominatim::
+    | withOpenStreetMapServer()`, `GoogleMaps::business()`) can be bound
+    | in your AppServiceProvider — they'll be resolved via the container.
+    | Configure the provider here with an empty args array:
+    |
+    |   // AppServiceProvider::register()
+    |   $this->app->bind(Nominatim::class, fn ($app) => Nominatim::
+    |       withOpenStreetMapServer($app->make(LaravelHttpClient::class),
+    |       'MyApp/1.0'));
+    |
+    |   // config/geocoder.php
+    |   Nominatim::class => [],
+    |
     | Please consult the official Geocoder documentation for more info.
     | https://github.com/geocoder-php/Geocoder#providers
     |

src/ProviderAndDumperAggregator.php

@@ -15,6 +15,7 @@
 use Geocoder\Dumper\Wkb;
 use Geocoder\Dumper\Wkt;
 use Geocoder\Laravel\Exceptions\InvalidDumperException;
+use Geocoder\Provider\Chain\Chain;
 use Geocoder\ProviderAggregator;
 use Geocoder\Query\GeocodeQuery;
 use Geocoder\Query\ReverseQuery;
@@ -295,6 +296,10 @@ protected function getArguments(array $arguments, string $provider) : array
     protected function getProvidersFromConfiguration(Collection $providers) : array
     {
         $providers = $providers->map(function ($arguments, $provider) {
+            if (app()->bound($provider)) {
+                return app($provider);
+            }
+
             $arguments = $this->getArguments($arguments, $provider);
             $reflection = new ReflectionClass($provider);
 

tests/Feature/Providers/GeocoderServiceTest.php

@@ -272,6 +272,26 @@
     expect($result->getStreetNumber())->toBe('1600');
 });
 
+it('resolves providers from the service container when bound', function () {
+    app()->bind(Nominatim::class, fn () => Nominatim::withOpenStreetMapServer(
+        app(LaravelHttpClient::class),
+        'ContainerBoundAgent/1.0',
+    ));
+    config()->set('geocoder.providers', [
+        Nominatim::class => [],
+    ]);
+
+    $result = app('geocoder')
+        ->using('nominatim')
+        ->geocode('1600 Pennsylvania Ave NW, Washington, DC 20500, USA')
+        ->get()
+        ->first();
+
+    expect($result)->not->toBeNull();
+    expect($result->getStreetNumber())->toBe('1600');
+    Http::assertSent(fn ($request) => $request->header('User-Agent')[0] === 'ContainerBoundAgent/1.0');
+});
+
 it('does not collide reverse cache keys across coordinate signs', function () {
     $providerName = app('geocoder')->getProvider()->getName();
     $negativeKey = sha1("{$providerName}-" . strtolower(urlencode('-45.473282--73.834721')));