PHPackages                             lukeraymonddowning/laravel-address-lookup - 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. lukeraymonddowning/laravel-address-lookup

ActiveLibrary[Utility & Helpers](/categories/utility)

lukeraymonddowning/laravel-address-lookup
=========================================

Allows you to use many different services to find an address based on an address query string.

1.1.0(5y ago)12.2kMITPHPPHP ^7.1CI failing

Since Jul 1Pushed 5y ago1 watchersCompare

[ Source](https://github.com/lukeraymonddowning/laravel-address-lookup)[ Packagist](https://packagist.org/packages/lukeraymonddowning/laravel-address-lookup)[ Docs](https://github.com/lukeraymonddowning/laravel-address-lookup)[ RSS](/packages/lukeraymonddowning-laravel-address-lookup/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

Laravel Address Lookup
======================

[](#laravel-address-lookup)

A small package to unify address lookups based on a search query. It currently has support for the Algolia Places API.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require lukeraymonddowning/laravel-address-lookup
```

Usage
-----

[](#usage)

To lookup an address, you should obtain an instance of the `AddressLookup` interface out of the container, either through the `app` helper function or by type hinting.

The default provider is Algolia, but you can change this by setting an `ADDRESS_LOOKUP_DRIVER` in your `.env` file with the desired driver key.

Here is an example of using the package to determine an address.

```
use Lukeraymonddowning\PostcodeLookup\Drivers\AddressLookup;

$addressLookup = app(AddressLookup::class);

$results = $addressLookup->lookup('1 Test Road, Some Street');
```

The `lookup` method will return a `Collection` of addresses, which conform to the `Lukeraymonddowning\PostcodeLookup\Address\AddressInterface`.

If there is an error retrieving results, an `AddressLookupFailed` exception will be thrown.

Algolia
-------

[](#algolia)

The Algolia places API can be used without any credentials, but usage is limited. You can add your own credentials to remove these limits. To do so, add the following keys to your `.env` file:

```
ALGOLIA_PLACES_APPLICATION_ID=XXXX
ALGOLIA_PLACES_APPLICATION_KEY=XXXX
```

You should set the values of these keys to those obtained from the Algolia Places control panel.

### Important information

[](#important-information)

Whilst this package is open source, it is primarily used for internal business purposes and as such there should be no expectation of timely changes based on feature requests.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Luke Downing](https://github.com/lukeraymonddowning)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~72 days

Total

2

Last Release

2122d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/139db346fa173a79481af05b0455e2e8ad7d2ab594c7f53bde3522a3dfeeaf25?d=identicon)[96downlu](/maintainers/96downlu)

---

Top Contributors

[![lukeraymonddowning](https://avatars.githubusercontent.com/u/12202279?v=4)](https://github.com/lukeraymonddowning "lukeraymonddowning (7 commits)")

---

Tags

laravellukeraymonddowningaddress lookup

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/lukeraymonddowning-laravel-address-lookup/health.svg)

```
[![Health](https://phpackages.com/badges/lukeraymonddowning-laravel-address-lookup/health.svg)](https://phpackages.com/packages/lukeraymonddowning-laravel-address-lookup)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[nativephp/mobile

NativePHP for Mobile

1.1k75.1k96](/packages/nativephp-mobile)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[venturedrake/laravel-crm

A free open source CRM built as a package for laravel projects

43411.2k](/packages/venturedrake-laravel-crm)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5022.0k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)