A map field that behaves like a Nova field.

01  /  The smallest real thing

Two arguments. That is the whole field.

No type(), no handing the data in yourself. Name the field, name the column, and the resolver chain works out what it found.

use Gabrielesbaiz\NovaFieldMap\FieldMap;

public function fields(NovaRequest $request): array
{
    return [
        FieldMap::make('Location', 'coordinates'),
    ];
}

The coordinates column can hold any of these. Nothing tells the field which:

02  /  Editable

Two more calls and an administrator places the pin.

2.x forced showOnUpdate to false and shipped a text input that did nothing. 3.0 gives you a real form field: click to place, drag to adjust, search for a place, or type the numbers.

FieldMap::make('Location', 'coordinates')
    ->editable()
    ->geocoder()
    ->height('400px')

03  /  A whole relation

One marker per related record, clustered, clickable.

Each related record's attributes travel with its feature, so popups and per-marker styling address them by column name. linkToResource() makes a marker click open that record's detail page through Inertia.

public static $with = ['branches'];

FieldMap::make('Branches', 'coordinates')
    ->relation('branches')
    ->popup('name')
    ->linkToResource()
    ->cluster(disableAtZoom: 12)

// popup('name') is escaped. Markup needs
// an explicit ->allowHtmlPopups().

04  /  Decide by driving it

Every method, every option, live.

The playground has a control for all 58 public methods. Change one and three things move at once: the chain you would paste into a resource, the field Nova would draw, and the payload the browser actually receives — generated by the same rules as mapMeta(), so the derived values behave exactly as they do in your app.

05  /  What changed in 3.0

A rewrite, driven by three things that were wrong.

06  /  When not to use this

If two number fields will do, use two number fields.

Showing a latitude and a longitude is not a reason to load a mapping library. Two Number fields are less JavaScript, less to go wrong, and an administrator who knows the coordinates can simply type them.

Number::make('Latitude')->step(0.000001),
Number::make('Longitude')->step(0.000001),

FieldMap::make('Location', 'coordinates')
    ->editable()
    ->geocoder(),