PHPackages mageplaza/module-google-maps - 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. mageplaza/module-google-maps ActiveMagento2-module[Utility & Helpers](/categories/utility) mageplaza/module-google-maps ============================ Magento 2 Google Maps Extension 4.0.4(1y ago)1128.2k↓41.8%8[1 PRs](https://github.com/mageplaza/magento-2-google-maps/pulls)proprietaryPHP Since Dec 3Pushed 1y ago9 watchersCompare [ Source](https://github.com/mageplaza/magento-2-google-maps)[ Packagist](https://packagist.org/packages/mageplaza/module-google-maps)[ RSS](/packages/mageplaza-module-google-maps/feed)WikiDiscussions 2.4 Synced 2d ago READMEChangelog (10)Dependencies (1)Versions (16)Used By (0) Magento 2 Google Maps Free by Mageplaza ======================================= [](#magento-2-google-maps-free-by-mageplaza) **[M2 Google Maps extension](https://www.mageplaza.com/magento-2-google-maps/) by Mageplaza** allows stores to set the location on the web page. The Contact Us page with information about real location will make your site become more professional and reliable in the customer’s mind. [![Latest Stable Version](https://camo.githubusercontent.com/b0dc8f05709f7f1deb5e28744ff5ff9386106f4a6b2460840e3f7ce60b318da2/68747470733a2f2f706f7365722e707567782e6f72672f6d616765706c617a612f6d6f64756c652d676f6f676c652d6d6170732f762f737461626c65)](https://packagist.org/packages/mageplaza/module-google-maps)[![Total Downloads](https://camo.githubusercontent.com/8118edb9359bd837dd90aa5b782e5deaf813d93d2b06ca8e6d5037a3f126cd6e/68747470733a2f2f706f7365722e707567782e6f72672f6d616765706c617a612f6d6f64756c652d676f6f676c652d6d6170732f646f776e6c6f616473)](https://packagist.org/packages/mageplaza/module-google-maps) **IMPORTANT NOTE:** This version of Mageplaza Google Maps extension on Github is free as a contribution to the Magento community from Mageplaza. This package does not include the technical support. Should you need technical support for this extension, you will have to buy a license from Mageplaza. [Click here to buy](https://www.mageplaza.com/magento-2-google-maps/). 1. Documentation ---------------- [](#1-documentation) - [Installation guide](https://www.mageplaza.com/install-magento-2-extension/) - [User guide](https://docs.mageplaza.com/google-maps/index.html) - [Introduction page](http://www.mageplaza.com/magento-2-google-maps/) - [Contribute on Github](https://github.com/mageplaza/magento-2-google-maps) - [Get Support](https://github.com/mageplaza/magento-2-google-maps/issues) 2. FAQs ------- [](#2-faqs) **Q: I got error: Mageplaza\_Core has been already defined** A: Read solution [here](https://github.com/mageplaza/module-core/issues/3). **Q: Where the map can be displayed on my page?** A: Google Maps can be set at the top or bottom of Contact Page, by navigating to `Store > Settings > Configuration > Mageplaza Extensions > Google Maps > General > Position` and select the appropriate position. **Q: Can I customize how the map can be seen on the website?** A: Absolutely yes, there are 4 map types and 10 map styles for you to choose. **Q: Can the customer drag and zoom in/out the map?** A: The customer can easily drag to see the surrounding area of the store. However, it is unable to zoom the map, this feature is available in [Mageplaza Store Locator](https://www.mageplaza.com/magento-2-store-locator/). **Q: How my store will look like on the map?** A: There is a customizable Marker showing the exact position of your store. You can freely choose the Marker icon to be displayed. **Q: Will the map be available on mobile devices?** A: Yes, the extension works well on the mobile version. 3. How to install Magento 2 Google Maps extension ------------------------------------------------- [](#3-how-to-install-magento-2-google-maps-extension) Install via composer (recommend) Run the following command in Magento 2 root folder: With Marketing Automation (recommend): ``` composer require mageplaza/module-google-maps mageplaza/module-smtp php bin/magento setup:upgrade php bin/magento setup:static-content:deploy ``` Without Marketing Automation: ``` composer require mageplaza/module-google-maps php bin/magento setup:upgrade php bin/magento setup:static-content:deploy ``` 4. Google Maps Highlight Features --------------------------------- [](#4-google-maps-highlight-features) ### Add Google Maps to Contact Page [](#add-google-maps-to-contact-page) No more boring text to show the store location, store owners now can get the Contact Page with a more eye-catching view by Google Maps, with a marker showing exactly the store location. Magento 2 Google Maps extension by Mageplaza enable the store owner to set the position of the map at the top or bottom of the Contact Page. [![Magento 2 Add Google Maps to Contact Page](https://camo.githubusercontent.com/7e526f363b6fe6542e48c677db8153ecd7b3107ae4c80cdb981011b85c012de4/68747470733a2f2f692e696d6775722e636f6d2f58764b504f63372e706e67)](https://camo.githubusercontent.com/7e526f363b6fe6542e48c677db8153ecd7b3107ae4c80cdb981011b85c012de4/68747470733a2f2f692e696d6775722e636f6d2f58764b504f63372e706e67) ### Adjustable map’s display [](#adjustable-maps-display) **Google Maps plugin** let the website admin be possible to change how it appears on frontend flexibly. The marker showing the exact location can be configured freely. Furthermore, there are 4 options for map type which are: - Terrain - Roadmap - Satellite - Hybrid And 10 available map styles: - Default - Blue Essence - Dark Green - Dark Grey - Desert - Light Blue Water - Light Dream - Light Grey - Mid Night - Nature Color [![magento 2 Google Maps plugin](https://camo.githubusercontent.com/4ed7ef2e51ee8660ec7577c900fbaaac5f6f7419d15d8fdb17bf3d85715a1c85/68747470733a2f2f692e696d6775722e636f6d2f786a56654d51772e676966)](https://camo.githubusercontent.com/4ed7ef2e51ee8660ec7577c900fbaaac5f6f7419d15d8fdb17bf3d85715a1c85/68747470733a2f2f692e696d6775722e636f6d2f786a56654d51772e676966) ### Optional maps embedding [](#optional-maps-embedding) **Mageplaza Google Maps module** offers 2 options to add a map on the website. The first option is using Google API key, which gets the allowance to be displayed map from Google. The second one is directly embedding Google iFrame code, which is more simple. [![Magento 2 Optional maps embedding](https://camo.githubusercontent.com/8dcf3333e5bf2dd22789a3d3d4a169d15d9ab8df32fdd190d352d4ca5cf5454d/68747470733a2f2f692e696d6775722e636f6d2f754575624a35392e706e67)](https://camo.githubusercontent.com/8dcf3333e5bf2dd22789a3d3d4a169d15d9ab8df32fdd190d352d4ca5cf5454d/68747470733a2f2f692e696d6775722e636f6d2f754575624a35392e706e67) ### Automatically get GPS coordinates [](#automatically-get-gps-coordinates) By using Google API key, once the address information is provided, GPS coordinates can be automatically defined according to the latitude and longitude. These coordinates can be adjusted by the admin, to get the exact location for the marker. [![Magento 2 Automatically get GPS coordinates](https://camo.githubusercontent.com/efa3843bffc3a6080a4695f1e44fa4f0ad82a4dcfaad8b6c58b73596b6dca720/68747470733a2f2f692e696d6775722e636f6d2f574d35725072722e676966)](https://camo.githubusercontent.com/efa3843bffc3a6080a4695f1e44fa4f0ad82a4dcfaad8b6c58b73596b6dca720/68747470733a2f2f692e696d6775722e636f6d2f574d35725072722e676966) 5. More features ---------------- [](#5-more-features) #### Map dragging [](#map-dragging) It is able to drag the map and see the surrounding area of the store location. #### Mobile friendliness [](#mobile-friendliness) **Magento 2 Google Maps** can work well with both mobile and desktop devices. #### Extension compatibility [](#extension-compatibility) Google Maps extension is responsive with **Mageplaza Store Locator Extension**. It is also compatible with almost third-party modules. 6. Full Magento 2 Google Maps features -------------------------------------- [](#6-full-magento-2-google-maps-features) ### For store owners [](#for-store-owners) - Easily enable/ disable the Google Maps - Select the map’s position on Contact Page - 2 options to validate Google Map: Google API key/ Embedded code - 4 options for map type - 10 options for map style - Enable/Disable map dragging - Set default enlargement for map - Adjustable Marker icon - Automatically get GPS coordinates after inserting store address ### For shoppers [](#for-shoppers) - View store location more visually - Visually view the location of the store - Be able to drag the map and view the surrounding location - Feel more reliable about the contact information 7. User Guide ------------- [](#7-user-guide) Magento 2 default Contact Us Page is too simple, it only allows displaying text. With the new extension Google Maps by Mageplaza, it is possible to easily get Google Maps displayed on the Contact Us Page. This also helps your store improve customer trust when they know your exact location. ### 7.1. Configuration [](#71-configuration) Login to `Magento Admin`, navigate to `Store > Settings > Configuration > Mageplaza Extensions > Google Maps`. [![Magento 2 Google Maps configuration](https://camo.githubusercontent.com/14dd4006728e3eaeec86b4a2884eeebb03479d17679e00b012e8f40af31dd8e2/68747470733a2f2f692e696d6775722e636f6d2f3177687971324f2e706e67)](https://camo.githubusercontent.com/14dd4006728e3eaeec86b4a2884eeebb03479d17679e00b012e8f40af31dd8e2/68747470733a2f2f692e696d6775722e636f6d2f3177687971324f2e706e67) #### 7.1.1. General [](#711-general) [![Magento 2 configure Google Maps](https://camo.githubusercontent.com/a0b8cb43436d04dc6666808ac63b42335a9b86bb87b0dd3717a4f2c02868a4d1/68747470733a2f2f692e696d6775722e636f6d2f643441506373702e706e67)](https://camo.githubusercontent.com/a0b8cb43436d04dc6666808ac63b42335a9b86bb87b0dd3717a4f2c02868a4d1/68747470733a2f2f692e696d6775722e636f6d2f643441506373702e706e67) - **Enable**: Select `Yes` to activate Google Maps - **Insert on Contact Page**: Select Yes to add Google Maps into the Contact Page and display **Position** field - **Position**: **Top** and **Bottom** are 2 positions that are able to display the map on Contact Page #### 7.1.2 Map Settings [](#712-map-settings) There are 2 map setting modes as follows: **1. Protocol = API** [![magento 2 embed google maps](https://camo.githubusercontent.com/5223c4afc4bde620888e4433d8ca105d8b2218c177de0ca6145e5f8236467f43/68747470733a2f2f692e696d6775722e636f6d2f447577556d4b4e2e676966)](https://camo.githubusercontent.com/5223c4afc4bde620888e4433d8ca105d8b2218c177de0ca6145e5f8236467f43/68747470733a2f2f692e696d6775722e636f6d2f447577556d4b4e2e676966) - **Google API key**: Insert Google API key. Get Google API key Here. - **Map Type**: There are 4 map displaying options: Roadmap, Terrain, Satellite, and Hybrid. - **Map Style**: Displayed map style on the frontend. There are 10 main popular map styles: [![Magento 2 Google Maps extension](https://camo.githubusercontent.com/500d5d12975722d779c9ad5718ab96974fa5ea5cf670be488a5a9633afe9fa47/68747470733a2f2f692e696d6775722e636f6d2f72353873306c442e706e67)](https://camo.githubusercontent.com/500d5d12975722d779c9ad5718ab96974fa5ea5cf670be488a5a9633afe9fa47/68747470733a2f2f692e696d6775722e636f6d2f72353873306c442e706e67) - **Allow Map Dragging**: Select `Yes` to enable drag and drop on the map - **Zoom Default**: The default map enlargement - **Marker Icon**: The icon which marks the exact position on the map. The optima icon size is 20 x 20px. **Location Settings**: `Map Settings > Location Settings` [![Magento 2 Google Maps free](https://camo.githubusercontent.com/bd6262ca4822950714369b4e7db5637aa003dec333533fcd7c1776589fb1ccff/68747470733a2f2f692e696d6775722e636f6d2f6761684a4839712e706e67)](https://camo.githubusercontent.com/bd6262ca4822950714369b4e7db5637aa003dec333533fcd7c1776589fb1ccff/68747470733a2f2f692e696d6775722e636f6d2f6761684a4839712e706e67) - **Address** : Insert the address which need to be displayed on the map. Hit the button `Get GPS coordinates` to load **Latitude** and **Longitude**. - **Latitude**: Enter the latitude of the location - **Longitude**: Enter the longitude of the location **2. Protocol = Embed Code** With this method, it is possible to add the map on frontend interface by embedding Google iFrame code, without any of following map settings. [![Magento 2 Google Maps module](https://camo.githubusercontent.com/c0102c8f163f6ee9126e5162fd52e710b174bd4fe91825564fc9fe40edf82c9a/68747470733a2f2f692e696d6775722e636f6d2f426d48357355622e706e67)](https://camo.githubusercontent.com/c0102c8f163f6ee9126e5162fd52e710b174bd4fe91825564fc9fe40edf82c9a/68747470733a2f2f692e696d6775722e636f6d2f426d48357355622e706e67) - Code: Embed Google iFrame code. ### 7.2. Maps Widget [](#72-maps-widget) By adding widget, you can add the map wherever on the store. Widget can be created by the following steps: **Step 1**: Login to **Magento 2 Admin**, move to `Content > Elements > Widgets` **Step 2**: Click the `Add Widget` button to start widget setting [![Magento 2 Google Maps widget](https://camo.githubusercontent.com/00d08689aced45a04bc7d9e6b89ec70d6c69df40afbe85b23d795378064d5538/68747470733a2f2f692e696d6775722e636f6d2f774438575350482e706e67)](https://camo.githubusercontent.com/00d08689aced45a04bc7d9e6b89ec70d6c69df40afbe85b23d795378064d5538/68747470733a2f2f692e696d6775722e636f6d2f774438575350482e706e67) - Select `Mageplaza Google Maps` for **Type** field, `Magento Luma` for **Design Theme**. Then click `Continue` **Step 3**: Fill up required information in **Storefront Properties** [![Magento 2 Google Maps extension free](https://camo.githubusercontent.com/d116c01b4e84f8677fc163d77ac63ed23c10bac6cebaa001ab4201af81a8616e/68747470733a2f2f692e696d6775722e636f6d2f32654271376f7a2e706e67)](https://camo.githubusercontent.com/d116c01b4e84f8677fc163d77ac63ed23c10bac6cebaa001ab4201af81a8616e/68747470733a2f2f692e696d6775722e636f6d2f32654271376f7a2e706e67) **Step 4**: Choose the position to display the widget From `Layout Updates` > Click to `Add Layout Updates` button **Step 5**: `Save > System`. Navigate to `Cache Management`, hit the `Flush Magento Cache` button. ### 7.3. Frontend [](#73-frontend) **Using API** [![Magento 2 Google Maps module free](https://camo.githubusercontent.com/0cb9f088de3ab087448664b5a3f5fbfde9b39cc8d0d25920c5577a35eac6f4d0/68747470733a2f2f692e696d6775722e636f6d2f7458306e5744492e706e67)](https://camo.githubusercontent.com/0cb9f088de3ab087448664b5a3f5fbfde9b39cc8d0d25920c5577a35eac6f4d0/68747470733a2f2f692e696d6775722e636f6d2f7458306e5744492e706e67) [![Magento 2 Google Maps plugin free](https://camo.githubusercontent.com/9df92f97a6d77392d1ffd1b541a6a547752bd660356ec17ed5ab4b904cb13681/68747470733a2f2f692e696d6775722e636f6d2f7030663968696d2e706e67)](https://camo.githubusercontent.com/9df92f97a6d77392d1ffd1b541a6a547752bd660356ec17ed5ab4b904cb13681/68747470733a2f2f692e696d6775722e636f6d2f7030663968696d2e706e67) **Using Embed Code** [![embed google maps to magento 2](https://camo.githubusercontent.com/77743cec441d06ec6f20da586775af4c51d2da8129d2dc997c95b572db4ba5d4/68747470733a2f2f692e696d6775722e636f6d2f5a316645666a652e706e67)](https://camo.githubusercontent.com/77743cec441d06ec6f20da586775af4c51d2da8129d2dc997c95b572db4ba5d4/68747470733a2f2f692e696d6775722e636f6d2f5a316645666a652e706e67) **People also search:** - magento 2 google maps - how to add google map in magento 2 page - magento 2 embed google maps - magento 2 map - google maps magento 2 - magento 2 google maps dealer locator **Other free Magento 2 extensions on Github** - [Magento 2 SEO](https://github.com/mageplaza/magento-2-seo) - [Magento 2 Geoip](https://github.com/mageplaza/magento-2-geoip) - [Magento 2 Delete Order](https://github.com/mageplaza/magento-2-delete-orders) - [Magento 2 GDPR extension](https://github.com/mageplaza/magento-2-gdpr) - [Magento 2 Instagram Feed](https://github.com/mageplaza/magento-2-instagram-feed) - [Magento 2 Social login free](https://github.com/mageplaza/magento-2-social-login) - [Magento 2 Twitter Widget](https://github.com/mageplaza/magento-2-twitter-widget) - [Magento 2 Facebook Plugin](https://github.com/mageplaza/magento-2-facebook-plugin) **Get more [Magento 2 extension on Marketplace](https://marketplace.magento.com/partner/Mageplaza):** - [M2 One Step Checkout](https://marketplace.magento.com/mageplaza-magento-2-one-step-checkout-extension.html) - [M2 Layered Navigation](https://marketplace.magento.com/mageplaza-layered-navigation-m2.html) - [M2 Auto Related Products](https://marketplace.magento.com/mageplaza-module-automatic-related-products.html) - [M2 SEO extension](https://marketplace.magento.com/mageplaza-magento-2-seo-extension.html) - [M2 Gift Card](https://marketplace.magento.com/mageplaza-module-gift-card.html) - [M2 Image Optimizer](https://marketplace.magento.com/mageplaza-module-image-optimizer.html) - [Magento 2 Shipping Restrictions](https://marketplace.magento.com/mageplaza-module-shipping-restriction.html) - [Magento 2 Multiple Coupons](https://marketplace.magento.com/mageplaza-module-multiple-coupons.html) - [Magento 2 Order Attributes](https://marketplace.magento.com/mageplaza-module-order-attributes.html) - [Magento 2 Barcode](https://marketplace.magento.com/mageplaza-module-barcode.html) ### Health Score 45 — FairBetter than 91% of packages Maintenance42 Moderate activity, may be stable Popularity36 Limited adoption so far Community22 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor3 3 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. ### Release Activity Cadence Every ~191 days Recently: every ~326 days Total 13 Last Release 471d ago Major Versions 1.0.4 → 4.0.02021-03-23 1.0.5 → 4.0.32023-07-27 2.4.x-dev → 4.0.42025-03-20 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/2810172?v=4)[Sam Ng](/maintainers/imsamthomas)[@imsamthomas](https://github.com/imsamthomas) --- Top Contributors [![Victor-Mageplaza](https://avatars.githubusercontent.com/u/53899645?v=4)](https://github.com/Victor-Mageplaza "Victor-Mageplaza (13 commits)")[![brianmageplaza](https://avatars.githubusercontent.com/u/7621931?v=4)](https://github.com/brianmageplaza "brianmageplaza (10 commits)")[![imsamthomas](https://avatars.githubusercontent.com/u/2810172?v=4)](https://github.com/imsamthomas "imsamthomas (9 commits)")[![bdtrung](https://avatars.githubusercontent.com/u/38638387?v=4)](https://github.com/bdtrung "bdtrung (4 commits)")[![HuyPhuc98](https://avatars.githubusercontent.com/u/66774456?v=4)](https://github.com/HuyPhuc98 "HuyPhuc98 (4 commits)")[![thaimageplaza](https://avatars.githubusercontent.com/u/40683842?v=4)](https://github.com/thaimageplaza "thaimageplaza (4 commits)")[![mpnghiatt](https://avatars.githubusercontent.com/u/120617166?v=4)](https://github.com/mpnghiatt "mpnghiatt (3 commits)")[![Rainy234](https://avatars.githubusercontent.com/u/42835440?v=4)](https://github.com/Rainy234 "Rainy234 (2 commits)")[![haonv01](https://avatars.githubusercontent.com/u/34636961?v=4)](https://github.com/haonv01 "haonv01 (2 commits)")[![ngantq](https://avatars.githubusercontent.com/u/30430841?v=4)](https://github.com/ngantq "ngantq (1 commits)")[![MpEdward](https://avatars.githubusercontent.com/u/45863800?v=4)](https://github.com/MpEdward "MpEdward (1 commits)") ### Embed Badge ![Health badge](/badges/mageplaza-module-google-maps/health.svg) ``` [![Health](https://phpackages.com/badges/mageplaza-module-google-maps/health.svg)](https://phpackages.com/packages/mageplaza-module-google-maps) ``` ### Alternatives [mageplaza/magento-2-seo-extension Magento 2 SEO extension 141527.1k2](/packages/mageplaza-magento-2-seo-extension)[mageplaza/magento-2-blog-extension Magento 2 Blog extension 122748.9k5](/packages/mageplaza-magento-2-blog-extension)[mageplaza/module-delete-orders Magento 2 Delete Orders extension 59626.3k1](/packages/mageplaza-module-delete-orders)[mageplaza/module-gdpr Magento 2 GDPR Extensions 52343.3k1](/packages/mageplaza-module-gdpr)[mageplaza/magento-2-social-login Magento 2 Social Login extension is designed for quick login to your Magento 2 store without procesing complex register steps 1841.2M5](/packages/mageplaza-magento-2-social-login)[mageplaza/module-ajax-layered-navigation Magento 2 Ajax Layered Navigation Extension 40374.2k](/packages/mageplaza-module-ajax-layered-navigation) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)