README

Add openstreetmap field to filament form

Full free map API

Interface

How it view in database

Installation

You can install the package via composer:

composer require traineratwot/filament-openstreetmap

Then publish the Leaflet assets:

php artisan vendor:publish --tag=filament-openstreetmap-assets

This copies Leaflet JS/CSS to public/vendor/filament-openstreetmap/leaflet/.

Usage

Make model with migration

return new class extends Migration {
    public function up(): void
    {
        Schema::create('points', function (Blueprint $table) {
            $table->id();
            $table->string('point')->nullable();
            $table->json('point_array')->nullable();
            $table->timestamps();
            $table->softDeletes();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('points');
    }
};

namespace App\Models;

use MatanYadaev\EloquentSpatial\Objects\Point;
use Illuminate\Database\Eloquent\Model;

class Point extends Model
{
    use SoftDeletes;

    protected $guarded = ['id'];

    protected function casts()
    {
        return [
            'point' => PointCast::class,
            'point_array' => PointCast::class . ':' . PointFormat::ARRAY->value ,
        ];
    }
}

Make filament resource

<?php

namespace App\Filament\Resources;

use Traineratwot\FilamentOpenStreetMap\Forms\Components\MapInput;


class MapPointResource extends Resource
{
    protected static ?string $model = MapPoint::class;

    public static function form(Schema $schema): Schema
    {
        return $schema
            ->components([
                MapInput::make('point')
                    ->columnSpan(2)
                    ->saveFormat(PointFormat::WKT)
                ,
                MapInput::make('point_array')
                    ->saveFormat(PointFormat::ARRAY)
                ,

                TextEntry::make('created_at')
                    ->label('Created Date')
                    ->dateTime(),

                TextEntry::make('updated_at')
                    ->label('Last Modified Date')
                    ->dateTime(),
            ]);
    }
}

Using Point (recommended)

The Point value object is the recommended way to work with coordinates. It handles format conversion, parsing, and distance calculations.

use Traineratwot\FilamentOpenStreetMap\Data\Point;

// Create a point
$point = new Point(55.7558, 37.6173);

// Format to different output formats
$point->format(PointFormat::LAT_LNG);      // "55.7558,37.6173"
$point->format(PointFormat::WKT);          // "POINT(37.6173 55.7558)"
$point->format(PointFormat::GEOJSON);      // {"type":"Point","coordinates":[37.6173,55.7558]}
$point->format(PointFormat::URL_GOOGLE);   // https://www.google.com/maps/search/?api=1&query=...
$point->format(PointFormat::DMS);          // 55°45'20.88"N 37°37'2.28"E

// Parse from any supported format (auto-detection)
$point = Point::fromValue('55.7558,37.6173');
$point = Point::fromValue('POINT(37.6173 55.7558)');
$point = Point::fromValue('{"type":"Point","coordinates":[37.6173,55.7558]}');
$point = Point::fromValue('https://www.openstreetmap.org/?mlat=55.7558&mlon=37.6173');
$point = Point::fromValue(['latitude' => 55.7558, 'longitude' => 37.6173]);
$point = Point::fromValue([37.6173, 55.7558]); // [lng, lat] array

// Distance to another point (meters)
$moscow = new Point(55.7558, 37.6173);
$berlin = new Point(52.5200, 13.4050);
$moscow->distanceTo($berlin); // ~1609960 meters

// Check equality
$point1->equals($point2); // true if within 0.000001 precision

Using Point in MapInput

use Traineratwot\FilamentOpenStreetMap\Data\Point;

MapInput::make('location')
    ->saveFormat(PointFormat::WKT)

Markers

You can add predefined markers to the map. Clicking a marker applies its coordinates to the field value.

use Traineratwot\FilamentOpenStreetMap\Data\Point;

MapInput::make('point')
    ->markers([
        ['title' => 'Office', 'point' => new Point(55.75, 37.61), 'color' => '#ff0000'],
        ['title' => 'Home',   'point' => new Point(55.76, 37.62)],
    ])

Each marker accepts:

title — popup text (optional)
point — Point instance or [lat, lng] array
color — marker dot color (default #3388ff)

Dynamic markers (Closure)

MapInput::make('point')
    ->markers(fn () => auth()->user()->locations->map(fn ($loc) => [
        'title' => $loc->name,
        'point' => [$loc->lat, $loc->lng],
        'color' => $loc->is_active ? '#22c55e' : '#ef4444',
    ])->toArray())

Markers Only mode

Restrict selection to predefined markers only — map clicks are disabled, search filters the marker list.

MapInput::make('point')
    ->markers([
        ['title' => 'Moscow',  'point' => new Point(55.7558, 37.6173)],
        ['title' => 'Berlin',  'point' => new Point(52.5200, 13.4050)],
        ['title' => 'Paris',   'point' => new Point(48.8566,  2.3522)],
    ])
    ->markersOnly()

Dynamic markersOnly (Closure)

MapInput::make('point')
    ->markers(fn () => $this->getAvailablePoints())
    ->markersOnly(fn () => $record?->restrict_selection ?? false)

formats

You can save in database in thar formats

foreach (PointFormat::cases() as $p){
   dump($p->getExample());
}

#   $point = new Point(55.7558, 37.6173);
#    return $point->format(PointFormat::URL_YANDEX);

"55.7558,37.6173" // app/Console/Commands/DevTestCommand.php:17
"37.6173,55.7558" // app/Console/Commands/DevTestCommand.php:17
"POINT(37.6173 55.7558)" // app/Console/Commands/DevTestCommand.php:17
"{"type":"Point","coordinates":[37.6173,55.7558]}" // app/Console/Commands/DevTestCommand.php:17
"55°45'20.88"N 37°37'2.28"E" // app/Console/Commands/DevTestCommand.php:17
"55.755800, 37.617300" // app/Console/Commands/DevTestCommand.php:17
"https://www.google.com/maps/search/?api=1&query=55.7558,37.6173" // app/Console/Commands/DevTestCommand.php:17
"https://www.openstreetmap.org/?mlat=55.7558&mlon=37.6173#map=15/55.7558/37.6173" // app/Console/Commands/DevTestCommand.php:17
"https://yandex.ru/maps/?pt=37.6173,55.7558&z=15&l=map" // app/Console/Commands/DevTestCommand.php:17
"{"latitude":55.7558,"longitude":37.6173}" // app/Console/Commands/DevTestCommand.php:17
"[37.6173,55.7558]" // app/Console/Commands/DevTestCommand.php:17

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.

Used packages

composer: matanyadaev/laravel-eloquent-spatial
js: Leaflet.js (vendored)

traineratwot / filament-openstreetmap

Maintainers

Package info

Statistics

Security