PHPackages                             dolphiq/craft3-locationpicker - 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. dolphiq/craft3-locationpicker

ActiveCraft-plugin

dolphiq/craft3-locationpicker
=============================

Craft Location picker

1.0.0(8y ago)75702JavaScript

Since Oct 20Pushed 5y ago2 watchersCompare

[ Source](https://github.com/Dolphiq/craft3-locationpicker)[ Packagist](https://packagist.org/packages/dolphiq/craft3-locationpicker)[ RSS](/packages/dolphiq-craft3-locationpicker/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (2)Versions (4)Used By (0)

Locationpicker plugin for Craft CMS 3.x
=======================================

[](#locationpicker-plugin-for-craft-cms-3x)

A location field that lets you pick a location and shows it on google maps. You also have the possibility to group multiple chosen locations.

**Note**: This plugin may become a paid add-on when the Craft Plugin store becomes available.

Requirements
------------

[](#requirements)

- Craft 3.0 (beta 28)+
- PHP 7.0+
- Google Maps API Key

Installation
------------

[](#installation)

1. Install with Composer

    ```
    composer require dolphiq/craft3-locationpicker

    ```
2. Install plugin in the Craft Control Panel under Settings > Plugins
3. The Location Field type will be available when adding a new field - Settings > Fields > Add new field

Creating a field with the location field type
---------------------------------------------

[](#creating-a-field-with-the-location-field-type)

1. Choose the `Location Field` type
2. Save the field

Using the location field type
-----------------------------

[](#using-the-location-field-type)

1. Add the field to a field layout (for example to a section)
2. You can now choose an location when creating or updating a section by clicking on the `Pick location` button
3. When clicking this button you will get a popup. Type the adress to search for a location.
4. You will now get a dropdown list. Click on one of the options in the dropdownlist to choose a location.
5. The location will be shown on the map below
6. Click on the red `Select` button in the bottom right corner of the popup to use the choosen location in the entry.
7. If you click cancel or dismiss the popup the choosen location will not be set in the entry.

Usage sample to display a map with one location
-----------------------------------------------

[](#usage-sample-to-display-a-map-with-one-location)

Display a google map with the choosen location in a twig template

```
{{ entry.fieldName.getMap() }}
```

##### Properties of the icon field

[](#properties-of-the-icon-field)

1. Get the location address (string)

    ```
    {{ entry.fieldName.address }}

    ```
2. Get the location latitude

    ```
    {{ entry.fieldName.lat }}

    ```
3. Get the location longitude

    ```
    {{ entry.fieldName.long }}

    ```
4. Display a map with the location. Options is an array, see [options part](#map-options)

    ```
    {{ entry.fieldName.getMap()|raw }}

    ```

Usage sample to display a map with more locations
-------------------------------------------------

[](#usage-sample-to-display-a-map-with-more-locations)

To display more locations on the same map (a marker for every location), we use the twig function `dolphiqMap`. Lets say we have a structure called `hospitals` with entries that each have a location field. To display a map with all locations do the following in a twig template:

```
{% set hospitals = craft.entries.section('hospitals').all() %}
{% set locations = {} %}

{% for hospital in hospitals %}

    {% set locations = locations|merge({(loop.index) : hospital.location}) %}

{% endfor %}

{{ dolphiqMap(locations, {width:'100%', height:'500px'})|raw }}
```

Properties and options
----------------------

[](#properties-and-options)

Properties of the `dolphiqMap(locations, options)` function

###### Properties

[](#properties)

PropertyTypeDescriptionlocationsarrayShould be an array or a multidemensional array for more locations with at least a `lat` and `long` attribute for each locationoptionsarrayAn array with one of the following options###### Map Options

[](#map-options)

OptionTypeDefaultDescriptionwidthstring100%The width of the google map. In css units. So you can use percentage as wel as pixelsheightstring500pxThe height of the google map. In css units. So you can use percentage as wel as pixelsContributors & Developers
-----------------------------

[](#contributors--developers)

Lucas Weijers - Original developer

Brought to you by Dolphiq:

###  Health Score

32

—

LowBetter than 71% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

2979d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9dfab1936de2791991111dcf8e0dc68b0ca43d1fedda94dc793e6dadcb467a09?d=identicon)[dolphiq](/maintainers/dolphiq)

---

Top Contributors

[![johanzandstra](https://avatars.githubusercontent.com/u/4737521?v=4)](https://github.com/johanzandstra "johanzandstra (1 commits)")

---

Tags

craft3craftcmsgoogle-mapspluginplugingooglecmsyii2mapsyiilocationCraftcraftcmscraft-pluginpickerlocation-pickercraft3

### Embed Badge

![Health badge](/badges/dolphiq-craft3-locationpicker/health.svg)

```
[![Health](https://phpackages.com/badges/dolphiq-craft3-locationpicker/health.svg)](https://phpackages.com/packages/dolphiq-craft3-locationpicker)
```

###  Alternatives

[nfourtythree/entriessubset

Craft field type plugin that extends the core Entries field type to give extra settings with ability to restrict by entry type

1683.0k](/packages/nfourtythree-entriessubset)

PHPackages © 2026

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