General

  eZ Systems Website
  Technical documentation
  Editor documentation

This Documentation contains:
 
Technical documentation:



⚠ WARNING ! This documentation is deprecated !

Please go to the current Technical Documentation

Skip to end of metadata
Go to start of metadata

This Field Type represents a geographical location.

NameInternal nameExpected input
MapLocationezgmaplocationmixed

Table of contents:

Description

This Field Type 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.

Input expectations

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

Value object

Properties

The Value class of this Field Type contains the following properties:

PropertyTypeDescription
$latitude floatThis property will store the latitude value of the map location reference.
$longitude
floatThis property will store the longitude value of the map location reference.
$addressstringThis property will store the address of map location.

Constructor

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

Constructor example

Parameters accepted by ez_render_field Twig function

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

ParameterTypeDefaultDescription
mapTypestring"ROADMAP"One of the GMap type of map
showMapbooleantrueWhether to show a Google Map
showInfoboooleantrueWhether to show a latitude, longitude and the address outside of the map
zoominteger13The initial zoom level on the map
draggablebooleantrue

Whether to enable draggable map

widthstring|false"500px"

The width of the rendered map with its unit (for example "500px" or "50em"), set to false to not set any width style inline.

heightstring|false"200px"

The height of the rendered map with its unit (for example "200px" or "20em"), set to false to not set any height style inline.

Example: