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.<\/p>\n\n
The plugin uses Nominatim (OpenStreetMap)<\/a> as the default lookup provider, and supports registering custom providers.<\/p>\n\n The returned array has the following structure:<\/p>\n\n You can register a custom address lookup provider by hooking into the Your provider must extend Both filters also support ACF's field-specific variations by type, name, and key.<\/p>\n\n 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.<\/p>\n\n 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.<\/p>\n\n Service: Nominatim<\/a> by the OpenStreetMap Foundation: used for geocoding address searches.<\/p>\n\n Additional data sent: configured country code(s) and language preference (if set in the field settings).<\/p>\n\n Override URL: use the Policies:<\/p>\n\n No. It works with both the free and PRO versions of Advanced Custom Fields.<\/p><\/dd>\n Yes. Use the PHP 7.2 or higher is required.<\/p><\/dd>\n\n<\/dl>\n\n\nFeatures<\/h4>\n\n
\n
address_lookup_for_acf\/register_providers<\/code> action.<\/li>\nUsage<\/h4>\n\n
\n
get_field()<\/code> or the_field()<\/code> in your templates \u2014 the value is returned as an associative array.<\/li>\n<\/ol>\n\nTemplate example<\/h4>\n\n
$address = get_field('my_address_field');\n<\/code><\/pre>\n\n[\n 'display_name' => 'Example Street 1, City, Country',\n 'coordinates' => ['lat' => '52.370216', 'lon' => '4.895168'],\n 'house_number' => '1',\n 'road' => 'Example Street',\n 'city' => 'City',\n 'state' => 'State',\n 'postcode' => '1234 AB',\n 'country' => 'Country',\n]\n<\/code><\/pre>\n\nCustom providers<\/h4>\n\n
jk_address_lookup_for_acf\/register_providers<\/code> action:<\/p>\n\nadd_action('jk_address_lookup_for_acf\/register_providers', function ($registry) {\n $registry->register(new MyCustomProvider());\n});\n<\/code><\/pre>\n\njustinkruit\\AddressLookupForAcf\\Providers\\AbstractProvider<\/code> and implement the name()<\/code>, label()<\/code>, and search()<\/code> methods.<\/p>\n\nFilters<\/h4>\n\n
\n
jk_address_lookup_for_acf\/nominatim_url<\/code> \u2014 Override the Nominatim API base URL (e.g. to use a self-hosted instance).<\/li>\njk_address_lookup_for_acf\/nominatim_url_vars<\/code> \u2014 Modify the query parameters sent to the Nominatim API.<\/li>\n<\/ul>\n\nExternal services<\/h3>\n\n
Nominatim (OpenStreetMap)<\/h4>\n\n
jk_address_lookup_for_acf\/nominatim_url<\/code> filter to point to a self-hosted instance.<\/p>\n\n\n
\n
address-lookup-for-acf<\/code> folder to the \/wp-content\/plugins\/<\/code> directory.<\/li>\n\n
Does this plugin require ACF PRO?<\/h3><\/dt>\n
Can I use a self-hosted Nominatim instance?<\/h3><\/dt>\n
jk_address_lookup_for_acf\/nominatim_url<\/code> filter to point to your own instance:<\/p>\n\nadd_filter('jk_address_lookup_for_acf\/nominatim_url', function () {\n return 'https:\/\/nominatim.example.com\/search';\n});\n<\/code><\/pre><\/dd>\nWhat PHP version is required?<\/h3><\/dt>\n
1.0.0<\/h4>\n\n
\n