PHPackages                             nucleos/maps-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. nucleos/maps-bundle

ActiveSymfony-bundle

nucleos/maps-bundle
===================

This bundle provides simple map rendering in symfony application.

3.5.0(7mo ago)59.9k2[16 PRs](https://github.com/nucleos/NucleosMapsBundle/pulls)MITPHPPHP ^8.3CI passing

Since Jun 20Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/nucleos/NucleosMapsBundle)[ Packagist](https://packagist.org/packages/nucleos/maps-bundle)[ Docs](https://nucleos.rocks)[ GitHub Sponsors](https://github.com/sponsors/core23)[ Fund](https://ko-fi.com/core23)[ RSS](/packages/nucleos-maps-bundle/feed)WikiDiscussions 3.6.x Synced 1mo ago

READMEChangelog (10)Dependencies (27)Versions (39)Used By (0)

NucleosMapsBundle
=================

[](#nucleosmapsbundle)

[![Latest Stable Version](https://camo.githubusercontent.com/57fe0e58fcfb21a0b5d057d23448309ed73c4adce81647b05797d30df7a0a33e/68747470733a2f2f706f7365722e707567782e6f72672f6e75636c656f732f6d6170732d62756e646c652f762f737461626c65)](https://packagist.org/packages/nucleos/maps-bundle)[![Latest Unstable Version](https://camo.githubusercontent.com/26eb6370db27f613900803bc11f1f4d2a62c2bad6d40adfe069bd794763938f0/68747470733a2f2f706f7365722e707567782e6f72672f6e75636c656f732f6d6170732d62756e646c652f762f756e737461626c65)](https://packagist.org/packages/nucleos/maps-bundle)[![License](https://camo.githubusercontent.com/91aa50e251c9bacbfedb76c4c8bcfc7d261751ce62cb088b4f8a51c9fbe1d5c2/68747470733a2f2f706f7365722e707567782e6f72672f6e75636c656f732f6d6170732d62756e646c652f6c6963656e7365)](LICENSE.md)

[![Total Downloads](https://camo.githubusercontent.com/ad253e543f52f131f824a47e6f9305a99af04546dffdfb91047db869e792d9df/68747470733a2f2f706f7365722e707567782e6f72672f6e75636c656f732f6d6170732d62756e646c652f646f776e6c6f616473)](https://packagist.org/packages/nucleos/maps-bundle)[![Monthly Downloads](https://camo.githubusercontent.com/d2293b5692e6415f8eb742298da34886a75dad29c2279329b50ec8c783d210e9/68747470733a2f2f706f7365722e707567782e6f72672f6e75636c656f732f6d6170732d62756e646c652f642f6d6f6e74686c79)](https://packagist.org/packages/nucleos/maps-bundle)[![Daily Downloads](https://camo.githubusercontent.com/37ee83f9315ddad79d6ec3c1eb8dd2037a6d9114fef6a0609e8aa2276373c5d8/68747470733a2f2f706f7365722e707567782e6f72672f6e75636c656f732f6d6170732d62756e646c652f642f6461696c79)](https://packagist.org/packages/nucleos/maps-bundle)

[![Continuous Integration](https://github.com/nucleos/NucleosMapsBundle/actions/workflows/continuous-integration.yml/badge.svg?event=push)](https://github.com/nucleos/NucleosMapsBundle/actions?query=workflow%3A%22Continuous+Integration%22+event%3Apush)[![Code Coverage](https://camo.githubusercontent.com/cf2c8165790fd16864daf46aff4c60c461caea1990ab6c688fb64c67301cfed5/68747470733a2f2f636f6465636f762e696f2f67682f6e75636c656f732f4e75636c656f734d61707342756e646c652f67726170682f62616467652e737667)](https://codecov.io/gh/nucleos/NucleosMapsBundle)

This bundle provides simple map rendering in symfony application.

Installation
------------

[](#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

[](#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

[](#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
-----

[](#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

[](#assets)

The assets can be loaded via [stimulus](https://stimulusjs.org/). When using [webpack-encore](https://github.com/symfony/webpack-encore) with `enableStimulusBridge` everything is pre-configured for you.

License
-------

[](#license)

This bundle is under the [MIT license](LICENSE.md).

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance78

Regular maintenance activity

Popularity29

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~94 days

Recently: every ~116 days

Total

22

Last Release

179d ago

Major Versions

1.1.0 → 2.0.02021-07-11

2.2.x-dev → 3.0.02022-02-25

PHP version history (5 changes)1.0.0PHP ^7.3

2.0.0PHP ^7.3 || ^8.0

2.1.0PHP ^8.0

3.1.0PHP ^8.1

3.5.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/46179d0f1a863a1a71c634a413d857f8428ad9a8273cd065ba4f0e864730dde9?d=identicon)[core23](/maintainers/core23)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (691 commits)")[![nucleos-bot](https://avatars.githubusercontent.com/u/60489587?v=4)](https://github.com/nucleos-bot "nucleos-bot (636 commits)")[![core23](https://avatars.githubusercontent.com/u/3440437?v=4)](https://github.com/core23 "core23 (218 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (43 commits)")[![kodiakhq[bot]](https://avatars.githubusercontent.com/in/29196?v=4)](https://github.com/kodiakhq[bot] "kodiakhq[bot] (4 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (4 commits)")

---

Tags

bundlegooglemapshacktoberfestmapsopenstreetmapphpsonatasonata-blocksymfonysymfony-bundlesymfony-uxsymfonybundlesymfony-uxwidgetmapsblockgoogle mapssonataOpenStreetMapsonata-block

### Embed Badge

![Health badge](/badges/nucleos-maps-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nucleos-maps-bundle/health.svg)](https://phpackages.com/packages/nucleos-maps-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sonata-project/admin-bundle

The missing Symfony Admin Generator

2.1k19.0M299](/packages/sonata-project-admin-bundle)[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)