Gmaps (Google Maps) Services

Introduction

Gmaps Services extend the Gmaps module with the Services/API methods from Google Maps.

It brings the following features to the maps

And it bring the following tags to EE

Installation

Prerequisites

Make sure your system meets the minimum requirements:

Installation Instructions

Update instructions

Important notes

Direction/Route

Return multi-part directions for a series of waypoints. Directions for several modes of transportation are available.

The tag

{exp:gmaps_services:direction}

Tag parameters

Below are the Tag Parameters. Those parameters can be used in the tag described above.

address:from

A from address name, can also a name like 'reichenbach im vogtland or amsterdam or america'.

address:from="" [REQUIRED] if latlng:from is empty

latlng:from

latitude longitude coordinates

latlng:from="" [REQUIRED] if address:from is empty

address:to

A to address name, can also a name like 'reichenbach im vogtland or amsterdam or america'.

address:to="" [REQUIRED] if latlng:to is empty

latlng:to

latitude longitude coordinates

latlng:to="" [REQUIRED] if address:to is empty

address:stops

stops between the from and to point. addresses seperated with a pipline '|'

address:stops="" [OPTIONAL] if latlng:stops is empty

latlng:stops

stops between the from and to point. latitude longitude coordinates seperated with a pipline '|'

latlng:stops="" [OPTIONAL] if address:stops is empty

stops_as_via

By default the stop locations are set to route via. By setting this param to no you can have multiple routes to the stop locations

stops_as_via="yes" [OPTIONAL]

travel_mode

set the travel mode.
values: driving walking bicycling walking

travel_mode="driving" [OPTIONAL]

avoid

values: tolls highways ferries
You can use multiple options seperated with a pipline (|)

travel_mode="driving" [OPTIONAL]

lang

Set the language based on the language code https://developers.google.com/maps/faq#languagesupport

lang="en" [OPTIONAL]

Tag variables

Below are the Tag variables. (note the prefix directions:)

direction:distance:text

The distance in normal language

{direction:distance:text}

direction:distance:value

The distance in meters

{direction:distance:value}

direction:duration:text

The duration/time in normal language

{direction:duration:text}

direction:duration:value

The duration/time in seconds

{direction:duration:value}

direction:start_address

The start address

{direction:start_address}

direction:start_address:latlng

The start address latlng coordinate

{direction:start_address:latlng}

direction:end_address

The end address

{direction:end_address}

direction:end_address:latlng

The end address latlng coordinate

{direction:end_address:latlng}

direction:steps

The steps pair tag hold all the steps to on the route

{direction:steps}...{/direction:steps}

direction:steps:distance:text

The distance in normal language

{direction:steps}
    {direction:steps:distance:text}
{/direction:steps}

direction:steps:distance:value

The distance in meters

{direction:steps}
    {direction:steps:distance:value}
{/direction:steps}

direction:steps:duration:text

The duration/time in normal language

{direction:steps}
    {direction:steps:duration:text}
{/direction:steps}

direction:steps:duration:value

The duration/time in seconds

{direction:steps}
    {direction:steps:duration:value}
{/direction:steps}

direction:steps:start_address:latlng

The start address latlng coordinate

{direction:steps}   
    {direction:steps:start_address:latlng}
{/direction:steps}

direction:steps:end_address:latlng

The end address latlng coordinate

{direction:steps}
    {direction:steps:end_address:latlng}
{/direction:steps}

direction:steps:instruction

Formatted HTML instructions of the step

{direction:steps}   
    {direction:steps:instruction}
{/direction:steps}

direction:steps:travel_mode

The travel mode

{direction:steps}
    {direction:steps:travel_mode}
{/direction:steps}

Distance Matrix

Retrieve duration and distance values based on the recommended route between start and end points.

The tag

{exp:gmaps_services:distance_matrix}

Tag parameters

Below are the Tag Parameters. Those parameters can be used in the tag described above.

address:from

A from address name, can also a name like 'reichenbach im vogtland or amsterdam or america'.

address:from="" [REQUIRED] if latlng:from is empty

latlng:from

latitude longitude coordinates

latlng:from="" [REQUIRED] if address:from is empty

address:to

A to address name, can also a name like 'reichenbach im vogtland or amsterdam or america'.

address:to="" [REQUIRED] if latlng:to is empty

latlng:to

latitude longitude coordinates

latlng:to="" [REQUIRED] if address:to is empty

travel_mode

set the travel mode.
values: driving walking bicycling walking

travel_mode="driving" [OPTIONAL]

avoid

values: tolls highways ferries
You can use multiple options seperated with a pipline (|)

travel_mode="driving" [OPTIONAL]

units

values: metric imperial

units="metric" [OPTIONAL]

lang

Set the language based on the language code https://developers.google.com/maps/faq#languagesupport

lang="en" [OPTIONAL]

Tag variables

Below are the Tag variables. (note the prefix distance_matrix:)

distance_matrix:destination_address

The destination address

{distance_matrix:destination_address}

distance_matrix:origin_address

The origin address

{distance_matrix:start_address:latlng}

distance_matrix:distance:text

The distance in normal language

{distance_matrix:distance:text}

distance_matrix:distance:value

The distance in meters

{distance_matrix:distance:value}

distance_matrix:duration:text

The duration/time in normal language

{distance_matrix:duration:text}

distance_matrix:duration:value

The duration/time in seconds

{distance_matrix:duration:value}

Elevation

The Tag Elevation provides elevation data for all locations on the surface of the earth, including depth locations on the ocean floor (which return negative values).

The tag

{exp:gmaps_services:elevation}

Tag parameters

Below are the Tag Parameters. Those parameters can be used in the tag described above.

address

A from address name, can also a name like 'reichenbach im vogtland or amsterdam or america'.

address="" [REQUIRED] if latlng is empty

latlng

latitude longitude coordinates

latlng="" [REQUIRED] if address is empty

Tag variables

Below are the Tag variables. (note the prefix elevation:)

elevation:lat

The latitude

{elevation:lat}

elevation:lng

The Longitude

{elevation:lng}

elevation:elevation

The elevation in meters

{elevation:elevation}

Places

Get data from the same database used by Google Maps and Google+ Local. Places features more than 100 million businesses and points of interest that are updated frequently through owner-verified listings and user-moderated contributions.

The tag

{exp:gmaps_services:places}

Tag parameters

Below are the Tag Parameters. Those parameters can be used in the tag described above.

address

A from address name, can also a name like 'reichenbach im vogtland or amsterdam or america'.

address=""

latlng

latitude longitude coordinates

latlng=""

search_types

the type of a places. Multiple seperated with a pipeline '|'

valid types are listed here

search_types="" [REQUIRED]

search_keyword

keyword for a places.

search_keyword="" [OPTIONAL]

radius

set the radius in meters.

radius="1000" [OPTIONAL]

lang

Set the language based on the language code https://developers.google.com/maps/faq#languagesupport

lang="en" [OPTIONAL]

type

Set the search type. (radar search goes up to 200 results)

Options: search radar_search

type="search" [OPTIONAL]

Tag variables

Below are the Tag variables. (note the prefix places:)

lat

The latitude

{places:lat}

lng

The longitude

{places:lng}

latlng

The latlng coordinates together

{places:latlng}

icon

The icon

{places:icon}

name

The name

{places:name}

vicinity

The vicinity

{places:vicinity}

photos

The photos

{places:photos}
    {places:height}
    {places:width}
    {places:url}
{/places:photos}

types

The types

{places:types}
    {name}
{/places:types}

Timezone

The TimeZone tag provides time offset data for locations on the surface of the earth. You request the time zone information for a specific address/latlng and date. The Tag returns the name of that time zone, the time offset from UTC, and the daylight savings offset.

Require to enable the Timezone API in your Google Console account

The tag

{exp:gmaps_services:timezone}

Tag parameters

Below are the Tag Parameters. Those parameters can be used in the tag described above.

address

A from address name, can also a name like 'reichenbach im vogtland or amsterdam or america'.

address="" [REQUIRED] if latlng is empty

latlng

latitude longitude coordinates

latlng="" [REQUIRED] if address is empty

timestamp

The timestamp

timestamp="time()"

Tag variables

Below are the Tag variables. (note the prefix timezone:)

timezone:dst_offset

the offset for daylight-savings time in seconds. This will be zero if the time zone is not in Daylight Savings Time during the specified timestamp.

{timezone:dst_offset}

timezone:raw_offset

the offset from UTC (in seconds) for the given location. This does not take into effect daylight savings.

{timezone:offset}

timezone:time_zone_id

a string containing the ID of the time zone, such as "America/Los_Angeles" or "Australia/Sydney".

{timezone:time_zone_id}

timezone:time_zone_name

Ta string containing the long form name of the time zone. This field will be localized if the language parameter is set. eg. "Pacific Daylight Time" or "Australian Eastern Daylight Time"

{timezone:time_zone_name}

Changelog

2.0.0 (04-12-2017)

1.0.3 (09-10-2017)

1.0.2 (24-04-2017)

1.0.1 (07-04-2017)

1.0.0 (28-03-2017)