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:

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