PHPackages cyber-duck/laravel-address-finder - 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. cyber-duck/laravel-address-finder ActiveLibrary[Utility & Helpers](/categories/utility) cyber-duck/laravel-address-finder ================================= :package\_description 3.6(1y ago)210.7k↓39.3%2MITPHPPHP >=7.3 Since Oct 27Pushed 1y ago15 watchersCompare [ Source](https://github.com/Cyber-Duck/laravel-address-finder)[ Packagist](https://packagist.org/packages/cyber-duck/laravel-address-finder)[ Docs](https://github.com/cyber-duck/laravel-address-finder)[ RSS](/packages/cyber-duck-laravel-address-finder/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (7)Dependencies (5)Versions (19)Used By (0) Laravel Address Finder ====================== [](#laravel-address-finder) This package provides a facade for address searching. Currently the only driver is available is [Loqate](https://www.loqate.com). There is also a mock driver for testing that does not communicate with any API's Installation ------------ [](#installation) Via Composer ``` $ composer require cyber-duck/laravel-address-finder ``` Usage ----- [](#usage) ### Environment Variable [](#environment-variable) The following ENV variable are available ``` # Address Finder ## Default: mock. Available [mock, loqate] ADDRESS_FINDER_DRIVER # This can be used to set the driver to use ## Default: false. Available [true, false] ADDRESS_FINDER_CACHE # This can be used to set if the response should be cached or not ## Default: same as CACHE_DRIVER ADDRESS_FINDER_CACHE_DRIVER # If cacheing this setting can be used to override the default cache driver used by address finder # Loquate ## Default: null LOQATE_API_KEY # Required if using the loqate driver ## Default: https://api.addressy.com/ LOQATE_API_BASE_URI # This can be used to overide the API based URI when using the loqate driver ``` ### Searching Address [](#searching-address) ``` // $query: The search string // $countryCode: The country code to search for addresses within // $groupId: Results can have children, if this is the case you can retrieve the results children by passing the ID Address::suggestions($query, $countryCode, $groupId); ``` **Example** ``` CyberDuck\AddressFinder\Facades\Address::suggestions('EC1N', 'GB', null)->get(); /* [ [ "id" => "1", "text" => "London, United Kingdom, EC1N 8TB - 2 Addresses", "has_children" => true, ], ] */ CyberDuck\AddressFinder\Facades\Address::suggestions('EC1N', 'GB', 1)->get(); /* [ [ "id" => "2", "text" => "1 Greville Street - Greville Street London, 1, United Kingdom, EC1N 8TB", "has_children" => false, ], [ "id" => "3", "text" => "2 Greville Street - Greville Street London, 2, United Kingdom, EC1N 8TB", "has_children" => false, ], ] */ ``` ### Retrieving Address Details [](#retrieving-address-details) ``` // $addressId: The id of the address found from the suggestions method Address::details($addressId); ``` **Example** ``` CyberDuck\AddressFinder\Facades\Address::details('2')->get(); /* [ "postal_code" => "EC1N 8TB", "province_code" => "", "state" => "", "city" => "London", "address_line_1" => "Greville Street", "address_line_2" => "1", "address_line_3" => "", ] */ ``` ### Retrieving Postzon record for the given postcode [](#retrieving-postzon-record-for-the-given-postcode) ``` // $postcode: The postcode to use to search with Address::postzon($postcode); ``` **Example** ``` CyberDuck\AddressFinder\Facades\Address::postzon('N7 7PH')->get(); /* [ 'Easting' => 530915, 'Northing' => 186310, 'Latitude' => 51.560487, 'Longitude' => -0.112808, 'OsGrid' => 'TQ 30915 86310', 'CountryCode' => '921', 'NewCountryCode' => 'E92000001', 'CountryName' => 'England', 'CountyCode' => '', 'NewCountyCode' => 'E99999999', 'CountyName' => '(pseudo) England (UA/MD/LB)', 'DistrictCode' => '', 'NewDistrictCode' => 'E09000019', 'DistrictName' => 'Islington', 'WardCode' => '00AUGC', 'NewWardCode' => 'E05013703', 'WardName' => '', 'NhsShaCode' => 'Q36', 'NewNhsShaCode' => '', 'NhsShaName' => 'London', 'NhsPctCode' => '', 'NewNhsPctCode' => 'E16000048', 'NhsPctName' => 'Islington', 'LeaCode' => '', 'LeaName' => '', 'GovernmentOfficeCode' => 'H', 'GovernmentOfficeName' => 'London', 'WestminsterConstituencyCode' => 'C36', 'WestminsterConstituencyName' => 'Islington North', 'WestminsterMP' => 'Jeremy Corbyn', 'WestminsterParty' => 'Labour', 'WestminsterConstituencyCode2010' => 'C36', 'WestminsterConstituencyName2010' => 'Islington North', 'LSOACode' => 'E01002730', 'LSOAName' => 'Islington 007A', 'MSOACode' => 'E02000560', 'MSOAName' => 'Islington 007', 'CCGCode' => '93C', 'CCGName' => 'NHS North Central London CCG', 'CCGAreaCode' => '', 'CCGAreaName' => '', 'CCGRegionCode' => '', 'CCGRegionName' => '', ] */ ``` ### Health Score 37 — LowBetter than 83% of packages Maintenance33 Infrequent updates — may be unmaintained Popularity28 Limited adoption so far Community20 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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 ~96 days Recently: every ~120 days Total 15 Last Release 677d ago Major Versions 2.6 → 3.02023-03-06 ### Community Maintainers ![](https://www.gravatar.com/avatar/0c45a99726cc30692bc4821cfc198df1f5de85b1a15f9b66a0bf739acbac0309?d=identicon)[cyber-duck](/maintainers/cyber-duck) --- Top Contributors [![cyberduckneil](https://avatars.githubusercontent.com/u/90324469?v=4)](https://github.com/cyberduckneil "cyberduckneil (11 commits)")[![jaseofspades88](https://avatars.githubusercontent.com/u/39732701?v=4)](https://github.com/jaseofspades88 "jaseofspades88 (4 commits)")[![tiagomctavares](https://avatars.githubusercontent.com/u/25774189?v=4)](https://github.com/tiagomctavares "tiagomctavares (3 commits)")[![nadge](https://avatars.githubusercontent.com/u/3862793?v=4)](https://github.com/nadge "nadge (3 commits)")[![worzy](https://avatars.githubusercontent.com/u/1092417?v=4)](https://github.com/worzy "worzy (2 commits)")[![Luke-Shepp](https://avatars.githubusercontent.com/u/35956374?v=4)](https://github.com/Luke-Shepp "Luke-Shepp (2 commits)")[![MacedoRAC](https://avatars.githubusercontent.com/u/6772123?v=4)](https://github.com/MacedoRAC "MacedoRAC (1 commits)")[![bigmythicalduck](https://avatars.githubusercontent.com/u/112638520?v=4)](https://github.com/bigmythicalduck "bigmythicalduck (1 commits)")[![stevewolfe555](https://avatars.githubusercontent.com/u/6985460?v=4)](https://github.com/stevewolfe555 "stevewolfe555 (1 commits)") --- Tags laravellaravel-address-finder ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/cyber-duck-laravel-address-finder/health.svg) ``` [![Health](https://phpackages.com/badges/cyber-duck-laravel-address-finder/health.svg)](https://phpackages.com/packages/cyber-duck-laravel-address-finder) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[interaction-design-foundation/laravel-geoip Support for multiple Geographical Location services. 17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[nedwors/navigator A Laravel package to ease defining navigation menus 433.1k](/packages/nedwors-navigator)[xefi/faker-php-laravel Faker php integration with laravel 1915.1k](/packages/xefi-faker-php-laravel)[dcblogdev/laravel-junie Install pre-configured guides for Jetbrains Junie 392.5k](/packages/dcblogdev-laravel-junie) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)