Package net.sf.jasperreports.components.map

Class StandardMapComponent

java.lang.Object

net.sf.jasperreports.components.map.StandardMapComponent

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, MapComponent, Component, JRChangeEventsSupport, JRCloneable

public class StandardMapComponent
extends java.lang.Object
implements MapComponent, java.io.Serializable, JRChangeEventsSupport

Author:

Teodor Danciu (teodord@users.sourceforge.net)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	PROPERTY_ADDRESS_EXPRESSION
static java.lang.String	PROPERTY_EVALUATION_GROUP
static java.lang.String	PROPERTY_EVALUATION_TIME
static java.lang.String	PROPERTY_IMAGE_TYPE
static java.lang.String	PROPERTY_LANGUAGE_EXPRESSION
static java.lang.String	PROPERTY_LATITUDE_EXPRESSION
static java.lang.String	PROPERTY_LEGEND
static java.lang.String	PROPERTY_LONGITUDE_EXPRESSION
static java.lang.String	PROPERTY_MAP_SCALE
static java.lang.String	PROPERTY_MAP_TYPE
static java.lang.String	PROPERTY_MARKER_CLUSTERING
static java.lang.String	PROPERTY_MARKER_DATA	Deprecated. Replaced by PROPERTY_MARKER_DATA_LIST.
static java.lang.String	PROPERTY_MARKER_DATA_LIST
static java.lang.String	PROPERTY_MARKER_DATASET	Deprecated. Replaced by PROPERTY_MARKER_DATA.
static java.lang.String	PROPERTY_MARKER_SPIDERING
static java.lang.String	PROPERTY_ON_ERROR_TYPE
static java.lang.String	PROPERTY_PATH_DATA_LIST
static java.lang.String	PROPERTY_PATH_STYLE_LIST
static java.lang.String	PROPERTY_RESET_MAP
static java.lang.String	PROPERTY_ZOOM_EXPRESSION

Fields inherited from interface net.sf.jasperreports.components.map.MapComponent

ATTRIBUTE_IMAGE_TYPE, ATTRIBUTE_MAP_SCALE, ATTRIBUTE_MAP_TYPE, ATTRIBUTE_MARKER_CLUSTERING, ATTRIBUTE_MARKER_SPIDERING, ATTRIBUTE_ON_ERROR_TYPE, DEFAULT_LATITUDE, DEFAULT_LONGITUDE, DEFAULT_MAP_TYPE, DEFAULT_ON_ERROR_TYPE, DEFAULT_PATH_NAME, DEFAULT_ZOOM, ELEMENT_LEGEND_ITEM, ELEMENT_MARKER_DATA, ELEMENT_PATH_DATA, ELEMENT_PATH_STYLE, ELEMENT_RESET_MAP_ITEM, ITEM_PROPERTY_address, ITEM_PROPERTY_clickable, ITEM_PROPERTY_draggable, ITEM_PROPERTY_latitude, ITEM_PROPERTY_longitude, ITEM_PROPERTY_MARKER_color, ITEM_PROPERTY_MARKER_cursor, ITEM_PROPERTY_MARKER_flat, ITEM_PROPERTY_MARKER_icon, ITEM_PROPERTY_MARKER_ICON_ANCHOR_x, ITEM_PROPERTY_MARKER_ICON_ANCHOR_y, ITEM_PROPERTY_MARKER_ICON_height, ITEM_PROPERTY_MARKER_ICON_ORIGIN_x, ITEM_PROPERTY_MARKER_ICON_ORIGIN_y, ITEM_PROPERTY_MARKER_ICON_url, ITEM_PROPERTY_MARKER_ICON_width, ITEM_PROPERTY_MARKER_INFOWINDOW_content, ITEM_PROPERTY_MARKER_INFOWINDOW_latitude, ITEM_PROPERTY_MARKER_INFOWINDOW_longitude, ITEM_PROPERTY_MARKER_INFOWINDOW_maxWidth, ITEM_PROPERTY_MARKER_INFOWINDOW_pixelOffset, ITEM_PROPERTY_MARKER_label, ITEM_PROPERTY_MARKER_optimized, ITEM_PROPERTY_MARKER_raiseOnDrag, ITEM_PROPERTY_MARKER_shadow, ITEM_PROPERTY_MARKER_SHADOW_ANCHOR_x, ITEM_PROPERTY_MARKER_SHADOW_ANCHOR_y, ITEM_PROPERTY_MARKER_SHADOW_height, ITEM_PROPERTY_MARKER_SHADOW_ORIGIN_x, ITEM_PROPERTY_MARKER_SHADOW_ORIGIN_y, ITEM_PROPERTY_MARKER_SHADOW_url, ITEM_PROPERTY_MARKER_SHADOW_width, ITEM_PROPERTY_MARKER_size, ITEM_PROPERTY_MARKER_target, ITEM_PROPERTY_MARKER_title, ITEM_PROPERTY_MARKER_url, ITEM_PROPERTY_MARKER_zIndex, ITEM_PROPERTY_name, ITEM_PROPERTY_style, ITEM_PROPERTY_STYLE_editable, ITEM_PROPERTY_STYLE_fillColor, ITEM_PROPERTY_STYLE_fillOpacity, ITEM_PROPERTY_STYLE_geodesic, ITEM_PROPERTY_STYLE_isPolygon, ITEM_PROPERTY_STYLE_strokeColor, ITEM_PROPERTY_STYLE_strokeOpacity, ITEM_PROPERTY_STYLE_strokeWeight, ITEM_PROPERTY_visible, LEGEND_OR_RESET_MAP_PROPERTY_enabled, LEGEND_OR_RESET_MAP_PROPERTY_label, LEGEND_OR_RESET_MAP_PROPERTY_position, LEGEND_PROPERTY_legendMaxHeight, LEGEND_PROPERTY_legendMaxHeight_fullscreen, LEGEND_PROPERTY_legendMaxWidth, LEGEND_PROPERTY_legendMaxWidth_fullscreen, LEGEND_PROPERTY_orientation, LEGEND_PROPERTY_useMarkerIcons, MAP_ELEMENT_NAME, MAP_ELEMENT_TYPE, PARAMETER_CACHE_RENDERER, PARAMETER_DEFAULT_MARKER_ICON, PARAMETER_LANGUAGE, PARAMETER_LEGEND_PROPERTIES, PARAMETER_MARKERS, PARAMETER_ON_ERROR_TYPE, PARAMETER_PATH_LOCATIONS, PARAMETER_PATHS, PARAMETER_REQ_PARAMS, PARAMETER_RESET_MAP_PROPERTIES, PARAMETER_ZOOM, PROPERTY_CLIENT_ID, PROPERTY_DEFAULT_MARKER_ICON, PROPERTY_GOOGLE_VERSION, PROPERTY_KEY, PROPERTY_PREFIX, PROPERTY_SIGNATURE, PROPERTY_VERSION

Constructor Summary

Constructors

Constructor	Description
StandardMapComponent()
StandardMapComponent(MapComponent map, JRBaseObjectFactory objectFactory)

Method Summary

Modifier and Type	Method	Description
void	addMarkerData(int index, ItemData markerData)	Deprecated. Replaced by addMarkerItemData(int, MarkerItemData).
void	addMarkerData(ItemData markerData)	Deprecated. Replaced by addMarkerItemData(MarkerItemData).
void	addMarkerItemData(int index, MarkerItemData markerData)
void	addMarkerItemData(MarkerItemData markerItemData)
void	addPathData(int index, ItemData pathData)
void	addPathData(ItemData pathData)
void	addPathStyle(int index, ItemData pathStyle)
void	addPathStyle(ItemData pathStyle)
java.lang.Object	clone()
JRExpression	getAddressExpression()	Returns a JRExpression representing the address of the map center.
java.lang.String	getEvaluationGroup()	Returns the evaluation group name for the map component element
EvaluationTimeEnum	getEvaluationTime()	Returns the evaluation time of the map component element
JRPropertyChangeSupport	getEventSupport()	Returns the property change support object for this instance.
MapImageTypeEnum	getImageType()	Returns the image format of the map.
JRExpression	getLanguageExpression()	Returns a JRExpression representing the language for the labels on the map.
JRExpression	getLatitudeExpression()	Returns a JRExpression representing the latitude coordinate of the map center
Item	getLegendItem()
JRExpression	getLongitudeExpression()	Returns a JRExpression representing the longitude coordinate of the map center
MapScaleEnum	getMapScale()	Returns the scale factor of the Google map used to return higher-resolution map images when working with high resolution screens available on mobile devices.
MapTypeEnum	getMapType()	Returns the type of the Google map.
java.lang.Boolean	getMarkerClustering()
ItemData	getMarkerData()	Deprecated. Replaced by getMarkerDataList().
java.util.List<ItemData>	getMarkerDataList()	Deprecated. Replaced by getMarkerItemDataList()
MarkerDataset	getMarkerDataset()	Deprecated. Replaced by getMarkerData().
java.util.List<MarkerItemData>	getMarkerItemDataList()	Returns a list of MarkerItemData objects representing collections of markers on the map
java.lang.Boolean	getMarkerSpidering()
OnErrorTypeEnum	getOnErrorType()	Returns an attribute that customizes the way the engine handles a missing map image during report generation.
java.util.List<ItemData>	getPathDataList()	Returns a list of ItemData objects representing collections of paths on the map
java.util.List<ItemData>	getPathStyleList()	Returns a list of ItemData objects representing collections of path styles for the map
Item	getResetMapItem()
JRExpression	getZoomExpression()	Returns a numeric expression representing the zoom factor of the map.
ItemData	removeMarkerData(ItemData markerData)	Deprecated. Replaced by removeMarkerItemData(MarkerItemData)
MarkerItemData	removeMarkerItemData(MarkerItemData markerItemData)
ItemData	removePathData(ItemData pathData)
ItemData	removePathStyle(ItemData pathStyle)
void	setAddressExpression(JRExpression addressExpression)
void	setEvaluationGroup(java.lang.String evaluationGroup)
void	setEvaluationTime(EvaluationTimeEnum evaluationTimeValue)
void	setImageType(MapImageTypeEnum imageType)
void	setLanguageExpression(JRExpression languageExpression)
void	setLatitudeExpression(JRExpression latitudeExpression)
void	setLegend(Item legend)
void	setLongitudeExpression(JRExpression longitudeExpression)
void	setMapScale(MapScaleEnum mapScale)
void	setMapType(MapTypeEnum mapType)
void	setMarkerClustering(java.lang.Boolean markerClustering)
void	setMarkerData(ItemData markerData)	Deprecated. Replaced by addMarkerData(ItemData).
void	setMarkerDataset(MarkerDataset markerDataset)	Deprecated. Replaced by setMarkerData(ItemData).
void	setMarkerSpidering(java.lang.Boolean markerSpidering)
void	setOnErrorType(OnErrorTypeEnum onErrorType)
void	setResetMap(Item resetMap)
void	setZoomExpression(JRExpression zoomExpression)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROPERTY_LATITUDE_EXPRESSION

public static final java.lang.String PROPERTY_LATITUDE_EXPRESSION

See Also:

Constant Field Values

PROPERTY_LONGITUDE_EXPRESSION

public static final java.lang.String PROPERTY_LONGITUDE_EXPRESSION

See Also:

Constant Field Values

PROPERTY_ADDRESS_EXPRESSION

public static final java.lang.String PROPERTY_ADDRESS_EXPRESSION

See Also:

Constant Field Values

PROPERTY_ZOOM_EXPRESSION

public static final java.lang.String PROPERTY_ZOOM_EXPRESSION

See Also:

Constant Field Values

PROPERTY_LANGUAGE_EXPRESSION

public static final java.lang.String PROPERTY_LANGUAGE_EXPRESSION

See Also:

Constant Field Values

PROPERTY_EVALUATION_TIME

public static final java.lang.String PROPERTY_EVALUATION_TIME

See Also:

Constant Field Values

PROPERTY_EVALUATION_GROUP

public static final java.lang.String PROPERTY_EVALUATION_GROUP

See Also:

Constant Field Values

PROPERTY_MAP_TYPE

public static final java.lang.String PROPERTY_MAP_TYPE

See Also:

Constant Field Values

PROPERTY_MAP_SCALE

public static final java.lang.String PROPERTY_MAP_SCALE

See Also:

Constant Field Values

PROPERTY_IMAGE_TYPE

public static final java.lang.String PROPERTY_IMAGE_TYPE

See Also:

Constant Field Values

PROPERTY_ON_ERROR_TYPE

public static final java.lang.String PROPERTY_ON_ERROR_TYPE

See Also:

Constant Field Values

PROPERTY_MARKER_CLUSTERING

public static final java.lang.String PROPERTY_MARKER_CLUSTERING

See Also:

Constant Field Values

PROPERTY_MARKER_SPIDERING

public static final java.lang.String PROPERTY_MARKER_SPIDERING

See Also:

Constant Field Values

PROPERTY_MARKER_DATA_LIST

public static final java.lang.String PROPERTY_MARKER_DATA_LIST

See Also:

Constant Field Values

PROPERTY_PATH_STYLE_LIST

public static final java.lang.String PROPERTY_PATH_STYLE_LIST

See Also:

Constant Field Values

PROPERTY_PATH_DATA_LIST

public static final java.lang.String PROPERTY_PATH_DATA_LIST

See Also:

Constant Field Values

PROPERTY_MARKER_DATASET

public static final java.lang.String PROPERTY_MARKER_DATASET

Deprecated.

Replaced by PROPERTY_MARKER_DATA.

See Also:

Constant Field Values

PROPERTY_MARKER_DATA

public static final java.lang.String PROPERTY_MARKER_DATA

Deprecated.

Replaced by PROPERTY_MARKER_DATA_LIST.

See Also:

Constant Field Values

PROPERTY_LEGEND

public static final java.lang.String PROPERTY_LEGEND

See Also:

Constant Field Values

PROPERTY_RESET_MAP

public static final java.lang.String PROPERTY_RESET_MAP

See Also:

Constant Field Values

Constructor Detail

StandardMapComponent

public StandardMapComponent()

StandardMapComponent

public StandardMapComponent(MapComponent map,
                            JRBaseObjectFactory objectFactory)

Method Detail

getLatitudeExpression

public JRExpression getLatitudeExpression()

Description copied from interface: MapComponent

Returns a JRExpression representing the latitude coordinate of the map center

Specified by:

getLatitudeExpression in interface MapComponent

Returns:

the latitude expression

setLatitudeExpression

public void setLatitudeExpression(JRExpression latitudeExpression)

getLongitudeExpression

public JRExpression getLongitudeExpression()

Description copied from interface: MapComponent

Returns a JRExpression representing the longitude coordinate of the map center

Specified by:

getLongitudeExpression in interface MapComponent

Returns:

the longitude expression

setLongitudeExpression

public void setLongitudeExpression(JRExpression longitudeExpression)

getAddressExpression

public JRExpression getAddressExpression()

Description copied from interface: MapComponent

Returns a JRExpression representing the address of the map center. If no latitude or longitude coordinates are provided, the address expression will be used to calculate these coordinates

Specified by:

getAddressExpression in interface MapComponent

Returns:

the address expression

setAddressExpression

public void setAddressExpression(JRExpression addressExpression)

getZoomExpression

public JRExpression getZoomExpression()

Description copied from interface: MapComponent

Returns a numeric expression representing the zoom factor of the map.

Specified by:

getZoomExpression in interface MapComponent

Returns:

the zoom expression

setZoomExpression

public void setZoomExpression(JRExpression zoomExpression)

getLanguageExpression

public JRExpression getLanguageExpression()

Description copied from interface: MapComponent

Returns a JRExpression representing the language for the labels on the map.

Specified by:

getLanguageExpression in interface MapComponent

Returns:

the language expression

setLanguageExpression

public void setLanguageExpression(JRExpression languageExpression)

getEvaluationTime

public EvaluationTimeEnum getEvaluationTime()

Description copied from interface: MapComponent

Returns the evaluation time of the map component element

Specified by:

getEvaluationTime in interface MapComponent

Returns:

the evaluation time

setEvaluationTime

public void setEvaluationTime(EvaluationTimeEnum evaluationTimeValue)

getEvaluationGroup

public java.lang.String getEvaluationGroup()

Description copied from interface: MapComponent

Returns the evaluation group name for the map component element

Specified by:

getEvaluationGroup in interface MapComponent

Returns:

the evaluation group

setEvaluationGroup

public void setEvaluationGroup(java.lang.String evaluationGroup)

getEventSupport

public JRPropertyChangeSupport getEventSupport()

Description copied from interface: JRChangeEventsSupport

Returns the property change support object for this instance.

Specified by:

getEventSupport in interface JRChangeEventsSupport

Returns:

the property change support object for this instance

clone

public java.lang.Object clone()

Specified by:

clone in interface JRCloneable

Overrides:

clone in class java.lang.Object

getMapType

public MapTypeEnum getMapType()

Description copied from interface: MapComponent

Returns the type of the Google map. Possible values are:

• ROADMAP (default value)
• SATELLITE
• TERRAIN
• HYBRID

Specified by:

getMapType in interface MapComponent

Returns:

the type of the Google map

See Also:

MapTypeEnum

setMapType

public void setMapType(MapTypeEnum mapType)

getMapScale

public MapScaleEnum getMapScale()

Description copied from interface: MapComponent

Returns the scale factor of the Google map used to return higher-resolution map images when working with high resolution screens available on mobile devices. Possible values are:

• 1 (default value)
• 2
• 4 (for Business customers only)

Specified by:

getMapScale in interface MapComponent

Returns:

the scale factor

setMapScale

public void setMapScale(MapScaleEnum mapScale)

getImageType

public MapImageTypeEnum getImageType()

Description copied from interface: MapComponent

Returns the image format of the map. Possible values are:

• PNG (default value)
• PNG_8
• PNG_32
• GIF
• JPG
• JPG_BASELINE

Specified by:

getImageType in interface MapComponent

Returns:

the image format of the map

See Also:

MapImageTypeEnum

setImageType

public void setImageType(MapImageTypeEnum imageType)

getMarkerData

public ItemData getMarkerData()

Deprecated.

Replaced by getMarkerDataList().

Specified by:

getMarkerData in interface MapComponent

setMarkerData

public void setMarkerData(ItemData markerData)

Deprecated.

Replaced by addMarkerData(ItemData).

getOnErrorType

public OnErrorTypeEnum getOnErrorType()

Description copied from interface: MapComponent

Returns an attribute that customizes the way the engine handles a missing map image during report generation. Possible values are:

• ERROR (default value)
• BLANK
• ICON

Specified by:

getOnErrorType in interface MapComponent

Returns:

the onErrorType attribute

See Also:

OnErrorTypeEnum

setOnErrorType

public void setOnErrorType(OnErrorTypeEnum onErrorType)

getMarkerClustering

public java.lang.Boolean getMarkerClustering()

Specified by:

getMarkerClustering in interface MapComponent

Returns:

the MapComponent.ATTRIBUTE_MARKER_CLUSTERING attribute

setMarkerClustering

public void setMarkerClustering(java.lang.Boolean markerClustering)

getMarkerSpidering

public java.lang.Boolean getMarkerSpidering()

Specified by:

getMarkerSpidering in interface MapComponent

Returns:

the MapComponent.ATTRIBUTE_MARKER_SPIDERING attribute

setMarkerSpidering

public void setMarkerSpidering(java.lang.Boolean markerSpidering)

getMarkerDataset

public MarkerDataset getMarkerDataset()

Deprecated.

Replaced by getMarkerData().

Specified by:

getMarkerDataset in interface MapComponent

setMarkerDataset

public void setMarkerDataset(MarkerDataset markerDataset)

Deprecated.

Replaced by setMarkerData(ItemData).

getPathStyleList

public java.util.List<ItemData> getPathStyleList()

Description copied from interface: MapComponent

Returns a list of ItemData objects representing collections of path styles for the map

Specified by:

getPathStyleList in interface MapComponent

Returns:

a list of path styles

See Also:

ItemData

addPathStyle

public void addPathStyle(ItemData pathStyle)

addPathStyle

public void addPathStyle(int index,
                         ItemData pathStyle)

removePathStyle

public ItemData removePathStyle(ItemData pathStyle)

getMarkerDataList

public java.util.List<ItemData> getMarkerDataList()

Deprecated.

Replaced by getMarkerItemDataList()

Specified by:

getMarkerDataList in interface MapComponent

getMarkerItemDataList

public java.util.List<MarkerItemData> getMarkerItemDataList()

Description copied from interface: MapComponent

Returns a list of MarkerItemData objects representing collections of markers on the map

Specified by:

getMarkerItemDataList in interface MapComponent

Returns:

a list of marker data

See Also:

ItemData

addMarkerData

public void addMarkerData(ItemData markerData)

Deprecated.

Replaced by addMarkerItemData(MarkerItemData).

addMarkerItemData

public void addMarkerItemData(MarkerItemData markerItemData)

addMarkerData

public void addMarkerData(int index,
                          ItemData markerData)

Deprecated.

Replaced by addMarkerItemData(int, MarkerItemData).

addMarkerItemData

public void addMarkerItemData(int index,
                              MarkerItemData markerData)

removeMarkerData

public ItemData removeMarkerData(ItemData markerData)

Deprecated.

Replaced by removeMarkerItemData(MarkerItemData)

removeMarkerItemData

public MarkerItemData removeMarkerItemData(MarkerItemData markerItemData)

getLegendItem

public Item getLegendItem()

Specified by:

getLegendItem in interface MapComponent

setLegend

public void setLegend(Item legend)

getResetMapItem

public Item getResetMapItem()

Specified by:

getResetMapItem in interface MapComponent

setResetMap

public void setResetMap(Item resetMap)

getPathDataList

public java.util.List<ItemData> getPathDataList()

Description copied from interface: MapComponent

Returns a list of ItemData objects representing collections of paths on the map

Specified by:

getPathDataList in interface MapComponent

Returns:

a list of path data

See Also:

ItemData

addPathData

public void addPathData(ItemData pathData)

addPathData

public void addPathData(int index,
                        ItemData pathData)

removePathData

public ItemData removePathData(ItemData pathData)