PHPackages                             el-schneider/statamic-simple-address - 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. el-schneider/statamic-simple-address

ActiveStatamic-addon[Utility & Helpers](/categories/utility)

el-schneider/statamic-simple-address
====================================

A simple address automcomplete for Statamic

v2.1.2(4w ago)1550↓72.6%1MITPHPPHP ^8.3CI passing

Since Jun 3Pushed 4w ago1 watchersCompare

[ Source](https://github.com/el-schneider/statamic-simple-address)[ Packagist](https://packagist.org/packages/el-schneider/statamic-simple-address)[ Fund](https://www.buymeacoffee.com/el.schneider)[ RSS](/packages/el-schneider-statamic-simple-address/feed)WikiDiscussions main Synced today

READMEChangelog (9)Dependencies (24)Versions (29)Used By (0)

[![Auto Alt Text](images/saf_banner.png)](images/saf_banner.png)

> **Disclaimer**: Statamic Simple Address recently underwent a complete rewrite and is now under active development, so features and APIs may change.

Statamic Simple Address
=======================

[](#statamic-simple-address)

A simple address autocomplete fieldtype for Statamic. Works out of the box with no API keys needed.

**Simple by default – flexible when needed.**

Features
--------

[](#features)

- **Zero-config setup** – Uses Nominatim (OpenStreetMap) by default
- **Backend routing** – Requests go through your backend and are deduped
- **Interactive map** – Draggable marker with reverse geocoding
- **YAML preview** – View and verify stored data
- **Any geocoder-php provider** – Works with 30+ providers from [geocoder-php](https://geocoder-php.org/). Pre-configured examples for Nominatim, Google Maps, and Mapbox

Quick Start
-----------

[](#quick-start)

Add a Simple Address field to your blueprint.

The field stores a normalized address structure:

```
label: London, England, United Kingdom
lat: 51.5072178
lon: -0.1275862
providedBy: google_maps
bounds:
  south: 51.38494009999999
  west: -0.3514683
  north: 51.6723432
  east: 0.148271
locality: London
adminLevels:
  1:
    name: England
    code: England
    level: 1
  2:
    name: Greater London
    code: Greater London
    level: 2
country: United Kingdom
countryCode: GB
```

> **Note:** The default Nominatim setup is ideal for local development. The public Nominatim server has a strict 1 req/sec limit and forbids autocomplete on the client side. For production, most users switch to Geoapify, Google, or Mapbox – all offer free tiers, but usage limits and terms vary.

Configuration
-------------

[](#configuration)

```
composer require el-schneider/statamic-simple-address
```

### Control Panel Assets (Statamic v6)

[](#control-panel-assets-statamic-v6)

If you install/update the addon via Composer, publish the Control Panel assets so Statamic can load the Vite manifest:

```
php artisan vendor:publish --tag=statamic-simple-address --force
```

If you install via Statamic's addon installer, this is typically done automatically.

Works immediately with Nominatim as the default provider.

### Using a Different Provider

[](#using-a-different-provider)

To switch from Nominatim to another provider:

1. Install the provider package
2. Publish the config and add/uncomment the provider entry
3. Set the required environment variables

```
php artisan vendor:publish --tag=simple-address-config
```

#### Google Maps

[](#google-maps)

```
composer require geocoder-php/google-maps-provider
```

```
SIMPLE_ADDRESS_PROVIDER=google
GOOGLE_GEOCODE_API_KEY=your-api-key
```

#### Mapbox

[](#mapbox)

```
composer require geocoder-php/mapbox-provider
```

```
SIMPLE_ADDRESS_PROVIDER=mapbox
MAPBOX_API_KEY=your-token
```

The published config includes commented examples for Google and Mapbox. For other providers, add an entry to `config/simple-address.php`:

```
'my_provider' => [
    'class' => \Geocoder\Provider\MyProvider\MyProvider::class,
    'args' => [env('MY_PROVIDER_API_KEY')],
],
```

See [Geocoder PHP docs](https://geocoder-php.org/docs/#providers) for available providers and their constructor arguments. Thanks to [geocoder-php](https://github.com/geocoder-php/Geocoder) for making multi-provider geocoding easy.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance94

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 94.4% 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 ~78 days

Recently: every ~10 days

Total

15

Last Release

28d ago

Major Versions

v0.2.2 → v2.0.02026-02-01

v0.2.3 → v2.1.12026-04-28

PHP version history (3 changes)v0.0.1-alphaPHP ^8.0

v0.1.0PHP ^8.2

v0.2.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/81a231c7730414820ac67caf7b30bea0de0d6af3775ec941a07ee5dc697f442a?d=identicon)[mail@jonaslist.de](/maintainers/mail@jonaslist.de)

---

Top Contributors

[![el-schneider](https://avatars.githubusercontent.com/u/26460248?v=4)](https://github.com/el-schneider "el-schneider (135 commits)")[![ito-ito-ito-ito](https://avatars.githubusercontent.com/u/260886217?v=4)](https://github.com/ito-ito-ito-ito "ito-ito-ito-ito (6 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (2 commits)")

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/el-schneider-statamic-simple-address/health.svg)

```
[![Health](https://phpackages.com/badges/el-schneider-statamic-simple-address/health.svg)](https://phpackages.com/packages/el-schneider-statamic-simple-address)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[statamic/seo-pro

68516.6k](/packages/statamic-seo-pro)[oat-sa/tao-core

TAO core extension

66143.7k124](/packages/oat-sa-tao-core)

PHPackages © 2026

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