PHPackages                             doublesecretagency/craft-googlemaps - 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. [Image & Media](/categories/media)
4. /
5. doublesecretagency/craft-googlemaps

ActiveCraft-plugin[Image & Media](/categories/media)

doublesecretagency/craft-googlemaps
===================================

Maps in minutes. Powered by the Google Maps API.

5.2.0(3mo ago)1267.9k↓35.9%13[22 issues](https://github.com/doublesecretagency/craft-googlemaps/issues)[2 PRs](https://github.com/doublesecretagency/craft-googlemaps/pulls)proprietaryPHPCI passing

Since Feb 6Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/doublesecretagency/craft-googlemaps)[ Packagist](https://packagist.org/packages/doublesecretagency/craft-googlemaps)[ RSS](/packages/doublesecretagency-craft-googlemaps/feed)WikiDiscussions v5-dev Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (74)Used By (0)

[![Plugin icon](https://camo.githubusercontent.com/76541fb2968b6ebcb31b76f3fff711d36a9d8a8f8d85870b517903252882cfad/68747470733a2f2f706c7567696e732e646f75626c657365637265746167656e63792e636f6d2f676f6f676c652d6d6170732f696d616765732f69636f6e2e737667)](https://camo.githubusercontent.com/76541fb2968b6ebcb31b76f3fff711d36a9d8a8f8d85870b517903252882cfad/68747470733a2f2f706c7567696e732e646f75626c657365637265746167656e63792e636f6d2f676f6f676c652d6d6170732f696d616765732f69636f6e2e737667)

Google Maps plugin for Craft CMS
================================

[](#google-maps-plugin-for-craft-cms)

**Maps in minutes. Powered by the Google Maps API.**

---

 [Address Fields](#includes-easy-to-use-address-fields) • [Dynamic & Static Maps](#create-flexible-dynamic--static-maps) • [Proximity Searching](#search-for-the-nearest-locations) • [IP-based Geolocation](#simple-ip-based-visitor-geolocation)

---

### Includes easy-to-use Address Fields

[](#includes-easy-to-use-address-fields)

When managing your Craft data, each location can be set with a convenient Address field...

 [![Animated GIF of an Address field](https://github.com/doublesecretagency/craft-googlemaps/raw/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/address-field.gif?raw=true)](https://github.com/doublesecretagency/craft-googlemaps/blob/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/address-field.gif?raw=true)

### Create flexible Dynamic & Static Maps

[](#create-flexible-dynamic--static-maps)

Add markers, use info windows, style maps, change marker icons, apply KML layers, and much, much more...

 [![Screenshot of a dynamic map](https://github.com/doublesecretagency/craft-googlemaps/raw/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/dynamic-map.png?raw=true)](https://github.com/doublesecretagency/craft-googlemaps/blob/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/dynamic-map.png?raw=true)

> **Universal API**
>
> The plugin features a powerful [universal API](https://plugins.doublesecretagency.com/google-maps/dynamic-maps/universal-api/) which works nearly identically across **JavaScript, Twig, and PHP!**

### Search for the Nearest Locations

[](#search-for-the-nearest-locations)

Find the closest locations, and sort the results from nearest to furthest...

 [![Screenshot of a set of proximity search results](https://github.com/doublesecretagency/craft-googlemaps/raw/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/proximity-search.png?raw=true)](https://github.com/doublesecretagency/craft-googlemaps/blob/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/proximity-search.png?raw=true)

### Simple IP-based Visitor Geolocation

[](#simple-ip-based-visitor-geolocation)

Locate your visitors based on their device's IP address...

 [![Screenshot of visitor geolocation results](https://github.com/doublesecretagency/craft-googlemaps/raw/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/geolocation.png?raw=true)](https://github.com/doublesecretagency/craft-googlemaps/blob/9b27de094d7cf8fc5b1f044354b99ddce9019a89/docs/README-images/geolocation.png?raw=true)

---

How to Install the Plugin
-------------------------

[](#how-to-install-the-plugin)

### Installation via Plugin Store

[](#installation-via-plugin-store)

See the complete instructions for [installing via the plugin store...](https://plugins.doublesecretagency.com/google-maps/getting-started/#installation-via-plugin-store)

### Installation via Console Commands

[](#installation-via-console-commands)

To install the **Google Maps** plugin via the console, follow these steps:

1. Open your terminal and go to your Craft project:

```
cd /path/to/project
```

2. Then tell Composer to load the plugin:

```
composer require doublesecretagency/craft-googlemaps
```

3. Then tell Craft to install the plugin:

```
./craft plugin/install google-maps
```

> Alternatively, you can visit the **Settings > Plugins** page to finish the installation. If installed via the control panel, you will automatically be redirected to configure the plugin after installation is complete.

Once installed, you will need to [add Google API keys...](https://plugins.doublesecretagency.com/google-maps/getting-started/api-keys/)

---

Simple Code Examples
--------------------

[](#simple-code-examples)

**These examples barely scratch the surface of what is possible!**

For complete details, check out the [official plugin documentation...](https://plugins.doublesecretagency.com/google-maps/)

### Adding a Dynamic Map

[](#adding-a-dynamic-map)

```
{# Get the entries #}
{% set entries = craft.entries.section('locations').all() %}

{# Place them on a dynamic map #}
{{ googleMaps.map(entries).tag() }}
```

> [Full dynamic maps docs are here...](https://plugins.doublesecretagency.com/google-maps/dynamic-maps/)

### Adding a Static Map

[](#adding-a-static-map)

```
{# Get the entries #}
{% set entries = craft.entries.section('locations').all() %}

{# Place them on a static map #}
{{ googleMaps.img(entries).tag() }}
```

Or use the `src` attribute directly...

```
{# Get only the image URL of a static map #}
{% set src = googleMaps.img(entries).src() %}

{# Display the image tag manually #}

```

> [Full static maps docs are here...](https://plugins.doublesecretagency.com/google-maps/static-maps/)

### Conducting a Proximity Search

[](#conducting-a-proximity-search)

```
{# Set the geocoding lookup target #}
{% set target = '123 Main St' %}

{# Get a set of entries, sorted by closest to target #}
{% set entries = craft.entries.myAddressField(target).orderBy('distance').all() %}
```

> [Full proximity search docs are here...](https://plugins.doublesecretagency.com/google-maps/proximity-search/)

### Conducting a Geocoding Address Lookup

[](#conducting-a-geocoding-address-lookup)

```
{# Set the geocoding lookup target #}
{% set target = '123 Main St' %}

{# Get a set of geocoding results #}
{% set results = googleMaps.lookup(target).all() %}
```

> [Full geocoding docs are here...](https://plugins.doublesecretagency.com/google-maps/geocoding/)

### Geolocating Visitors

[](#geolocating-visitors)

```
{# Get location data based on each visitor's IP address #}
{% set visitor = googleMaps.visitor %}
```

> [Full geolocation docs are here...](https://plugins.doublesecretagency.com/google-maps/geolocation/)

---

Further Reading
---------------

[](#further-reading)

If you haven't already, flip through the [complete plugin documentation](https://plugins.doublesecretagency.com/google-maps/). The examples above are just the tip of the iceberg, there is so much more that is possible!

And if you have any remaining questions, feel free to [reach out to us](https://www.doublesecretagency.com/contact) (via Discord is preferred).

**On behalf of Double Secret Agency, thanks for checking out our plugin!** 🍺

 [![Logo for Double Secret Agency](https://camo.githubusercontent.com/e834ce35abc7cbeca17d458aba00fae271f59507ddf73fa2dfff1bee091b22ea/68747470733a2f2f7777772e646f75626c657365637265746167656e63792e636f6d2f7265736f75726365732f696d616765732f6473612d7472616e73706172656e742e706e67)](https://camo.githubusercontent.com/e834ce35abc7cbeca17d458aba00fae271f59507ddf73fa2dfff1bee091b22ea/68747470733a2f2f7777772e646f75626c657365637265746167656e63792e636f6d2f7265736f75726365732f696d616765732f6473612d7472616e73706172656e742e706e67)

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance64

Regular maintenance activity

Popularity40

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 99% of commits — single point of failure

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 ~26 days

Recently: every ~85 days

Total

72

Last Release

69d ago

Major Versions

4.6.4 → 5.1.32025-02-18

4.6.5 → 5.1.42025-02-21

4.6.6 → 5.1.52025-03-17

4.6.7 → 5.1.62025-04-04

v4.x-dev → 5.2.02026-02-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/b9ec4fd6e26eb61622c4e869ab85bc19af660fbba9c0679a86c7cb39ac980c2a?d=identicon)[lindseydiloreto](/maintainers/lindseydiloreto)

---

Top Contributors

[![lindseydiloreto](https://avatars.githubusercontent.com/u/5309692?v=4)](https://github.com/lindseydiloreto "lindseydiloreto (680 commits)")[![bencroker](https://avatars.githubusercontent.com/u/57572400?v=4)](https://github.com/bencroker "bencroker (4 commits)")[![brandonkelly](https://avatars.githubusercontent.com/u/47792?v=4)](https://github.com/brandonkelly "brandonkelly (1 commits)")[![carlcs](https://avatars.githubusercontent.com/u/7516543?v=4)](https://github.com/carlcs "carlcs (1 commits)")[![timkelty](https://avatars.githubusercontent.com/u/18329?v=4)](https://github.com/timkelty "timkelty (1 commits)")

---

Tags

addresscraft-cmscraft-cms-plugincraft-plugincraftcmsgeocodinggeolocationgoogle-mapsgoogle-maps-apimapmapsproximity-searchingvisitor-geolocationgeocodingaddressgeolocationmapcmsCraftcraftcmscraft-plugingoogle mapsGoogle Maps APIlocationssmart-mapproximity-searchsmartmap

### Embed Badge

![Health badge](/badges/doublesecretagency-craft-googlemaps/health.svg)

```
[![Health](https://phpackages.com/badges/doublesecretagency-craft-googlemaps/health.svg)](https://phpackages.com/packages/doublesecretagency-craft-googlemaps)
```

###  Alternatives

[swixpop/locate

Harness the power of the Google Autocomplete API inside Craft. Adds an autocomplete search box to Craft entries.

154.8k](/packages/swixpop-locate)[spacecatninja/imager-x

Ninja powered image transforms.

29390.0k23](/packages/spacecatninja-imager-x)[nystudio107/craft-youtubeliveembed

This plugin allows you to embed a YouTube live stream and/or live chat on your webpage

163.7k](/packages/nystudio107-craft-youtubeliveembed)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)