Weave Code
Filament Maps Laravel Package
agelgil/filament-maps
Filament Maps adds interactive map fields to Filament forms, letting admins pick and save coordinates directly in your panel. Easy to install and configure, it brings location selection into your existing forms without extra JavaScript work.
Filament Maps is a plugin for Filament that adds interactive map fields to your admin panels. Drop a map into any form to let users pick coordinates, search for addresses, or fine-tune a location—backed by a simple, configurable API that fits naturally into Filament's form builder.
- Map picker field with draggable marker and live latitude/longitude
- Address search for quickly locating places by name
- Configurable tile layers, zoom level, and default center
- Seamless integration with Filament panels and forms
- Lightweight, framework-native setup with minimal configuration
Frequently asked questions about Filament Maps
- What is agelgil/filament-maps used for?
- It is a Filament plugin that adds interactive map fields and columns to Laravel admin panels. You can use it in forms to let users pick coordinates or search addresses, and in tables to preview locations. It is aimed at Filament resources where location data needs to be entered or displayed visually.
- How do I install agelgil/filament-maps in a Laravel app?
- Install it with Composer using composer require agelgil/filament-maps, then follow the package README for Filament panel registration and any asset publishing steps. Because Filament plugins can require version-specific setup, check the README and release notes for your Filament version. After installation, add the field or column classes to your Filament forms and tables.
- Which Laravel and Filament versions does agelgil/filament-maps support?
- The package is a Filament plugin, so its supported Laravel and Filament versions are defined by its Composer constraints. Check the package composer.json and README before installing, especially if you are on Filament 3 or Filament 4. Release notes are the best place to confirm compatibility changes.
- How do I add a map field to a Filament form?
- Add the package's map field class to your Filament form schema, typically inside a resource form or custom form. Configure the initial center, zoom, and stored coordinate columns as needed. Users can then pick a point on the map and, where enabled, search for an address.
- Can users search for an address instead of entering coordinates manually?
- Yes, the plugin is described as supporting address search in the map field so users do not have to type latitude and longitude by hand. The search experience depends on the map or geocoding configuration you provide. You should review the README for required API keys or provider settings.
- How do I display a map location in a Filament table?
- Use the package's map column in your Filament table definition and point it at the stored latitude and longitude fields. The column lets admins preview the location without opening a separate page. Configure zoom and map options to match your resource.
- Does agelgil/filament-maps require a Google Maps API key?
- The provided overview does not specify a single map provider, so check the README for whether API keys are required. Address search and interactive tiles typically depend on a map or geocoding service. Treat any keys as secrets and restrict them by domain where possible.
- Is agelgil/filament-maps safe to use in production?
- It can be used in production if it fits your Filament version and you test it in staging first. Review the package maintenance status, issue tracker, and release history before relying on it. Also secure map provider credentials and validate location data on the server side.
- How do I test map fields and columns in Laravel?
- Write Filament form and table tests that set latitude and longitude values and assert they are saved and displayed correctly. If address search calls an external geocoder, fake or mock that service so tests do not depend on network access. Keep validation tests for missing or invalid coordinates.
- What are alternatives to agelgil/filament-maps?
- Alternatives include other Filament map plugins, custom Leaflet or Google Maps form components, and simple latitude and longitude numeric inputs if you do not need a visual picker. Choose based on Filament version support, provider requirements, and whether you need table previews. Review each package's maintenance activity before adopting it.
Weaver
How can I help you explore Laravel packages today?