superinteractive/statamic-super-location

Super Location is a Statamic fieldtype powered by OpenStreetMap search and map tiles.

v2.0.0 2026-06-13 21:52 UTC

Requires

• php: ^8.3
• illuminate/support: ^12.0 || ^13.0
• statamic/cms: ^6.0

Requires (Dev)

• laravel/pint: ^1.24
• orchestra/testbench: ^10.8 || ^11.0
• pestphp/pest: ^3.8 || ^4.0
• pestphp/pest-plugin-laravel: ^3.0 || ^4.0
• phpunit/phpunit: ^11.5 || ^12.5 || ^13.0

MIT

• Super Interactive

• map
• OpenStreetMap
• fieldtype
• statamic
• Statamic addon

README

Super Location is a Statamic 6 addon that provides a "Super Location" fieldtype backed by OpenStreetMap search. It includes an autocomplete search bar, configurable defaults, a Leaflet map, and scoped Control Panel styles for light and dark mode.

Compatibility

• 2.x: Statamic 6, Laravel 12 or 13, PHP 8.3+
• 1.x: Statamic 5

Features

• Autocomplete search powered by the public OpenStreetMap Nominatim API.
• Interactive Leaflet map with a single draggable marker.
• Automatically fills street, postal code, city, country, state, latitude, and longitude.
• Renders in Statamic 6 Control Panel light and dark mode.
• Returns a structured array that you can use directly in Antlers, Blade, or PHP.

Installation

Install the addon with Composer:

composer require superinteractive/statamic-super-location:^2.0

Publish the config when you need to adjust map defaults, tile providers, or search settings:

php artisan vendor:publish --tag="statamic-super-location-config"

Configuration

The publishable config file lives at config/statamic/super-location.php. You can customize the default map center, zoom level, tile provider, and search endpoint.

Building Assets

The Control Panel assets are powered by Vite and Statamic's @statamic/cms package. During development, run:

npm install
npm run dev

For distribution, build the assets so the compiled files end up in resources/dist/build:

npm run build

Documentation

See docs/usage.md for implementation notes and templating tips.