LarsWiegers / laravel-maps by LarsWiegers

A new way to handle maps in your laravel applications.
51,998
260
5
Package Data
Maintainer Username: LarsWiegers
Maintainer Contact: larswiegers@live.nl (Lars Wiegers)
Package Create Date: 2021-04-22
Package Last Update: 2024-02-20
Home Page: https://github.com/LarsWiegers/laravel-maps
Language: PHP
License: MIT
Last Refreshed: 2024-11-18 03:00:02
Package Statistics
Total Downloads: 51,998
Monthly Downloads: 1,991
Daily Downloads: 42
Total Stars: 260
Total Watchers: 5
Total Forks: 35
Total Open Issues: 0

Laravel maps

Latest Version on Packagist Total Downloads GitHub Actions

Laravel maps

This package allows you to easily use leaflet.js or google maps to create a map in your laravel project.

Installation

You can install the package via composer:

composer require larswiegers/laravel-maps

If you want to customize the map views more then you can publish the views:

php artisan vendor:publish --provider="Larswiegers\LaravelMaps\LaravelMapsServiceProvider"

Supported map types

| What | Basic map | Centerpoint | Basic markers | Zoomlevel | Can use different tiles | Can be used multiple times on the same page | | ------------- |:-------------:|:------------:|:--------------:|:----------:|:------------------------:|:--------------------------------------------| | Leaflet | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | Google maps | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |

Tilehosts

Openstreetmap

Openstreetmap is a creative commence tile library created by volunteers. No configuration has to be set to use as it is the default tilehost for this library. More information can be found here: openstreetmap.org

Mapbox

Mapbox is a for profit company that also offers free keys. Their map can be more accurate / precise. To get your free key go to mapbox.com Once logged in you can get your free key and use it by placing it in the env file like this MAPS_MAPBOX_ACCESS_TOKEN.

Attribution

Mapbox requires you to have attribution when you use their tilehost. More information on that here: https://docs.mapbox.com/help/getting-started/attribution/ We provide a default value if you use mapbox. But if you want to customize it you can pass in the te text via the attribution attribute. Like this:

<x-maps-leaflet 
    :attribution="Map data &copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors, Imagery © <a href="https://www.mapbox.com/">Mapbox</a>">
</x-maps-leaflet>

Usage

Leaflet

// Leaflet
// A basic map is as easy as using the x blade component.

<x-maps-leaflet></x-maps-leaflet>

// set the centerpoint of the map:
<x-maps-leaflet :centerPoint="['lat' => 52.16, 'long' => 5]"></x-maps-leaflet>

// set a zoomlevel:
<x-maps-leaflet :zoomLevel="6"></x-maps-leaflet>

// Set markers on the map:
<x-maps-leaflet :markers="[['lat' => 52.16444513293423, 'long' => 5.985622388024091]]"></x-maps-leaflet>

Do note that if you want to use multiple maps on the same page that you need to specify an id per map.

Google maps

// Google maps

// set the centerpoint of the map:
<x-maps-google :centerPoint="['lat' => 52.16, 'long' => 5]"></x-maps-google>

// set a zoomlevel:
<x-maps-google :zoomLevel="6"></x-maps-google>

// Set markers on the map:
<x-maps-google :markers="[['lat' => 52.16444513293423, 'long' => 5.985622388024091]]"></x-maps-google>

// You can customize the title for each markers:
<x-maps-google :markers="[['lat' => 52.16444513293423, 'long' => 5.985622388024091, 'title' => 'Your Title']]"></x-maps-google>

Google maps api key

You can get an api key here: console.cloud.google.com Create an api key and enable the Maps Javascript API in the console aswell. Place the api key in the env file like this MAPS_GOOGLE_MAPS_ACCESS_TOKEN

Usage in livewire

This library does not support livewire out of the box, but some users have found a workaround to work. Please see this issue for more information: https://github.com/LarsWiegers/laravel-maps/issues/34

Feel free to PR a livewire component if you have the time.

Testing

To run the tests just use the following component:

composer test

Testing is done through rendering the blade components and making assertions on the html outputted. While this is great for initial testing it does lack some more certainty. In the future an browser test may be needed to further make sure that the code works as intended.

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email larswiegers@live.nl instead of using the issue tracker.

Credits

License

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