nucleos/maps-bundle

This bundle provides simple map rendering in symfony application.

3.2.0 2023-07-20 11:35 UTC

Requires

• php: ^8.1
• ext-json: *
• geocoder-php/common-http: ^4.2
• geocoder-php/provider-implementation: ^1.0
• psr/log: ^1.0 || ^2.0 || ^3.0
• sonata-project/block-bundle: ^4.21 || ^5.0
• sonata-project/form-extensions: ^1.4 || ^2.0
• symfony/config: ^5.4 || ^6.2
• symfony/dependency-injection: ^5.4 || ^6.2
• symfony/expression-language: ^5.4 || ^6.2
• symfony/form: ^5.4 || ^6.2
• symfony/framework-bundle: ^5.4.19 || ^6.2.5
• symfony/http-foundation: ^5.4 || ^6.2
• symfony/http-kernel: ^5.4 || ^6.2
• symfony/options-resolver: ^5.4 || ^6.2
• symfony/twig-bridge: ^5.4 || ^6.2
• twig/twig: ^2.4 || ^3.0
• willdurand/geocoder: ^4.2
• willdurand/geocoder-bundle: ^5.11

Requires (Dev)

• ergebnis/composer-normalize: ^2.0.1
• geocoder-php/nominatim-provider: ^5.0
• nyholm/psr7: ^1.0
• php-http/mock-client: ^1.3
• psr/simple-cache: ^2.0 || ^3.0
• symfony/browser-kit: ^5.4 || ^6.2
• symfony/cache: ^6.2
• symfony/console: ^5.4 || ^6.2
• symfony/yaml: ^5.4 || ^6.2

Suggests

• geocoder-php/bing-maps-provider: For bing geocoder
• geocoder-php/google-maps-provider: For Google Maps geocoder
• geocoder-php/nominatim-provider: For OpenStreetMap geocoder

MIT

• Christian Gripp

• symfony
• sonata
• bundle
• block
• maps
• google maps
• widget
• OpenStreetMap
• sonata-block
• symfony-ux

README

This bundle provides simple map rendering in symfony application.

Installation

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

composer require nucleos/maps-bundle

composer require geocoder-php/nominatim-provider # if you want OpenStreetMaps Geocoder

Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in config/bundles.php file of your project:

// config/bundles.php

return [
    // ...
    Nucleos\MapsBundle\NucleosMapsBundle::class => ['all' => true],
];

Configure the Bundle

Create a configuration file called nucleos_maps.yaml and define geocoders:

# config/packages/nucleos_maps.yaml

bazinga_geocoder:
  providers:
    nominatim:
        factory: Bazinga\GeocoderBundle\ProviderFactory\NominatimFactory
        cache: 'cache.geocoder' # PSR16 Cache pool
        cache_lifetime: 3600
        cache_precision: 4

nucleos_maps:
    geocoder:
        service: 'bazinga_geocoder.provider.nominatim'

Usage

If you want dynamic address resultion:

{# template.twig #}

{{ sonata_block_render({ 'type': 'nucleos_maps.block.map' }, {
    'address': 'Hamburg',
    'service': 'openstreetmap'
}) }}

If you know the exact coordinates:

{# template.twig #}

{{ sonata_block_render({ 'type': 'nucleos_maps.block.map' }, {
    'longitude': '9.993682',
    'latitude': '53.551086',
    'service': 'openstreetmap'
}) }}

Assets

The assets can be loaded via stimulus. When using webpack-encore with enableStimulusBridge everything is pre-configured for you.

License

This bundle is under the MIT license.