PHPackages icreaciones/googlmapper - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. icreaciones/googlmapper ActiveLibrary[Utility & Helpers](/categories/utility) icreaciones/googlmapper ======================= An easy way to integrate Google Maps with Laravel. 09PHP Since Jul 4Pushed 2y agoCompare [ Source](https://github.com/icreaciones/Googlmapper-L10)[ Packagist](https://packagist.org/packages/icreaciones/googlmapper)[ RSS](/packages/icreaciones-googlmapper/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)DependenciesVersions (1)Used By (0) An easy way to integrate Google Maps with Laravel ================================================= [](#an-easy-way-to-integrate-google-maps-with-laravel) [![Latest Stable Version](https://camo.githubusercontent.com/0e958282ff424b1cc511df1cd8e8357189b04fa6537ec1f4381055a944530696/68747470733a2f2f706f7365722e707567782e6f72672f636f726e666f72642f476f6f676c6d61707065722f76657273696f6e2e706e67)](https://packagist.org/packages/cornford/googlmapper)[![Total Downloads](https://camo.githubusercontent.com/08248ffe6da5bf97c1af9357fb34d565c2e46ec6938f09bf2da0435494d1a0a7/68747470733a2f2f706f7365722e707567782e6f72672f636f726e666f72642f676f6f676c6d61707065722f642f746f74616c2e706e67)](https://packagist.org/packages/cornford/googlmapper)[![Build Status](https://camo.githubusercontent.com/a777236088814825ca0b7c45de70334f625858b9de22226430f441a401ec3af0/68747470733a2f2f7472617669732d63692e6f72672f62726164636f726e666f72642f476f6f676c6d61707065722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/bradcornford/Googlmapper)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/352f57ad3cdd3b8fbecf575bce3b0798f51024ab4ad095ffb75bfdd0cf92badb/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f62726164636f726e666f72642f476f6f676c6d61707065722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/bradcornford/Googlmapper/?branch=master) ### For Laravel 5.x, check [version 2.35.1](https://github.com/bradcornford/Googlmapper/tree/v2.35.1) [](#for-laravel-5x-check-version-2351) ### For Laravel 4.x, check [version 1.27.0](https://github.com/bradcornford/Googlmapper/tree/v1.27.0) [](#for-laravel-4x-check-version-1270) Think of Googlmapper as an easy way to integrate Google Maps with Laravel, providing a variety of helpers to speed up the utilisation of mapping. These include: - `Mapper::map` - `Mapper::location` - `Mapper::streetview` - `Mapper::marker` - `Mapper::informationWindow` - `Mapper::polyline` - `Mapper::polygon` - `Mapper::rectangle` - `Mapper::circle` - `Mapper::render` Installation ------------ [](#installation) Begin by installing this package through Composer. Edit your project's `composer.json` file to require `cornford/googlmapper`. ``` "require": { "cornford/googlmapper": "3.*" } ``` Next, update Composer from the Terminal: ``` composer update ``` Once this operation completes, the next step is to add the service provider. Open `app/config/app.php`, and add a new item to the providers array. ``` Cornford\Googlmapper\MapperServiceProvider::class, ``` The next step is to introduce the facade. Open `app/config/app.php`, and add a new item to the aliases array. ``` 'Mapper' => Cornford\Googlmapper\Facades\MapperFacade::class, ``` Finally we need to introduce the configuration files into your application. ``` php artisan vendor:publish --provider="Cornford\Googlmapper\MapperServiceProvider" --tag=googlmapper ``` You also need to set your Google API Key into the `GOOGLE_API_KEY` environment variable. To obtain an API key for your project, visit the [Google developers console](https://console.developers.google.com/). That's it! You're all set to go. Configuration ------------- [](#configuration) You can now configure Googlmapper in a few simple steps. Open `app/config/packages/cornford/googlmapper/config.php` and update the options as needed. - `enabled` - Enable Google Maps. - `key` - A Google Maps API key. - `region` - A region Google Maps should utilise, required in ISO 3166-1 code format, e.g. GB. - `language` - A language Google Maps should utilise, required in ISO 639-1 code format, e.g. en-gb. - `async` - Perform the loading and rendering of Googlmapper map asynchronously, e.g. false. - `marker` - Automatically add Google Maps marker for your maps initial location, e.g. true. - `center` - Automatically center Google Maps around the initial location, when false, Google Maps will automatically center the map, e.g. true. - `locate` - Automatically center Google Maps around the users current location, when false, Google Maps will automatically center the map, e.g. true. - `zoom` - Set the default zoom level for Google Maps, e.g. 8. - `scrollWheelZoom` - Set the default scroll wheel zoom Google Maps, e.g. true. - `zoomControl` - Set the default zoom control for Google Maps, e.g. true. - `mapTypeControl` - Set the default map type control for Google Maps, e.g. true. - `scaleControl` - Set the default scale control for Google Maps, e.g. true. - `streetViewControl` - Set the default street view control for Google Maps, e.g. true. - `rotateControl` - Set the default rotate control for Google Maps, e.g. true. - `fullscreenControl` - Set the default fullscreen control for Google Maps, e.g. true. - `gestureHandling` - Set the default gesture handling for Google Maps, e.g. auto, none, cooperative, greedy. - `type` - Set the default map type for Google Maps, e.g. ROADMAP, SATELLITE, HYBRID, TERRAIN. - `ui` - Show the Google Maps default UI options, e.g. true. - `markers.icon` - Set the default marker icon, e.g. img/icon.png. - `markers.animation` - Set the default marker animation, e.g. NONE, DROP, BOUNCE. - `markers.autoClose` - Automatically close Information Windows of current marker when other markers are clicked, e.g. true. - `cluster` - Set if map marker clusters should be used. - `clusters.icon` - Display custom images for clusters using icon path. - `clusters.grid` - The grid size of a cluster in pixels. - `clusters.zoom` - The maximum zoom level that a marker can be part of a cluster. - `clusters.center` - Whether the center of each cluster should be the average of all markers in the cluster. - `clusters.size` - The minimum number of markers to be in a cluster before the markers are hidden and a count is shown. Usage ----- [](#usage) It's really as simple as using the Mapper class in any Controller / Model / File you see fit with: `Mapper::` This will give you access to - [Map](#map) - [Location](#location) - [Streetview](#streetview) - [Marker](#marker) - [Information Window](#information-window) - [Polyline](#polyline) - [Polygon](#polygon) - [Rectangle](#rectangle) - [Circle](#circle) - [Render](#render) - [RenderJavascript](#renderjavascript) ### Example [](#example) Initialize the map in your controller `MapController.php`: ``` use Mapper; public function index() { Mapper::map(53.381128999999990000, -1.470085000000040000); return view('map') } ``` Within in the view `map.blade.php` add following code to render the map: ``` {!! Mapper::render() !!} ``` ### Map [](#map) The `map` method allows a map to be created, with latitude, longitude and optional parameters for options. ``` Mapper::map(53.381128999999990000, -1.470085000000040000); Mapper::map(53.381128999999990000, -1.470085000000040000, ['zoom' => 15, 'center' => false, 'marker' => false, 'type' => 'HYBRID', 'overlay' => 'TRAFFIC']); Mapper::map(53.381128999999990000, -1.470085000000040000, ['zoom' => 10, 'markers' => ['title' => 'My Location', 'animation' => 'DROP']]); Mapper::map(53.381128999999990000, -1.470085000000040000, ['zoom' => 10, 'markers' => ['title' => 'My Location', 'animation' => 'DROP'], 'cluster' => false]); Mapper::map(53.381128999999990000, -1.470085000000040000, ['zoom' => 10, 'markers' => ['title' => 'My Location', 'animation' => 'DROP'], 'clusters' => ['size' => 10, 'center' => true, 'zoom' => 20]]); ``` ##### Map Events [](#map-events) **Before Load** This event is fired before the map is loaded. ``` Mapper::map(53.381128999999990000, -1.470085000000040000, ['eventBeforeLoad' => 'console.log("before load");']); ``` **After Load** This event is fired after the map is loaded. ``` Mapper::map(53.381128999999990000, -1.470085000000040000, ['eventAfterLoad' => 'console.log("after load");']); ``` ### Location [](#location) The `location` method allows a location to be searched for with a string, returning a Location object with its latitude and longitude. ``` Mapper::location('Sheffield'); Mapper::location('Sheffield')->map(['zoom' => 15, 'center' => false, 'marker' => false, 'type' => 'HYBRID', 'overlay' => 'TRAFFIC']); Mapper::location('Sheffield')->streetview(1, 1, ['ui' => false]); ``` ### Streetview [](#streetview) The `streetview` method allows a streetview map to be created, with latitude, longitude, heading, pitch and optional parameters for options. ``` Mapper::streetview(53.381128999999990000, -1.470085000000040000, 1, 1); Mapper::streetview(53.381128999999990000, -1.470085000000040000, 1, 1, ['ui' => false]); ``` ### Marker [](#marker) The `marker` method allows a marker to be added to a map, with latitude, longitude, and optional parameters for options. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000); Mapper::marker(53.381128999999990000, -1.470085000000040000, ['animation' => 'DROP', 'label' => 'Marker', 'title' => 'Marker', 'draggable' => true]); Mapper::marker(53.381128999999990000, -1.470085000000040000, ['icon' => 'https://chart.googleapis.com/chart?chst=d_map_pin_letter&chld=|FE6256|000000']); Mapper::marker(53.381128999999990000, -1.470085000000040000, ['icon' => ['url' => 'https://chart.googleapis.com/chart?chst=d_map_pin_letter&chld=|FE6256|000000', 'scale' => 100]]); Mapper::map(52.381128999999990000, 0.470085000000040000, ['markers' => ['icon' => ['symbol' => 'CIRCLE', 'scale' => 10], 'animation' => 'DROP', 'label' => 'Marker', 'title' => 'Marker']])->marker(53.381128999999990000, -1.470085000000040000); Mapper::marker(53.381128999999990000, -1.470085000000040000, [ 'title' => 'title', 'icon' => [ 'path' => 'M10.5,0C4.7,0,0,4.7,0,10.5c0,10.2,9.8,19,10.2,19.4c0.1,0.1,0.2,0.1,0.3,0.1s0.2,0,0.3-0.1C11.2,29.5,21,20.7,21,10.5 C21,4.7,16.3,0,10.5,0z M10.5,5c3,0,5.5,2.5,5.5,5.5S13.5,16,10.5,16S5,13.5,5,10.5S7.5,5,10.5,5z', 'fillColor' => '#DD716C', 'fillOpacity' => 1, 'strokeWeight' => 0, 'anchor' => [0, 0], 'origin' => [0, 0], 'size' => [21, 30] ], 'label' => [ 'text' => 'Marker', 'color' => '#B9B9B9', 'fontFamily' => 'Arial', 'fontSize' => '13px', 'fontWeight' => 'bold', ], 'autoClose' => true, 'clickable' => false, 'cursor' => 'default', 'opacity' => 0.5, 'visible' => true, 'zIndex' => 1000, ]); ``` #### Draggable Markers [](#draggable-markers) If you need draggable marker, you can add option draggable. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true]); ``` ##### Draggable Events [](#draggable-events) **Click** This event is fired when the marker icon was clicked. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventClick' => 'console.log("left click");']); ``` **Double Click** This event is fired when the marker icon was double clicked. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventDblClick' => 'console.log("double left click");']); ``` **Right Click** This event is fired for a right click on the marker. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventRightClick' => 'console.log("right click");']); ``` **Mouse Over** This event is fired when the mouse enters the area of the marker icon. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventMouseOver' => 'console.log("mouse over");']); ``` **Mouse Down** This event is fired for a mouse down on the marker. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventMouseDown' => 'console.log("mouse down");']); ``` **Mouse Up** This event is fired for a mouse up on the marker. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventMouseUp' => 'console.log("mouse up");']); ``` **Mouse Out** This event is fired when the mouse leaves the area of the marker icon. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventMouseOut' => 'console.log("mouse out");']); ``` **Drag** This event is repeatedly fired while the user drags the marker. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventDrag' => 'console.log("dragging");']); ``` **Drag Start** This event is fired when the user starts dragging the marker. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventDragStart' => 'console.log("drag start");']); ``` **Drag End** This event is fired when the user stops dragging the marker. ``` Mapper::marker(53.381128999999990000, -1.470085000000040000, ['draggable' => true, 'eventDragEnd' => 'console.log("drag end");']); ``` ### Information Window [](#information-window) The `informationWindow` method allows an information window to be added to to a map, with latitude, longitude, content, and optional parameters for options. ``` Mapper::informationWindow(53.381128999999990000, -1.470085000000040000, 'Content'); Mapper::informationWindow(53.381128999999990000, -1.470085000000040000, 'Content', ['open' => true, 'maxWidth'=> 300, 'autoClose' => true, 'markers' => ['title' => 'Title']]); Mapper::map(52.381128999999990000, 0.470085000000040000)->informationWindow(53.381128999999990000, -1.470085000000040000, 'Content', ['markers' => ['animation' => 'DROP']]); ``` ### Polyline [](#polyline) The `polyline` method allows a polyline to be added to a map, with coordinates, and optional parameters for options. ``` Mapper::polyline([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]]); Mapper::polyline([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]], ['editable' => 'true']); Mapper::map(52.381128999999990000, 0.470085000000040000)->polyline([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]], ['strokeColor' => '#000000', 'strokeOpacity' => 0.1, 'strokeWeight' => 2]); ``` ### Polygon [](#polygon) The `polygon` method allows a polygon to be added to a map, with coordinates, and optional parameters for options. ``` Mapper::polygon([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]]); Mapper::polygon([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]], ['editable' => 'true']); Mapper::map(52.381128999999990000, 0.470085000000040000)->polygon([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]], ['strokeColor' => '#000000', 'strokeOpacity' => 0.1, 'strokeWeight' => 2, 'fillColor' => '#FFFFFF']); ``` ### Rectangle [](#rectangle) The `rectangle` method allows a rectangle to be added to a map, with coordinates, and optional parameters for options. ``` Mapper::rectangle([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]]); Mapper::rectangle([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]], ['editable' => 'true']); Mapper::map(52.381128999999990000, 0.470085000000040000)->rectangle([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000], ['latitude' => 52.381128999999990000, 'longitude' => 0.470085000000040000]], ['strokeColor' => '#000000', 'strokeOpacity' => 0.1, 'strokeWeight' => 2, 'fillColor' => '#FFFFFF']); ``` ### Circle [](#circle) The `circle` method allows a circle to be added to a map, with coordinates, and optional parameters for options. ``` Mapper::circle([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000]]); Mapper::circle([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000]], ['editable' => 'true']); Mapper::map(52.381128999999990000, 0.470085000000040000)->circle([['latitude' => 53.381128999999990000, 'longitude' => -1.470085000000040000]], ['strokeColor' => '#000000', 'strokeOpacity' => 0.1, 'strokeWeight' => 2, 'fillColor' => '#FFFFFF', 'radius' => 1000]); ``` ### Render [](#render) The `render` method allows all maps to be rendered to the page, this method can be included in Views or added as controller passed parameter, and optional parameter for item. ``` Mapper::render(); Mapper::render(0); ``` ### RenderJavascript [](#renderjavascript) The `renderJavascript` method allows all required javascript to be rendered to the page, this method can be included in Views or added as controller passed parameter. ``` Mapper::renderJavascript(); ``` ### License [](#license) Googlmapper is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT) ### Health Score 15 — LowBetter than 3% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community16 Small or concentrated contributor base Maturity22 Early-stage or recently created project Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/ab895139a3d4b96e0b79d42930158298c204db2363ee930129955ad37c2ca8cd?d=identicon)[icreaciones](/maintainers/icreaciones) --- Top Contributors [![bradcornford](https://avatars.githubusercontent.com/u/2913887?v=4)](https://github.com/bradcornford "bradcornford (31 commits)")[![icreaciones](https://avatars.githubusercontent.com/u/97635999?v=4)](https://github.com/icreaciones "icreaciones (7 commits)")[![vjoao](https://avatars.githubusercontent.com/u/3329477?v=4)](https://github.com/vjoao "vjoao (5 commits)")[![jochensengier](https://avatars.githubusercontent.com/u/10118729?v=4)](https://github.com/jochensengier "jochensengier (2 commits)")[![jozeflambrecht](https://avatars.githubusercontent.com/u/11506957?v=4)](https://github.com/jozeflambrecht "jozeflambrecht (2 commits)")[![kylops](https://avatars.githubusercontent.com/u/11800607?v=4)](https://github.com/kylops "kylops (2 commits)")[![azorpax](https://avatars.githubusercontent.com/u/12295737?v=4)](https://github.com/azorpax "azorpax (2 commits)")[![michellaurent](https://avatars.githubusercontent.com/u/1630290?v=4)](https://github.com/michellaurent "michellaurent (2 commits)")[![syahzul](https://avatars.githubusercontent.com/u/707301?v=4)](https://github.com/syahzul "syahzul (2 commits)")[![tailonperin](https://avatars.githubusercontent.com/u/25405058?v=4)](https://github.com/tailonperin "tailonperin (2 commits)")[![vool](https://avatars.githubusercontent.com/u/441840?v=4)](https://github.com/vool "vool (1 commits)")[![dbr0](https://avatars.githubusercontent.com/u/13360206?v=4)](https://github.com/dbr0 "dbr0 (1 commits)")[![leewillis77](https://avatars.githubusercontent.com/u/1097338?v=4)](https://github.com/leewillis77 "leewillis77 (1 commits)")[![SDekkers](https://avatars.githubusercontent.com/u/913981?v=4)](https://github.com/SDekkers "SDekkers (1 commits)")[![td204](https://avatars.githubusercontent.com/u/302822?v=4)](https://github.com/td204 "td204 (1 commits)")[![atefBB](https://avatars.githubusercontent.com/u/10966925?v=4)](https://github.com/atefBB "atefBB (1 commits)") ### Embed Badge ![Health badge](/badges/icreaciones-googlmapper/health.svg) ``` [![Health](https://phpackages.com/badges/icreaciones-googlmapper/health.svg)](https://phpackages.com/packages/icreaciones-googlmapper) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)