nthmedia/entry-gps-coordinates

Entry GPS Coordinates plugin for Craft CMS

2.4.1 2026-03-17 21:30 UTC

Requires

• php: ^8.0
• craftcms/cms: ^4.0.0 || ^5.0.0

Requires (Dev)

• craftcms/ecs: dev-main
• craftcms/rector: dev-main
• phpstan/phpstan: ^1.6

proprietary

• NTH media

• map
• location
• coordinate
• gps
• coordinates
• latitude
• longitude
• lat
• lng
• gps coordinates

README

Pick a GPS location for an entry. Supports multiple instances on a single page, including inside Neo and Matrix fields.

Installation

1. Open your terminal and go to your Craft project and tell Composer to install the plugin:

composer require nthmedia/entry-gps-coordinates

1. Activate the plugin through the command line or via Settings → Plugins in the Control Panel:

./craft install/plugin entry-gps-coordinates

1. Add a Coordinates field under Settings → Fields and add it to a section under Settings → Sections.

Configuration

The field has four settings:

Setting	Description
Google API Key	Required. Supports environment variables.
Default Zoom Level	Number between 1 and 20. Default: 13.
Default Center Coordinates	Coordinates in lat,lng format. Default: Amsterdam.
Geocoding language	Language code for stored address data (e.g. en, de, nl, fr). Determines the language of saved fields like address, country, and locality. Default: en. The map interface language is set automatically based on the logged-in user's language.

Usage in Twig

{{ entry.fieldName | searchQuery }}    {# Van Gogh Museum #}
{{ entry.fieldName | coordinates }}    {# 52.3584159,4.8810756 #}
{{ entry.fieldName | latitude }}       {# 52.3584159 #}
{{ entry.fieldName | longitude }}      {# 4.8810756 #}
{{ entry.fieldName | zoomLevel }}      {# 13 #}
{{ entry.fieldName | address }}        {# Paulus Potterstraat 7, 1071 CX Amsterdam, Netherlands #}
{{ entry.fieldName | streetNumber }}   {# 7 #}
{{ entry.fieldName | route }}          {# Paulus Potterstraat #}
{{ entry.fieldName | locality }}       {# Amsterdam #}
{{ entry.fieldName | postalCode }}     {# 1071 CX #}
{{ entry.fieldName | country }}        {# Netherlands #}

GraphQL

All field values are available via GraphQL:

{
  entries {
    ... on YourSection_Entry {
      yourFieldName {
        searchQuery
        coordinates
        address
        streetNumber
        route
        locality
        postalCode
        country
        zoomLevel
      }
    }
  }
}

Google Cloud API

The following APIs need to be enabled in Google Cloud Console:

• Maps JavaScript API
• Places API
• Geocoding API