Description
The cfmapitem tag is a child tag of the cfmap tag. This tag creates markers on the map. You can specify the marker in a map using either the cfmapitem tag or using the ColdFusion.Map.AddMapMarker JavaScript API. See ColdFusion.Map.addMarker for details.
Category
Syntax
<cfmapitem address="address" latitude="latitude in degrees" longitude="longitude in degrees" markercolor="marker color" markericon="icon path " markerwindowcontent="content" name="name of the map" showmarkerwinodw="true|false" showUser="true|false" tip="marker tip" />
See also
History
ColdFusion 10: Added the attribute {{showUser}}
ColdFusion 9: Added this tag.
Attributes
Attribute |
Req/Opt |
Default |
Description |
|
|---|---|---|---|---|
address |
Required, if latitude and longitude are not specified |
|
The address of the location to set the map marker. |
|
latitude |
Required, if address is not specified |
|
The latitude value for the marker, in degrees. The valid values for latitude are -90 to + 90. |
|
longitude |
Required, if address is not specified |
|
The longitude value for the marker, in degrees. The valid values for longitude are -180 to + 180. |
|
markercolor |
Optional |
green |
The color of the marker specified as a hexadecimal value. By default, the centermarker is green in color. |
|
markericon |
Optional |
|
Location of an image file to use as the marker icon. The attributes markericon and markercolor are mutually exclusive. |
|
markerwindowcontent |
Optional |
|
Static content displayed in the marker window. This attribute ignores the markerbind attribute defined in the tag cfmap. |
|
name |
Optional |
|
The name of the map. |
|
|
Optional |
Inherits parent cfmap setting |
If set to true, displays the marker window. If the attribute markerbind is used, unless you set this attribute to true, the marker window is not displayed. |
|
|
Optional |
false |
If set to true, on HTML-compliant browsers, user location is shown on the map. |
|
tip |
Optional |
|
A short description of the marker location that appears as a tool tip. |
Usage
This tag must be used within the cfmap tag.
The following inheritance rules apply:
- The value specified for the attribute showmarkerwindow in the cfmap tag is inherited by all cfmapitem tags.
- A child cfmapitem tag can override the attribute showmarkerwindow in the cfmap tag by changing the value.
- Any bind expression defined using the markerbind is ignored if the cfmapitem tag defines the attribute markerwindowcontent.
Examples
<h3>cfmapitem example using latitude and longitude attributes</h3> <cfmap name="gmap01" centerlatitude="71.094224" centerlongitude="42.339641" doubleclickzoom="true" overview="true" scrollwheelzoom="true" showscale="true" tip="My Map" zoomlevel="4"> <cfmapitem name="marker01" latitude="70.50" longitude="42.50" tip="New marker"/>
<h3>cfmap Example using address address</h3> <cfmap name="gmap02" centerlatitude="71.094224" centerlongitude="42.339641" doubleclickzoom="true" overview="true" scrollwheelzoom="true" showscale="true" tip="My Map" zoomlevel="4"> <cfmapitem name="marker02" address="345 Park Avenue, san jose, CA 95110-2704, USA" tip="New marker"/>
Sign in to your account