[Free Extension] Photon Address Autocomplete – OpenStreetMap-based address autofill

[gim]

Hi all,

I'd like to share a free, open-source extension that adds address autocomplete to EspoCRM address fields, powered by the Photon geocoder (OpenStreetMap data).

Type in the street field, pick a suggestion – street, postal code, city, state and country are filled in together.

**Features**

- Server-side proxy route (no CORS, authenticated via the regular Espo session, cached)
- Country selection via the standard Address Countries admin list ("Is Preferred" flag), with an optional override on the extension's settings page
- Already filled city/postal code/country guide the search via Photon's location bias – nearby matches rank first, everything else stays findable (zoom and weight configurable)
- Works on Account, Contact, Lead and RealEstateProperty; any other address field can be enabled with one metadata entry
- No Composer/NPM dependencies; works with the public photon.komoot.io or your self-hosted Photon instance

**Requirements:** EspoCRM 10.x, PHP 8.3+

**Download & docs:** https://github.com/gises/espocrm-address-autocomplete
(installable ZIP under Releases; AGPL-3.0, same license as EspoCRM)

Feedback and contributions welcome!

[crmscot]

This looks like a very useful extension and many thanks for your hard work.

I've tested it with a fresh install of EspoCRM V10.0.3 for UK addresses (Country set to GB) and noticed the following errors:-

1) UK street addresses take the format "housenumber street" but the lookup puts the result in EspoCRM as "street housenumber".

I had a quick look at the extension code and seem able to fix this by changing line 87 in ResultMapper.php to "return $houseNumber !== null ? "{$houseNumber} {$street}" : $street;"
Not sure if this is the correct way to fix this but it does produce the correct result.

2) The returned address has incorrect data for State (or County as it is known in the UK). For example, searching for "29/2 Hardengreen Industrial Estate" finds the correct address but the State (County) field is "Scotland". It should be "Midlothian"

I've not been able to correct this but don't think it's a limitation in the Photon database. I've tried a search in demo mode (using Google AI) and it returns the correct address with State (County) showing as "Midlothian".

Perhaps you can investigate these 2 issues and provide a solution.