PHPackages                             deondazy/realaddressfactory - 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. deondazy/realaddressfactory

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

deondazy/realaddressfactory
===========================

Fork of nonsapiens/realaddressfactory with Laravel 12 support. Creates real-world street addresses from Google Maps.

v2.1.0(1y ago)10MITPHPPHP ^8.3

Since Feb 25Pushed 1y agoCompare

[ Source](https://github.com/deondazy/realaddressfactory)[ Packagist](https://packagist.org/packages/deondazy/realaddressfactory)[ Docs](https://github.com/deondazy/realaddressfactory)[ RSS](/packages/deondazy-realaddressfactory/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (4)Used By (0)

RealAddress Generator (Laravel 12 Fork)
=======================================

[](#realaddress-generator-laravel-12-fork)

About
-----

[](#about)

**Fork Notice**: This is a community-maintained fork of [nonsapiens/realaddressfactory](https://github.com/nonsapiens/realaddressfactory) with Laravel 12 support.

This library creates actual, 100% real addresses with full address details and lat/long coordinates using the Google Maps API. Features include:

- Laravel 12 compatibility
- Faker integration for database seeding
- Address generation via Facade or direct class usage

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

[](#installation)

Require this package with composer:

```
composer require deondazy/realaddressfactory --dev
```

### Google Maps API Requirements

[](#google-maps-api-requirements)

Add your API key to `.env`:

```
GOOGLE_MAPS_API_KEY=your_api_key_here
```

[Get a Google Maps API key](https://developers.google.com/maps/documentation/javascript/get-api-key)

Usage
-----

[](#usage)

### Faker Integration

[](#faker-integration)

```
class UserFactory extends Factory
{
    protected $model = User::class;

    public function definition(): array
    {
        /** @var GoogleAddress $address */
        $address = $this->faker->britishAddress();

        return [
            'first_name' => $this->faker->firstName(),
            'full_address' => $address->getFormattedAddress(),
            'latitude' => $address->getCoordinates()->getLatitude(),
            'longitude' => $address->getCoordinates()->getLongitude()
        ];
    }
}
```

### Facade Usage

[](#facade-usage)

```
use Nonsapiens\RealAddressFactory\RealAddressFactory;

// Generate 20 Johannesburg addresses
$saAddresses = RealAddressFactory::makeSouthAfrica(20, 'Johannesburg');
```

### Adding New Countries

[](#adding-new-countries)

Update `config/realaddress.php`:

```
'brazil' => [
    'cities' => ['Rio de Janeiro', 'São Paulo']
],
```

Then use:

```
$faker->realAddress('Brazil', 'Rio de Janeiro');
```

Fork Differences from Original
------------------------------

[](#fork-differences-from-original)

- ✅ Laravel 12 support
- ✅ Updated dependencies (Testbench 10.x, Geocoder 5.x)
- 🔄 Maintains original functionality
- ⚠️ Namespaces remain unchanged for compatibility

Warning
-------

[](#warning)

- Google may block excessive API requests
- API usage may incur Google Cloud charges
- Built-in rate limiter configurable in `config/realaddress.php`

Maintenance
-----------

[](#maintenance)

**Current Maintainer**
[Deon Okonkwo](mailto:deondazy@gmail.com)

**Original Author**
[Stuart Steedman](https://github.com/nonsapiens) - CTO of [Sebenza](http://sebenza.tech)

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

[](#contributing)

Pull requests welcome! Please open issues for:

- Laravel compatibility updates
- New country/city additions
- Documentation improvements

[View Fork Source](https://github.com/johndoe/realaddressfactory)

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance44

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity55

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

Total

3

Last Release

445d ago

Major Versions

v1.0.0 → v2.0.02025-02-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/1f1c1a5b25865f0e67ca1a7d172fed5e6a7b1adb9339674341a8f1b0dbcee652?d=identicon)[deondazy](/maintainers/deondazy)

---

Top Contributors

[![stuartsteedman](https://avatars.githubusercontent.com/u/69784087?v=4)](https://github.com/stuartsteedman "stuartsteedman (6 commits)")[![Jonathan-Maurer](https://avatars.githubusercontent.com/u/78354815?v=4)](https://github.com/Jonathan-Maurer "Jonathan-Maurer (5 commits)")[![stuartsebenza](https://avatars.githubusercontent.com/u/111981335?v=4)](https://github.com/stuartsebenza "stuartsebenza (5 commits)")[![deondazy](https://avatars.githubusercontent.com/u/16439886?v=4)](https://github.com/deondazy "deondazy (4 commits)")[![nonsapiens](https://avatars.githubusercontent.com/u/9744534?v=4)](https://github.com/nonsapiens "nonsapiens (1 commits)")

---

Tags

addresslaravel 12AddressFactoryRealAddressFactory

### Embed Badge

![Health badge](/badges/deondazy-realaddressfactory/health.svg)

```
[![Health](https://phpackages.com/badges/deondazy-realaddressfactory/health.svg)](https://phpackages.com/packages/deondazy-realaddressfactory)
```

###  Alternatives

[nonsapiens/realaddressfactory

Creates real-world street addresses from Google Maps, to use in database seeding, unit tests, or anything else. Supports Laravel 11+, and Faker

4910.2k7](/packages/nonsapiens-realaddressfactory)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

116.6k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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