Download the PHP package larswiegers/laravel-maps without Composer
On this page you can find all versions of the php package larswiegers/laravel-maps. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download larswiegers/laravel-maps
More information about larswiegers/laravel-maps
Files in larswiegers/laravel-maps
Package laravel-maps
Short Description A new way to handle maps in your laravel applications.
License MIT
Homepage https://github.com/larswiegers/laravel-maps
Informations about the package laravel-maps
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:
If you want to customize the map views more then you can publish the views:
Supported map types
What | Basic map | Different map types | Centerpoint | Basic markers | Use bounds | 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:
Usage
Leaflet
Do note that if you want to use multiple maps on the same page that you need to specify an id per map.
Leaflet Version
By default we use the latest version of leaflet, but if you want to use a different version just pass it in via a parameter:
Google Maps
Google maps api key
You can get an api key here:
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
Good to know
Double quotes need to be escaped, i.e. add a backslash followed by double quotes (/")
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:
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 [email protected] instead of using the issue tracker.
Credits
- Lars Wiegers
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-maps with dependencies
gajus/dindent Version ^2.0.2
illuminate/support Version ^9.43|^v10.0.0|^11.0