New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

davidpiesse/nova-map

Map field for Laravel Nova
230,387 113
Install
composer require davidpiesse/nova-map
Latest Version:0.0.9
PHP:>=7.1.0
License:MIT
Last Updated:Jun 4, 2022
Links: GitHub  ·  Packagist
Maintainer: davidpiesse

Total Downloads Latest Stable Version

Map Field

This map field currently ONLY shows in details view

Gif!

You can use this Map Field with three different sort of spatial data:

  • GeoJSON String property

  • Latitude and Longitude properties

  • Latitude and Longitude both in a single text field

  • Core Laravel Spatial Types

    • Point
    • LineString
    • Polygon
    • Geometry
    • GeometryCollection
    • MultiPoint
    • MultiLineString
    • MultiPolygon To use these core types you need to install grimzy/laravel-mysql-spatial See the section below on setting this up. This can work with other databases, but YMMV.
  • You can set the height of the map in px

  • The field is disabled in Index and Form views by default

  • This is very much a WIP - please submit issues to GitHub

Spatial Types

To specify what sort of spatial data you are passing to this field you MUST set the spatialType() for example

    ->spatialType('Point')

These are the valid Spatial Types

  • LatLon
  • LatLonField (single field)
  • GeoJSON
  • Point
  • LineString
  • Polygon
  • Geometry
  • GeometryCollection
  • MultiPoint
  • MultiLineString
  • MultiPolygon

Examples

Point

Map::make('Some Point Field', 'point_field_name')
    ->spatialType('Point'),

Polygon

Map::make('Some Polygon Field', 'polygon_field_name')
    ->spatialType('Polygon'),

GeoJSON

Map::make('Some GeoJSON Field')
    ->spatialType('GeoJSON')
    ->geojson('geojson_field_name'),

Latitude & Longitude (in seperate fields)

Map::make('Some Point Location')
    ->spatialType('LatLon')
    ->latitude('latitude_field_name')
    ->longitude('longitude_field_name'),

Latitude & Longitude (in single fields)

Map::make('Some Point Location', 'coordinate_field_name')
    ->spatialType('LatLonField'),

Set the Height

Map::make('Some Point Field', 'point_field_name')
    ->spatialType('Point')
    ->height('300px'),

Setting up the Laravel Spatial Types

You need to install grimzy/laravel-mysql-spatial into your main application

composer require grimzy/laravel-mysql-spatial

Add the SpatialTrait to your Model

use SpatialTrait;

You then also need to set any spatial fields you have set in the Model

protected $spatialFields = [
    'geo_point',
    'geo_linestring',
    ...
];

Your Model is now ready to process spatial data to Nova

Future Development

  • Editing capabilities for all Spatial Types
  • View Place Field address on a Map
  • Remove reliance on grimzy package from accessing core Spatial Types
  • Allow all DB spatial fields to be used
  • Customize the map futher
    • Tailwind Height classes
    • Customise Geometry Styling
      • Marker Icon
      • Colors, Thicknesses, Opacity
    • Basemap
      • Streets
      • Topo
      • Satellite
    • Navigation Tools (Compass, Zoom In/Out)
  • Alternative Map Providers
    • Google Maps
    • Mapbox
    • OpenLayers

Related Packages

epartment/nova-dependency-container

A Laravel Nova field container allowing to depend on other fields values

4,709,624 378
eminiarts/nova-tabs

Laravel Nova - Tabs.

4,653,274 464
ebess/advanced-nova-media-library

Laravel Nova tools for managing the Spatie media library.

3,922,900 616
spatie/nova-tags-field

A tags field for Nova apps

2,375,999 301
kabbouchi/nova-impersonate

A Laravel Nova field allows you to authenticate as your users.

2,281,603 234

Version History

Version Released PHP License
0.0.9 >=7.1.0 MIT
0.0.8 >=7.1.0 MIT
0.0.7 >=7.1.0 MIT
0.0.6 >=7.1.0 MIT
0.0.5 >=7.1.0 MIT
Pre-releases (1)
Version Released PHP License
0.0.7-beta >=7.1.0 MIT