PHPackages                             bestmomo/laravel-address-completion - 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. bestmomo/laravel-address-completion

ActiveLibrary

bestmomo/laravel-address-completion
===================================

Simple Laravel API for address autocomplete

V1.0.2(today)15↑2900%MITPHPPHP ^8.3

Since Aug 28Pushed today1 watchersCompare

[ Source](https://github.com/bestmomo/laravel-address-completion)[ Packagist](https://packagist.org/packages/bestmomo/laravel-address-completion)[ Docs](https://github.com/bestmomo/laravel-address-completion)[ RSS](/packages/bestmomo-laravel-address-completion/feed)WikiDiscussions main Synced today

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

Address Completion
==================

[](#address-completion)

Address Completion provides a simple Laravel API for address autocomplete. It uses the French BAN API for French territories and Geoapify as a fallback for other countries.

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

[](#installation)

This package requires PHP 8.3 or later and Laravel 12 or 13.

You can install the package via Composer:

```
composer require bestmomo/laravel-address-completion
```

You may publish all of the package's resources at once:

```
php artisan vendor:publish --tag="laravel-address-completion"
```

Or, you may publish each resource individually:

### Publishing the Configuration File

[](#publishing-the-configuration-file)

```
php artisan vendor:publish --tag="address-completion-config"
```

The configuration file is created at `config/address-completion.php`.

### Geoapify API key

[](#geoapify-api-key)

Geoapify is used for countries that are not supported by the BAN provider. Add your API key to `.env`:

```
GEOAPIFY_KEY=your-api-key
```

You can get an API key from [Geoapify](https://www.geoapify.com/).

Usage
-----

[](#usage)

Use the `Address` facade to search for addresses:

```
use AddressCompletion\Facades\Address;

$addresses = Address::search('10 rue de Paris');

foreach ($addresses as $address) {
    echo $address->label;
}
```

The country is optional and defaults to `FR`. It accepts an ISO 3166-1 alpha-2 country code:

```
$addresses = Address::search('1600 Pennsylvania Avenue', 'US', limit: 8);
```

Each result is an `AddressCompletion\DTO\Address` object with these properties:

PropertyDescription`label`Formatted address label`street`Street name and house number when available`postcode`Postal code`city`City or localityQueries shorter than five characters return an empty array. Network or provider errors are reported and also return an empty array, so autocomplete can fail gracefully.

### Configuration

[](#configuration)

The published configuration file lets you change the default country, result limit, provider URLs and the countries handled by the BAN provider:

```
// config/address-completion.php
'default_country' => 'FR',
'limit' => 5,
```

The BAN provider is selected automatically for configured French territories. Geoapify handles all other countries and requires `GEOAPIFY_KEY`.

### Cache

[](#cache)

Address search results are cached automatically for 5 minutes to reduce calls to the BAN and Geoapify APIs. The cache uses Laravel's default cache store, so configure it in your application's cache settings when needed.

Cache entries are separated by provider, country, result limit and search query. To clear cached address results, clear the application's cache:

```
php artisan cache:clear
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Thank you for considering contributing to Address Completion! Please review our [contributing guide](.github/CONTRIBUTING.md) to get started.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [bestmomo](https://github.com/bestmomo)
- [All Contributors](../../contributors)

License
-------

[](#license)

Address Completion is open-sourced software licensed under the [MIT license](LICENSE.md).

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance100

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

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 ~0 days

Total

3

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2959682?v=4)[bestmomo](/maintainers/bestmomo)[@bestmomo](https://github.com/bestmomo)

---

Top Contributors

[![bestmomo](https://avatars.githubusercontent.com/u/2959682?v=4)](https://github.com/bestmomo "bestmomo (6 commits)")

---

Tags

laravelbestmomoaddress-completion

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/bestmomo-laravel-address-completion/health.svg)

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

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

1.1k4.6M343](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.4M354](/packages/psalm-plugin-laravel)[api-platform/laravel

API Platform support for Laravel

58190.1k21](/packages/api-platform-laravel)[ublabs/blade-simple-icons

A package to easily make use of Simple Icons in your Laravel Blade views.

1866.3k](/packages/ublabs-blade-simple-icons)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)

PHPackages © 2026

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