Marker

Marker

The acs:Marker control represents a marker in a map.

The marker's options can be customized using the acs:Parameters tag (see the Google Maps documentation for the available options).

A marker can be placed automatically after an address search; to do this, you must define the SearchParameters for the marker - which is a list of ids, usually of input and select controls, whose value will be sent to Google geocoding API when clicking on a MarkerSearchButton.

Inversely, a marker's position can determine an address; in this case, you must define the SearchResults for the marker - which is a list of ids, usually of input and select controls, whose value will be written after the Google geocoding API has retrieved an address for the marker's position.

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
label	Label used for the marker.
id	id attribute of the marker.
latitude	XPath attribute; id of the hidden input associated with the market that holds its latitude
longitude	XPath attribute; id of the hidden input associated with the market that holds its longitude
initLatitude	XPath attribute; latitude of the marker at initialization
initLongitude	XPath attribute; longitude of the marker at initialization
searchOnPositionChanged	XPath attribute; if SearchResults is defined, whether to search the address each time the marker is moved. Default: false

Child elements

Name	Description
acs:Parameters	Contains options for the marker.
acs:SearchParameters	Defines all the controls used to search the location of this marker
acs:SearchResults	Defines all the controls updated after an address search of the position of this marker

Parent elements

Element	Description
Markers	tag used to contains the markers of a Map

Examples

Copy

<acs:TextBox id="enr14" label="Address" init="{AGENDA/ADDRESS}"/>
<input type="hidden" name="country" id="country" value="France"/>
<acs:TextBox id="enr20" label="City" init="{AGENDA/CITY}"/>
<acs:Map id="mymap" longitude="{translate(AGENDA/LONGITUDE,',','.')}" latitude="{translate(AGENDA/LATITUDE,',','.')}">
  <acs:Parameters>
    <acs:Parameter name="zoom" value="6"/>
  </acs:Parameter>
  <acs:Markers>
    <acs:Marker id="mymarker" initLongitude="{translate(AGENDA/LONGITUDE,',','.')}" initLatitude="{translate(AGENDA/LATITUDE,',','.')}" longitude="enr21" latitude="enr22">
      <acs:SearchParameters>
        <acs:Parameter name="enr14" value=""/>
        <acs:Parameter name="enr20" value=""/>
        <acs:Parameter name="country" value=""/>
      </acs:SearchParameters>
    </acs:Marker>
  </acs:Markers>
</acs:Map>
<acs:MarkerSearchButton id="markersearch" mode="FromAddress" mapid="mymap" markerid="mymarker" text="Search the address on the map"/>