README

A Nova field to place a marker on map to get coordinates then it reverse geocoding the coordinates to get a street address. Address field can have autocomplete feature and coordinates can be entered manually in Lat & Lng feilds.

Installation

You can install the package in to a Laravel app that uses Nova via composer:

composer require i-saad-salman/nova-map-address

Configuration

Publish the package config file:

php artisan vendor:publish --provider="ISaadSalman\MapAddress\FieldServiceProvider"

This is the contents of the file which will be published at config/map-address.php.

Add the following keys to your .env and .env.example:

MAP_ADDRESS_API_KEY=

Optional: Set map and address language
MAP_ADDRESS_LANGUAGE=es

If you need a Google Maps API key, you can create an app and enable Places API and create credentials to get your API key https://console.developers.google.com. Make sure to enable Places API

To save lat & lng packages expects 2 feilds which you can configure. In addition to this it expects and address field

Usage:

Add the below to Nova/{Model}.php resource:

use iSaadSalman\MapAddress\MapAddress;

[
    MapAddress::make('address'),

    // You can set the initial map location. By default (Spain)
     MapAddress::make('address')
        ->initLocation(38.261842, -0.6868031),
        
    // You can set the location from the model
    MapAddress::make('address')
        ->setLocation($this->latitude, $this->longitude),
        
    // You can select the name of lat/lng fields. By default is lat/lng
    MapAddress::make('address')
        ->setLatitudeField('latitude')
        ->setLongitudeField('longitude'),
    
    // You can select what is the first result set in address field
    MapAddress::make('address')
        ->setGoogleResultType('street_address'),
    
    // Enable Drag for the markers
     MapAddress::make('address')
        ->initLocation(38.261842, -0.6868031)
        ->enableDrag(true),

    // Enable auto complete for address field
     MapAddress::make('address')
        ->initLocation(38.261842, -0.6868031)
        ->enableAutocomplete(true),

    // You can also set the map zoom level. By default (4)
     MapAddress::make('address')
        ->initLocation(38.261842, -0.6868031)
        ->zoom(12),
]

Support:

Saad: https://www.buymeacoffee.com/saadsalman

License

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

i-saad-salman / nova-map-address

Maintainers

Details