1tomany / php-geocoder-bundle

v0.0.5 2026-09-02 06:36 UTC

Requires

• php: >=8.5
• 1tomany/php-geocoder: ~0.0.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.93
• phpstan/phpstan: ^2.1.55
• phpunit/phpunit: ^13.1.11
• symfony/framework-bundle: ^7.2|^8.0|^8.1

MIT

• Vic Cherubini

Published on Packagist.org on 2026-09-02 06:37 UTC

README

This package wraps the 1tomany/php-geocoder library into an easy to use Symfony bundle.

Installation

Install the bundle using Composer:

composer require 1tomany/php-geocoder-bundle

Configuration

To change the default configuration, create a file named onetomany_geocoder.yaml in config/packages/ with the following contents and adjust accordingly:

onetomany_geocoder:
    transport:
        http_client: http_client

    google:
        api_key: "%env(GOOGLE_API_KEY)%"
        api_version: v4

    mock: false

The transport uses Symfony's http_client service by default, so the transport block can normally be omitted. The bundle injects Symfony's default serializer service into the transport.

The google block is optional. If it is omitted, the Google provider is not registered with the GeocoderClient. The Mock provider is disabled by default and can be enabled in the test environment with the following configuration:

when@test:
    onetomany_geocoder:
        mock: true

Usage

Inject the OneToMany\Geocoder\Contract\GeocoderClientInterface object and use its resources:

<?php

use OneToMany\Geocoder\Contract\GeocodingClientInterface;
use OneToMany\Geocoder\GeocodingVendor;
use OneToMany\Geocoder\Resource\ForwardGeocode;
use OneToMany\Geocoder\Resource\ReverseGeocode;

final readonly class GeocodeAddress
{
    public function __construct(
        private GeocodingClientInterface $client,
    ) {
    }

    public function __invoke(): void
    {
        $response = $this->client->forward(
            GeocodingVendor::Google,
            new ForwardGeocode(
                '123',
                'Main Street',
                null,
                'Dallas',
                '75205',
                'TX',
                'US',
            ),
        );

        $response = $this->client->reverse(
            GeocodingVendor::Google,
            new ReverseGeocode(
                '32.10391494',
                '-96.3931030',
            ),
        );
    }
}

Credits

• Vic Cherubini, 1:N Labs, LLC

License

The MIT License