Title: Address Lookup field for ACF Author: Justin Kruit Published: 10 de mayo de 2026 Last modified: 17 de mayo de 2026 --- Buscar plugins ![](https://ps.w.org/jk-address-lookup-for-acf/assets/banner-772x250.png?rev=3534499) ![](https://ps.w.org/jk-address-lookup-for-acf/assets/icon.svg?rev=3534499) # Address Lookup field for ACF Por [Justin Kruit](https://profiles.wordpress.org/justinkruit/) [Descargar](https://downloads.wordpress.org/plugin/jk-address-lookup-for-acf.1.1.0.zip) * [Detalles](https://es-ar.wordpress.org/plugins/jk-address-lookup-for-acf/#description) * [Valoraciones](https://es-ar.wordpress.org/plugins/jk-address-lookup-for-acf/#reviews) * [Instalación](https://es-ar.wordpress.org/plugins/jk-address-lookup-for-acf/#installation) * [Desarrollo](https://es-ar.wordpress.org/plugins/jk-address-lookup-for-acf/#developers) [Soporte](https://wordpress.org/support/plugin/jk-address-lookup-for-acf/) ## Descripción Address Lookup field for ACF adds an address lookup field type to Advanced Custom Fields. Users can search for addresses directly within the editor, and the field returns structured address data including coordinates. The plugin uses [Nominatim (OpenStreetMap)](https://nominatim.openstreetmap.org/) as the default lookup provider, and supports registering custom providers. The plugin also includes support for the [Photon](https://photon.komoot.io/) geocoding provider out of the box. You can choose between Nominatim and Photon, or register your own providers. #### Features * **Live address search** — AJAX-powered search as you type, using Select2. * **Structured data** — Returns a normalized array with display name, coordinates( lat/lon), house number, road, city, state, postcode, and country. * **Country code filtering** — Limit search results to specific countries. * **Language support** — Set the preferred language for results. * **Extensible provider system** — Register your own address lookup providers via the `address_lookup_for_acf/register_providers` action. * **REST API support** — Field values are exposed in the REST API. * **Photon provider** — Use the Photon geocoding service as an alternative to Nominatim. #### Usage 1. Install and activate the plugin. 2. Create or edit an ACF field group. 3. Add a new field and select the **Address** field type. 4. Optionally configure country code filtering and language. 5. Use `get_field()` or `the_field()` in your templates — the value is returned as an associative array. #### Template example ``` $address = get_field('my_address_field'); ``` The returned array has the following structure: ``` [ 'display_name' => 'Example Street 1, City, Country', 'coordinates' => ['lat' => '52.370216', 'lon' => '4.895168'], 'house_number' => '1', 'street' => 'Example Street', 'city' => 'City', 'state' => 'State', 'postcode' => '1234 AB', 'country' => 'Country', ] ``` #### Custom providers You can register a custom address lookup provider by hooking into the `jk_address_lookup_for_acf/ register_providers` action: ``` add_action('jk_address_lookup_for_acf/register_providers', function ($registry) { $registry->register(new MyCustomProvider()); }); ``` Your provider must extend `justinkruit\AddressLookupForAcf\Providers\AbstractProvider` and implement the `name()`, `label()`, and `search()` methods. #### Filters * `jk_address_lookup_for_acf/nominatim_url` — Override the Nominatim API base URL( e.g. to use a self-hosted instance). * `jk_address_lookup_for_acf/nominatim_url_vars` — Modify the query parameters sent to the Nominatim API. * `jk_address_lookup_for_acf/photon_url` — Override the Photon API base URL (e. g. to use a self-hosted instance). * `jk_address_lookup_for_acf/photon_url_vars` — Modify the query parameters sent to the Photon API. Both filters also support ACF’s field-specific variations by type, name, and key. ### External services This plugin connects to third-party external services to perform address lookups. No data is sent automatically; requests are only made when an admin user actively searches for an address in the ACF field editor. The search query text is sent to the configured provider’s API. Below is a list of each provider, what additional data is sent, how to override the API URL, and links to their terms and privacy policies. #### Nominatim (OpenStreetMap) Service: [Nominatim](https://nominatim.openstreetmap.org/) by the OpenStreetMap Foundation: used for geocoding address searches. Additional data sent: configured country code(s) and language preference (if set in the field settings). Override URL: use the `jk_address_lookup_for_acf/nominatim_url` filter to point to a self-hosted instance. Policies: * [Nominatim Usage Policy](https://operations.osmfoundation.org/policies/nominatim/) * [OpenStreetMap Foundation Terms of Use](https://osmfoundation.org/wiki/Terms_of_Use) * [OpenStreetMap Foundation Privacy Policy](https://osmfoundation.org/wiki/Privacy_Policy) #### Photon Service: [Photon](https://photon.komoot.io/) by Komoot: used for geocoding address searches, powered by OpenStreetMap data. Additional data sent: configured country code(s) and language preference (if set in the field settings). Override URL: use the `jk_address_lookup_for_acf/photon_url` filter to point to a self-hosted instance. Policies: * [Photon Terms of Service](https://photon.komoot.io/) * [Komoot Privacy Policy](https://www.komoot.com/privacy) ## Instalación 1. Upload the `address-lookup-for-acf` folder to the `/wp-content/plugins/` directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. 3. Ensure Advanced Custom Fields (free or PRO) is installed and active. ## Preguntas frecuentes ### Does this plugin require ACF PRO? No. It works with both the free and PRO versions of Advanced Custom Fields. ### Can I use a self-hosted Nominatim instance? Yes. Use the `jk_address_lookup_for_acf/nominatim_url` filter to point to your own instance: ``` add_filter('jk_address_lookup_for_acf/nominatim_url', function () { return 'https://nominatim.example.com/search'; }); ``` ### What PHP version is required? PHP 7.2 or higher is required. ## Reseñas No hay reseñas para este plugin. ## Colaboradores y desarrolladores “Address Lookup field for ACF” es un software de código abierto. Las siguientes personas han colaborado con este plugin. Colaboradores * [ Justin Kruit ](https://profiles.wordpress.org/justinkruit/) “Address Lookup field for ACF” ha sido traducido a 1 idioma. Gracias a [los traductores](https://translate.wordpress.org/projects/wp-plugins/jk-address-lookup-for-acf/contributors) por sus contribuciones. [Traduce “Address Lookup field for ACF” a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/jk-address-lookup-for-acf) ### ¿Interesado en el desarrollo? [Revisa el código](https://plugins.trac.wordpress.org/browser/jk-address-lookup-for-acf/), echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/jk-address-lookup-for-acf/), o suscríbete al [log de desarrollo](https://plugins.trac.wordpress.org/log/jk-address-lookup-for-acf/) por [RSS](https://plugins.trac.wordpress.org/log/jk-address-lookup-for-acf/?limit=100&mode=stop_on_copy&format=rss). ## Registro de cambios #### 1.1.0 * Added support for the Photon geocoding provider. #### 1.0.0 * Initial release. * Nominatim (OpenStreetMap) provider. * Country code filtering and language settings. * Extensible provider architecture. ## Meta * Versión **1.1.0** * Última actualización **hace 5 meses** * Instalaciones activas **10+** * Versión de WordPress ** 6.0 o superior ** * Testeado hasta **7.0.6** * Versión de PHP ** 7.2 o superior ** * Idiomas * [Dutch](https://nl.wordpress.org/plugins/jk-address-lookup-for-acf/) y [English (US)](https://wordpress.org/plugins/jk-address-lookup-for-acf/). * [Traducir a tu idioma](https://translate.wordpress.org/projects/wp-plugins/jk-address-lookup-for-acf) * Etiquetas: * [acf](https://es-ar.wordpress.org/plugins/tags/acf/)[address](https://es-ar.wordpress.org/plugins/tags/address/) [advanced custom fields](https://es-ar.wordpress.org/plugins/tags/advanced-custom-fields/) [geocoding](https://es-ar.wordpress.org/plugins/tags/geocoding/)[nominatim](https://es-ar.wordpress.org/plugins/tags/nominatim/) * [Vista avanzada](https://es-ar.wordpress.org/plugins/jk-address-lookup-for-acf/advanced/) ## Valoraciones Todavía no se enviaron reseñas. [Your review](https://wordpress.org/support/plugin/jk-address-lookup-for-acf/reviews/#new-post) [Ver todas las reseñas](https://wordpress.org/support/plugin/jk-address-lookup-for-acf/reviews/) ## Colaboradores * [ Justin Kruit ](https://profiles.wordpress.org/justinkruit/) ## Soporte ¿Tenés algo que decir? ¿Necesitás ayuda? [Ver el foro de asistencia](https://wordpress.org/support/plugin/jk-address-lookup-for-acf/)