PHPackages                             mattrothenberg/statamic-mapbox-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. mattrothenberg/statamic-mapbox-address

AbandonedArchivedStatamic-addon

mattrothenberg/statamic-mapbox-address
======================================

A Mapbox autocomplete dropdown fieldtype for the Statamic Control Panel

0.9.0(1y ago)910.8k↓46.4%5[2 issues](https://github.com/mattrothenberg/statamic-mapbox-address/issues)MITPHPPHP ^7.3|^8.0

Since Mar 15Pushed 1y ago2 watchersCompare

[ Source](https://github.com/mattrothenberg/statamic-mapbox-address)[ Packagist](https://packagist.org/packages/mattrothenberg/statamic-mapbox-address)[ RSS](/packages/mattrothenberg-statamic-mapbox-address/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (12)Used By (0)

Mattrothenberg\\StatamicMapboxAddress
=====================================

[](#mattrothenbergstatamicmapboxaddress)

An address Autocomplete Field for Statamic V3, powered by [Mapbox](https://docs.mapbox.com/api/search/geocoding/).

[![Cover Image](https://user-images.githubusercontent.com/5148596/111149875-cea35800-8563-11eb-9f3c-b4e4aafaf1ca.png)](https://user-images.githubusercontent.com/5148596/111149875-cea35800-8563-11eb-9f3c-b4e4aafaf1ca.png)

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

[](#installation)

Add the addon to your project via `composer`.

```
composer require mattrothenberg/statamic-mapbox-address
```

Make sure to add the following environment variable, since this library uses [Mapbox](https://docs.mapbox.com/api/search/geocoding/) under the hood for address autocompletion. The addon **will not work** without a valid key.

```
MAPBOX_API_KEY=""

```

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

[](#configuration)

Currently, only a few configuration options are supported, although [Mapbox's forward geocoding API exposes a variety of settings.](https://github.com/mapbox/mapbox-sdk-js/blob/main/docs/services.md#forwardgeocode).

- `placeholder (string>)`: Placeholder text for the rendered picker.
- `countries (Array)`: Limits results to the specified countries. Each item in the array should be an ISO 3166 alpha 2 country code.
- `featureTypes ("country" | "region" | "postcode" | "district" | "place" | "locality" | "neighborhood" | "address" | "poi" | "poi.landmark"):`: Filter results by feature types
- `language (Array)`: Specify the language to use for response text and, for forward geocoding, query result weighting. Options are IETF language tags comprised of a mandatory ISO 639-1 language code and optionally one or more IETF subtags for country or script.

[![Screen Shot 2021-03-15 at 7 45 53 AM](https://user-images.githubusercontent.com/5148596/111150336-5a1ce900-8564-11eb-8142-526809222a96.png)](https://user-images.githubusercontent.com/5148596/111150336-5a1ce900-8564-11eb-8142-526809222a96.png)

Please feel free to submit a pull request if you'd like to add other settings to the configuration screen.

Serialization
-------------

[](#serialization)

When selecting an address from the picker, the entire result will be serialized on your entry. The structure of a result is as follows:

```
address:
  id: address.8556990516457510
  type: Feature
  place_type:
    - address
  relevance: 0.90963
  properties:
    accuracy: rooftop
  text: "Pennsylvania Avenue NW"
  place_name: "1600 Pennsylvania Avenue NW, Washington, District of Columbia 20500, United States"
  matching_place_name: "1600 Pennsylvania Avenue NW, Washington, DC 20500, United States"
  center:
    - -77.036547
    - 38.897675
  geometry:
    type: Point
    coordinates:
      - -77.036547
      - 38.897675
  address: "1600"
  context:
    - id: neighborhood.291451
      text: Downtown
    - id: postcode.8556990516457510
      text: "20500"
    - id: place.12583600763246050
      wikidata: Q61
      text: Washington
    - id: region.14064402149979320
      wikidata: Q3551781
      short_code: US-DC
      text: "District of Columbia"
    - id: country.19678805456372290
      wikidata: Q30
      short_code: us
      text: "United States"
```

Please feel free to submit a pull request if you'd like to modify or improve this very basic serialization schema.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.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 ~116 days

Recently: every ~290 days

Total

11

Last Release

726d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/815ee748d8ea53eac0ca9583c58cd16f72bc25bac0f5b79e533374b61cbc870c?d=identicon)[mattrothenberg](/maintainers/mattrothenberg)

---

Top Contributors

[![mattrothenberg](https://avatars.githubusercontent.com/u/5148596?v=4)](https://github.com/mattrothenberg "mattrothenberg (10 commits)")[![duncanmcclean](https://avatars.githubusercontent.com/u/19637309?v=4)](https://github.com/duncanmcclean "duncanmcclean (1 commits)")[![elcontraption](https://avatars.githubusercontent.com/u/33114?v=4)](https://github.com/elcontraption "elcontraption (1 commits)")[![Lenitr](https://avatars.githubusercontent.com/u/86629081?v=4)](https://github.com/Lenitr "Lenitr (1 commits)")[![martyf](https://avatars.githubusercontent.com/u/1491079?v=4)](https://github.com/martyf "martyf (1 commits)")

### Embed Badge

![Health badge](/badges/mattrothenberg-statamic-mapbox-address/health.svg)

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

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135192.6k5](/packages/statamic-rad-pack-runway)[statamic/seo-pro

65440.7k](/packages/statamic-seo-pro)[statamic/ssg

Generate static sites with Statamic.

254302.4k](/packages/statamic-ssg)[duncanmcclean/simple-commerce

A simple, yet powerful e-commerce addon for Statamic.

16313.2k2](/packages/duncanmcclean-simple-commerce)[statamic/eloquent-driver

Allows you to store Statamic data in a database.

125598.8k7](/packages/statamic-eloquent-driver)

PHPackages © 2026

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