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 yesterday

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

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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

2069d 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

[stevebauman/location

Retrieve a user's location by their IP Address

1.3k7.6M65](/packages/stevebauman-location)[nativephp/mobile

NativePHP for Mobile

82724.0k43](/packages/nativephp-mobile)[bensampo/laravel-embed

Painless responsive embeds for videos, slideshows and more.

142146.8k](/packages/bensampo-laravel-embed)[glhd/conveyor-belt

14797.0k](/packages/glhd-conveyor-belt)[adrianorosa/laravel-geolocation

Laravel Geo Location package to get details for a given IP Address

6593.3k1](/packages/adrianorosa-laravel-geolocation)[bakame/laravel-domain-parser

Laravel package to integrate PHP Domain parser.

26534.8k4](/packages/bakame-laravel-domain-parser)

PHPackages © 2026

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