PHPackages ujamii/ujamii-geocoder - 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/ujamii-geocoder ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility) ujamii/ujamii-geocoder ====================== Connecting http://geocoder-php.org/Geocoder with TYPO3 DataHandler API v1.0.0(6y ago)3112[2 PRs](https://github.com/ujamii/ujamii-geocoder/pulls)MITPHP Since Mar 28Pushed 3y ago1 watchersCompare [ Source](https://github.com/ujamii/ujamii-geocoder)[ Packagist](https://packagist.org/packages/ujamii/ujamii-geocoder)[ RSS](/packages/ujamii-ujamii-geocoder/feed)WikiDiscussions master Synced 2mo ago READMEChangelogDependencies (4)Versions (12)Used By (0) ujamii-geocoder =============== [](#ujamii-geocoder) [![Packagist](https://camo.githubusercontent.com/9a94c1d62df3dd72e3511084c39fec5b31cc347bd38def36188b147040cb0155/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f756a616d69692f756a616d69692d67656f636f6465722e7376673f636f6c6f72423d677265656e267374796c653d666c6174)](https://packagist.org/packages/ujamii/ujamii-geocoder) Connecting with TYPO3 DataHandler API. With this extension you can easily add geo data to records while they are changed by editors in the TYPO3 backend. You just have to configure how your entity "looks like" in the eyes of the geocoder via TCA anf that's it. - [Installation](#installation) - [Usage](#usage) - [Example](#example) - [TODOs](#todos) Installation ------------ [](#installation) Currently only works in composer mode of TYPO3, so ``` composer require ujamii/ujamii-geocoder ``` Usage ----- [](#usage) Just add a new config array to the `ctrl` section of your TCA. ``` ..['ctrl']['geocoder'] = [ 'triggerFields' => ['street', 'zip', 'city'], 'getAddressString' => 'Your\Namespace\Domain\Model\YourEntity->getAddressString' ]; ``` And provide a method (e.g. in an entity or helper class) to generate a compound address string based on the database data of one entity (example below). ### Options [](#options) Those options are possible: **triggerFields (mandatory)** Changes in those fields will trigger the process of geocoding. **getAddressString (mandatory)** A method called via `TYPO3\CMS\Core\Utility\GeneralUtility::callUserFunction` which is supposed to return a complete address string. The first parameter provided to this method is the merged data array (unchanged entity data from db + changed values from the backend form). Example: ``` public function getAddressString($dataArray) { return $dataArray['location']; } ``` **locale** (default: de) The locale which is used in the geocoder. **latField** (default: lat) Name of the target field for the latitude value. **lngField** (default: lng) Name of the target field for the longitude value. **httpClientClass** (default: \\Http\\Adapter\\Guzzle6\\Client::class) Class name of the http client, see [possible packages](https://packagist.org/providers/php-http/client-implementation) **providerClass** (default: \\Geocoder\\Provider\\GoogleMaps\\GoogleMaps::class) Class name of the provider, see [possible packages](https://packagist.org/providers/geocoder-php/provider-implementation) **providerParams** Optional parameters for the provider. (e.g. an API key for Google Maps) **geocoderClass** (default: \\Geocoder\\StatefulGeocoder::class) Class name of the geocoder. Example ------- [](#example) Let's assume the record is a news record in the database with 3 fields: location, lat and lng. The field location contains something like `Alexanderplatz, Berlin, Deutschland` and lat and lng are the fields you want to be filled automatically as soon as an editor changes the location. Add this to your `typo3conf/ext/your_extension/Configuration/TCA/Overrides/tx_news_domain_model_news.php`or `typo3conf/ext/your_extension/Configuration/TCA/tx_ext_domain_model_entity.php` file. ``` $GLOBALS['TCA']['tx_news_domain_model_news']['ctrl']['geocoder'] = [ 'triggerFields' => ['street', 'zip', 'city'], 'getAddressString' => 'Your\Namespace\Domain\Model\YourEntity->getAddressString', 'providerParams' => [ 0 => null, 1 => null, 2 => '' ] ]; ``` In `YourEntity`, add a method like this: ``` public function getAddressString($dataArray) { return sprintf('%s, %s %s', $dataArray['street'], $dataArray['zip'], $dataArray['city']); } ``` Usage as command or in scheduler -------------------------------- [](#usage-as-command-or-in-scheduler) The extension also provides command to populate rows with 0 values for the lat/lng fields. It reads the configuration from TCA and iterates through each configured table, searching with lat = 0 OR lng = 0. For each matching row, the geocoding process is executed and the values are then updated in the database. The command produces some log output to track what has been done. As it is a default Symfony console command, this can also be called by a scheduler task. ``` vendor/bin/typo3 geocoder:fillmissingdata ``` TODOs ----- [](#todos) - publish in TER - right now providerParams\[0\] is always filled with the httpClient, which may not work for all providers ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community11 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 92.9% 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 Every ~85 days Recently: every ~170 days Total 9 Last Release 2290d ago Major Versions v0.3.0 → v1.0.02020-02-06 ### 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 (26 commits)")[![develth](https://avatars.githubusercontent.com/u/3374563?v=4)](https://github.com/develth "develth (2 commits)") --- Tags composer-packagegeocodertcatypo3typo3-cms-extensiontypo3-extension ### Embed Badge ![Health badge](/badges/ujamii-ujamii-geocoder/health.svg) ``` [![Health](https://phpackages.com/badges/ujamii-ujamii-geocoder/health.svg)](https://phpackages.com/packages/ujamii-ujamii-geocoder) ``` ### Alternatives [b13/assetcollector Add CSS and SVG files and strings as inline style tag/inline svg to the html code. 10118.4k](/packages/b13-assetcollector)[mfd/ai-filemetadata Automatically generates FAL metadata for files by means of public LLMs 1142.1k](/packages/mfd-ai-filemetadata)[mautic/mautic-typo3 Add-on TYPO3 extension that enhances the "EXT:marketing\_automation" TYPO3 extension by connecting it to the Mautic Marketing Automation platform: Determine "Persona" from Mautic segments. Also provides additional services e.g. language synchronisation between Mautic and TYPO3. 236.3k](/packages/mautic-mautic-typo3)[numero2/contao-storelocator Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data 121.5k](/packages/numero2-contao-storelocator) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)