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

Documentation versions

Installation

Prerequisites

Make sure your system meets the minimum requirements:

Installation Instructions

Update instructions

Important notes

License

For every paid addon you need to validate your license in order to activate the module.

On a local environment, like *.dev *.local *.localhost *.test the license is valid for testing and building a new or existing sites. For every other domain, you need to have a valid license.

Process of validating

Once installed, you will asked to enter your license key. When you entered a valid license you can hit the "Save license" button. This will start validating your license and will redirect you to addons.reinos.nl to login into your account. You can also register a new account in this process.

Control panel overview

Once logged in, you are asked to use your current account or to login with another one.

Control panel overview

Using the current logged in account, the server will check all info related to your license and once valid, it will redirect you back to your site where you see either a success message or an error message.

Control panel overview

License field

This module is using a license field to check if the license for the module is valid or not. On addons.reinos.nl you can check your license and add your valid domains.

Control panel overview

In the Module CP you can enter then your license Control panel overview

When you enter a wrong license, the module will not work and it shows you an warning Control panel overview

Invalid license

Sometimes it happens that the license system says you have an invalid license. When this happens, make sure you have entered your domain url in your account, next to your license on addons.reinos.nl.

If this will not fix your license problem, please contact us on https://addons.reinos.nl/support

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.1.2 (09-06-2018)

2.1.0 (18-04-2018)

*Note: you need to add your license key and license email from addons.reinos.nl in order to validate your license and add a valid domain url in your license field on addons.reinos.nl/profile/licenses or the module will not work on a live site. Also make sure you have read the license section in the documentation

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)