The MapLocation FieldType

Written by Ricardo Correia Updated 05/23/2014 by Petar Spanja

This field type represents a geographical location.

Name	Internal name	Expected input
MapLocation	ezgmaplocation	mixed

Table of contents:

Description

This FieldType makes possible to store and retrieve a geographical location.

As input it expects two float values, latitude, longitude, and a string value in third place, corresponding to the name or address of the location.

Type	Example
array	array( 'latitude' => 59.928732, 'longitude' => 10.777888, 'address' => "eZ Systems Norge" )

The Value class of this field type contains the following properties:

Property	Type	Description
$latitude	float	This property will store the latitude value of the map location reference.
$longitude	float	This property will store the longitude value of the map location reference.
$address	string	This property will store the address of map location.

The MapLocation\Value constructor will initialize a new Value object with the values provided. Two floats and a string are expected.

Constructor example

The template called by the ez_render_field() Twig function while rendering a Map Location field accepts the following the parameters:

Parameter	Type	Default	Description
mapType	string	"ROADMAP"	One of the GMap type of map
showMap	boolean	true	Whether to show a Google Map
showInfo	booolean	true	Whether to show a latitude, longitude and the address outside of the map
zoom	integer	13	The initial zoom level on the map
draggable	boolean	true	Whether to enable draggable map
width	string\|false	"500px"	The width of the rendered map with its unit (ie "500px" or "50em"), set to false to not set any width style inline.
height	string\|false	"200px"	The height of the rendered map with its unit (ie "200px" or "20em"), set to false to not set any height style inline.