PHPackages ujamii/geocoder-neos - 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. [Utility & Helpers](/categories/utility) 4. / 5. ujamii/geocoder-neos ActiveNeos-package[Utility & Helpers](/categories/utility) ujamii/geocoder-neos ==================== This package provides a very flexible way of geocoding your node properties. v0.1.0(5y ago)25.3k1PHPCI passing Since Jan 20Pushed 5y ago1 watchersCompare [ Source](https://github.com/ujamii/geocoder-neos)[ Packagist](https://packagist.org/packages/ujamii/geocoder-neos)[ RSS](/packages/ujamii-geocoder-neos/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (3)Versions (2)Used By (0) Geocoder Mixin for NEOS CMS =========================== [](#geocoder-mixin-for-neos-cms) [![Packagist](https://camo.githubusercontent.com/95d0f319deb2b67e4e15e204e56074efd8aa046d29dcefc8ea44b3386492445c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f756a616d69692f67656f636f6465722d6e656f732e7376673f636f6c6f72423d677265656e267374796c653d666c6174)](https://packagist.org/packages/ujamii/geocoder-neos) This package provides a very flexible way of geocoding your node properties. Imagine you have a document or content type with some physical address data (street, zip code, city) and you want to display this data on a map (for instance with [WebExcess.OpenStreetMap](https://github.com/webexcess/openstreetmap)) or you need the geo data for some calculations. Installation ------------ [](#installation) ``` composer req ujamii/geocoder-neos php-http/guzzle6-adapter ``` Usage ----- [](#usage) The package provides a new node type mixin "Ujamii.Geocoder:Mixin.AddressData". Add this mixin to the desired NodeType in your package: ``` 'Your.Package:Document.BranchLocation': superTypes: 'Neos.Neos:Document': true 'Ujamii.Geocoder:Mixin.AddressData': true ``` This will add some new properties to the node inspector. When you add address data there, the geodata will be added after you safe your changes. This is done by a pretty [feature rich package](https://github.com/geocoder-php/Geocoder) > Where is the difference to [FormatD.GeoIndexable](https://github.com/Format-D/FormatD.GeoIndexable) or [Wwwision.Neos.AddressEditor](https://github.com/bwaidelich/Wwwision.Neos.AddressEditor)? you may ask. Well, tha latter one also uses the geocoder package, but only make use of exactly one geocoding service: Google Maps. In contrast, this very package just integrates the geocoder package without any restrictions in its configuration. Although I included the [Nominatim/OpenStreetMap data provider](https://github.com/geocoder-php/nominatim-provider) as default here, you can use something [completely different](https://github.com/geocoder-php/Geocoder#providers), or with just a different config. This is what this makes this package a little more flexible. In the [`Configuration/Objects.yaml`](./Configuration/Objects.yaml) file, the [object management](https://flowframework.readthedocs.io/en/stable/TheDefinitiveGuide/PartIII/ObjectManagement.html)feature of NEOS is used to configure the geocoder/data provider used to get coordinates from your address data. ``` Geocoder\StatefulGeocoder: className: 'Geocoder\StatefulGeocoder' Geocoder\Provider\Nominatim\Nominatim: className: 'Geocoder\Provider\Nominatim\Nominatim' Ujamii\Geocoder\Service\GeocodingService: properties: geocoder: object: name: 'Geocoder\StatefulGeocoder' arguments: 1: object: name: 'Geocoder\Provider\Nominatim\Nominatim' arguments: 1: object: 'Http\Adapter\Guzzle6\Client' 2: value: 'https://nominatim.openstreetmap.org' 3: value: 'NEOS CMS Ujamii.Geocoder' 2: value: 'de' ``` As you can see, all the constructor arguments for the used objects are provided and can, of course, be changed by your own package and config. In the [`Configuration/Settings.yaml`](./Configuration/Settings.yaml) file, the property config can also be changed. So let's say you need some more properties, like a country or state. You can just add those to your NodeType or create your own mixin, which may have `Ujamii.Geocoder:Mixin.AddressData` as supertype again. The properties will be joined by a *space* character when sent to the data provider. But you are even free to exchange this part as well. The event after saving your node will check for a configured type, so if you created your own one, just set it in your settings: ``` Ujamii: Geocoder: GeocodingService: observedNodeType: 'Ujamii.Geocoder:Mixin.AddressData' observedProperties: ['street', 'zip', 'city'] mandatoryProperties: ['street', 'zip', 'city'] ``` Now, let's assume everything is configured the way you like, and you want to display a [nice map](https://github.com/webexcess/openstreetmap) with those documents added as map markers along with nice tooltips and an info popup (we also added some more properties): (for this example, install WebExcess.OpenStreetMap, but any other map will work as well) ``` prototype(Your.Package:Content.BranchLocationMap) < prototype(Neos.Neos:ContentComponent) { @context.branches = Neos.Fusion:Loop { items = ${q(site).find('[instanceof Your.Package:Document.BranchLocation]').get()} @glue = ',' itemRenderer = Neos.Fusion:RawArray { type = "Feature" properties { tooltip = ${q(item).property('title')} popup = Your.Package:Component.Molecule.BranchLocationMapPopup { company = ${q(item).property('company')} street = ${q(item).property('street')} zip = ${q(item).property('zip')} city = ${q(item).property('city')} phone = ${q(item).property('phone')} email = ${q(item).property('email')} } } geometry { type = "Point" coordinates = ${[q(item).property('longitude'), q(item).property('latitude')]} } @process.json = ${Json.stringify(value)} } } map = WebExcess.OpenStreetMap:Map.Component { json = ${'[' + branches + ']'} } renderer = afx` {props.map} ` } prototype(Your.Package:Component.Molecule.BranchLocationMapPopup) < prototype(Neos.Fusion:Component) { company = '' street = '' zip = '' city = '' phone = '' email = '' renderer = afx` {String.nl2br(props.company)} {props.street} {props.zip} {props.city} {props.phone} {props.email} ` } ``` ### Using a different provider [](#using-a-different-provider) Say, you want to use Google Maps as data provider. First, install the package: ``` composer require geocoder-php/google-maps-provider ``` Next, adjust the config: ``` Geocoder\StatefulGeocoder: className: 'Geocoder\StatefulGeocoder' Geocoder\Provider\GoogleMaps\GoogleMaps: className: 'Geocoder\Provider\GoogleMaps\GoogleMaps' Ujamii\Geocoder\Service\GeocodingService: properties: geocoder: object: name: 'Geocoder\StatefulGeocoder' arguments: 1: object: name: 'Geocoder\Provider\GoogleMaps\GoogleMaps' arguments: 1: object: 'Http\Adapter\Guzzle6\Client' 2: value: null 3: value: '' 2: value: 'de' ``` The same steps if you, for instance, dont want to use the default Guzzle 6 adapter. Just add your [desired library](https://packagist.org/providers/php-http/client-implementation): ``` composer require ... ``` and then configure it in the `Objects.yaml` providing optional config as constructor parameters, if you want. TODOs ----- [](#todos) - feature: multi language - feature: add an eel helper with methods for geocoding and reverse geocoding - feature: Command Controller for filling empty values (like for imported nodes) License and Contribution ------------------------ [](#license-and-contribution) [GPLv3](LICENSE) As this is OpenSource, you are very welcome to contribute by reporting bugs, improve the code, write tests or whatever you are able to do to improve the project. If you want to do me a favour, buy me something from my [Amazon wishlist](https://www.amazon.de/registry/wishlist/2C7LSRMLEAD4F). ### Health Score 27 — LowBetter than 49% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity25 Limited adoption so far Community8 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 Unknown Total 1 Last Release 1944d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1526725?v=4)[Michael Grundkötter](/maintainers/mgrundkoetter)[@mgrundkoetter](https://github.com/mgrundkoetter) --- Top Contributors [![mgrundkoetter](https://avatars.githubusercontent.com/u/1526725?v=4)](https://github.com/mgrundkoetter "mgrundkoetter (6 commits)") --- Tags geocoderneosneos-cms ### Embed Badge ![Health badge](/badges/ujamii-geocoder-neos/health.svg) ``` [![Health](https://phpackages.com/badges/ujamii-geocoder-neos/health.svg)](https://phpackages.com/packages/ujamii-geocoder-neos) ``` ### Alternatives [cheesegrits/filament-google-maps A Google Maps package for Filament PHP with field, column and widget 322533.2k1](/packages/cheesegrits-filament-google-maps)[infusionsoft/php-sdk PHP SDK for the Infusionsoft 1292.1M7](/packages/infusionsoft-php-sdk)[neos/eel The Embedded Expression Language (Eel) is a building block for creating Domain Specific Languages 122.0M27](/packages/neos-eel)[neos/form Extensible and flexible API for building web forms 18853.0k40](/packages/neos-form)[neos/fusion-form Fusion Form 19724.3k31](/packages/neos-fusion-form)[avency/neos-vardump Neos VarDump Package 147.1k](/packages/avency-neos-vardump) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)