net.sf.jasperreports.components.map.MapComponent Maven / Gradle / Ivy
The newest version!
/*
* JasperReports - Free Java Reporting Library.
* Copyright (C) 2001 - 2023 Cloud Software Group, Inc. All rights reserved.
* http://www.jaspersoft.com
*
* Unless you have purchased a commercial license agreement from Jaspersoft,
* the following license terms apply:
*
* This program is part of JasperReports.
*
* JasperReports is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* JasperReports is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with JasperReports. If not, see .
*/
package net.sf.jasperreports.components.map;
import java.util.List;
import net.sf.jasperreports.annotations.properties.Property;
import net.sf.jasperreports.annotations.properties.PropertyScope;
import net.sf.jasperreports.components.items.Item;
import net.sf.jasperreports.components.items.ItemData;
import net.sf.jasperreports.components.map.type.MapImageTypeEnum;
import net.sf.jasperreports.components.map.type.MapScaleEnum;
import net.sf.jasperreports.components.map.type.MapTypeEnum;
import net.sf.jasperreports.engine.JRCloneable;
import net.sf.jasperreports.engine.JRExpression;
import net.sf.jasperreports.engine.JRGenericElementType;
import net.sf.jasperreports.engine.JRPropertiesUtil;
import net.sf.jasperreports.engine.component.Component;
import net.sf.jasperreports.engine.type.EvaluationTimeEnum;
import net.sf.jasperreports.engine.type.OnErrorTypeEnum;
import net.sf.jasperreports.engine.xml.JRXmlConstants;
import net.sf.jasperreports.properties.PropertyConstants;
/**
* The Map component interface.
*
* @author Teodor Danciu ([email protected])
*/
public interface MapComponent extends Component, JRCloneable
{
// properties at report element level:
public static final String PROPERTY_PREFIX = JRPropertiesUtil.PROPERTY_PREFIX + "components.map.";
@Property(
category = PropertyConstants.CATEGORY_MAP,
scopes = {PropertyScope.CONTEXT, PropertyScope.REPORT},
sinceVersion = PropertyConstants.VERSION_5_5_0
)
public static final String PROPERTY_KEY = PROPERTY_PREFIX + "key";
@Property(
category = PropertyConstants.CATEGORY_MAP,
scopes = {PropertyScope.CONTEXT, PropertyScope.REPORT},
sinceVersion = PropertyConstants.VERSION_5_5_0
)
public static final String PROPERTY_CLIENT_ID = PROPERTY_PREFIX + "client.id";
@Property(
category = PropertyConstants.CATEGORY_MAP,
scopes = {PropertyScope.CONTEXT, PropertyScope.REPORT},
sinceVersion = PropertyConstants.VERSION_5_5_0
)
public static final String PROPERTY_SIGNATURE = PROPERTY_PREFIX + "signature";
/**
* @deprecated Replaced by #PROPERTY_GOOGLE_VERSION.
*/
public static final String PROPERTY_VERSION = PROPERTY_PREFIX + "version";
@Property(
category = PropertyConstants.CATEGORY_MAP,
scopes = {PropertyScope.CONTEXT, PropertyScope.REPORT},
sinceVersion = PropertyConstants.VERSION_6_4_3
)
public static final String PROPERTY_GOOGLE_VERSION = PROPERTY_PREFIX + "google.version";
@Property(
category = PropertyConstants.CATEGORY_MAP,
scopes = {PropertyScope.CONTEXT, PropertyScope.REPORT},
sinceVersion = PropertyConstants.VERSION_6_20_1
)
public static final String PROPERTY_DEFAULT_MARKER_ICON = PROPERTY_PREFIX + "default.marker.icon";
// map attributes:
/**
* The attribute that provides the map type. Possible values are:
*
* - roadmap (default)
* - satellite
* - terrain
* - hybrid
*
*/
public static final String ATTRIBUTE_MAP_TYPE = "mapType";
/**
* Applies to static maps only. This attribute specifies the behavior of the engine when the
* image is not available. Possible values are:
*
* - Error (default)
* - Blank
* - Icon
*
*/
public static final String ATTRIBUTE_ON_ERROR_TYPE = "onErrorType";
/**
* Numeric (positive integer) attribute that provides the scale value used to return higher-resolution map images
* when working with high resolution screens available on mobile devices. Possible values are:
*
* - 1 (default)
* - 2
* - 4 (for Business customers only)
*
*/
public static final String ATTRIBUTE_MAP_SCALE = "mapScale";
/**
* This attribute represents the image format of the map. Possible values are:
*
* - png (default)
* - png8
* - png32
* - gif
* - jpg
* - jpg-baseline
*
*/
public static final String ATTRIBUTE_IMAGE_TYPE = "imageType";
/**
* boolean attribute that specifies whether to group markers into clusters or not; optional.
*/
public static final String ATTRIBUTE_MARKER_CLUSTERING = "markerClustering";
/**
* boolean attribute that specifies whether to "spider-ify" overlapping markers or not; optional.
*/
public static final String ATTRIBUTE_MARKER_SPIDERING = "markerSpidering";
// common item properties:
/**
* Numeric floating-point value representing the latitude of the place on the map;
* required if no equivalent {@link #ITEM_PROPERTY_address} is set.
*
* Applies to items in markerData
and pathData
.
*/
public static final String ITEM_PROPERTY_latitude = "latitude";
/**
* Numeric floating-point value representing the longitude of the place on the map;
* required if no equivalent {@link #ITEM_PROPERTY_address} is set.
*
* Applies to items in markerData
and pathData
.
*/
public static final String ITEM_PROPERTY_longitude = "longitude";
/**
* Specifies the address of a given point on the map.
*
* The address-based geo-location is considered only if no {@link #ITEM_PROPERTY_latitude}
* and {@link #ITEM_PROPERTY_longitude} properties are set.
*
* Applies to items in markerData
and pathData
.
*/
public static final String ITEM_PROPERTY_address = "address";
/**
* String value representing the name, as unique identifier.
*
* Applies to items in pathData
and pathStyle
. It is required for items in pathStyle
* and optional for items in pathData
. Default name for items in pathData
is {@link #DEFAULT_PATH_NAME}.
*/
public static final String ITEM_PROPERTY_name = "name";
/**
* String value representing the name of a path style (in pathData
) or the name of the
* parent style (in pathStyle
); optional.
*
* Applies to items in pathData
and pathStyle
.
*
* If not provided, the path will be generated using Google default style settings for paths.
*/
public static final String ITEM_PROPERTY_style = "style";
/**
* boolean value that specifies if this item (marker or path) is clickable; optional. Default value is true.
*
* Applies to items in markerData
and pathStyle
.
*/
public static final String ITEM_PROPERTY_clickable = "clickable";
/**
* boolean value that specifies if this item (marker or path) is draggable; optional. Default value is false.
*
* Applies to items in markerData
and pathStyle
.
*/
public static final String ITEM_PROPERTY_draggable = "draggable";
/**
* boolean value that specifies if this item (marker or path) is visible on the map; optional. Default value is true.
*
* Applies to items in markerData
and pathStyle
.
*/
public static final String ITEM_PROPERTY_visible = "visible";
/**
* Integer value representing the z index of this item (marker or path); optional.
*
* Applies to items in markerData
and pathStyle
.
*/
public static final String ITEM_PROPERTY_MARKER_zIndex = "zIndex";
// item properties for markerData:
/**
* String value representing the tooltip for the marker icon; optional.
*/
public static final String ITEM_PROPERTY_MARKER_title = "title";
/**
* String value representing a link to a page or document that will be open when the marker is clicked on; optional.
* @see #ITEM_PROPERTY_MARKER_INFOWINDOW_content
*/
public static final String ITEM_PROPERTY_MARKER_url = "url";
/**
* String value representing the hyperlink target for the marker; optional.
*
* Allowed values are:
*
* - _blank (default)
* - _parent
* - _self
* - _top
* - a valid window/frame name
*
*/
public static final String ITEM_PROPERTY_MARKER_target = "target";
/**
* Optional String value representing the color for the default pin icons. This property is taken
* into account when {@link #ITEM_PROPERTY_MARKER_ICON_url} property is not set. Its value may represent:
*
*
* - one of the predefined color names in the following list (see also ColorEnum):
*
* - black
* - blue
* - cyan
* - darkGray
* - gray
* - green
* - lightGray
* - magenta
* - orange
* - pink
* - red(default)
* - yellow
* - white
*
*
* - a valid color hex code (prefixed by #). For instance: #0000FF.
* - the color RGB value.
*
*/
public static final String ITEM_PROPERTY_MARKER_color = "color";
/**
* String value representing the label for the default pin icons; optional. This property is taken into account
* when {@link #ITEM_PROPERTY_MARKER_ICON_url} property is not set.
*/
public static final String ITEM_PROPERTY_MARKER_label = "label";
/**
* String value representing the cursor value; optional.
*/
public static final String ITEM_PROPERTY_MARKER_cursor = "cursor";
/**
* Predefined String value representing the default marker icon size; optional.
*
* This property is considered for static maps only. Allowed values are:
*
* - mid
* - tiny
* - small
*
*/
public static final String ITEM_PROPERTY_MARKER_size = "size";
/**
* boolean value that specifies if the marker icon is flat; optional.
*/
public static final String ITEM_PROPERTY_MARKER_flat = "flat";
/**
* boolean value that specifies if the marker icon is optimized; optional.
*/
public static final String ITEM_PROPERTY_MARKER_optimized = "optimized";
/**
* boolean value to be applied for the raiseOnDrag property; optional.
*/
public static final String ITEM_PROPERTY_MARKER_raiseOnDrag = "raiseOnDrag";
// marker icon properties
/**
* String value representing the URL where the marker icon is loaded from; optional.
*
* This property is overridden by the {@link #ITEM_PROPERTY_MARKER_ICON_url} property value.
*/
public static final String ITEM_PROPERTY_MARKER_icon = "icon";
/**
* String value representing the URL where the marker icon is loaded from; optional.
*
* When is set, it overrides the value of {@link #ITEM_PROPERTY_MARKER_icon} property.
*
* If not set, a default google pin icon will be loaded.
*/
public static final String ITEM_PROPERTY_MARKER_ICON_url = "icon.url";
/**
* Integer value representing the icon width, in pixels. To be considered,
* {@link #ITEM_PROPERTY_MARKER_ICON_height} must be also set.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_ICON_width = "icon.width";
/**
* Integer value representing the icon height, in pixels. To be considered,
* {@link #ITEM_PROPERTY_MARKER_ICON_width} must be also set.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_ICON_height = "icon.height";
/**
* Integer value representing the horizontal position of the marker icon within a sprite,
* if any, in pixels. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_ICON_ORIGIN_x = "icon.origin.x";
/**
* Integer value representing the vertical position of the marker icon within a sprite, if any,
* in pixels. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_ICON_ORIGIN_y = "icon.origin.y";
/**
* Integer value representing the horizontal position to anchor the marker icon with respect to the
* location of the marker on the map. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_ICON_ANCHOR_x = "icon.anchor.x";
/**
* Integer value representing the vertical position to anchor the marker icon with respect to the
* location of the marker on the map. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_ICON_ANCHOR_y = "icon.anchor.y";
// marker shadow properties
/**
* String value representing the URL where the custom marker shadow icon is loaded from; optional.
*
* This property is overridden by {@link #ITEM_PROPERTY_MARKER_SHADOW_url}.
*/
public static final String ITEM_PROPERTY_MARKER_shadow = "shadow";
/**
* String value representing the URL where the custom marker shadow icon is loaded from; optional.
*
* When is set, it overrides the value of the {@link #ITEM_PROPERTY_MARKER_shadow} property.
*/
public static final String ITEM_PROPERTY_MARKER_SHADOW_url = "shadow.url";
/**
* Integer value representing the shadow icon width, in pixels. To be considered,
* {@link #ITEM_PROPERTY_MARKER_SHADOW_height} must be also set.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_SHADOW_width = "shadow.width";
/**
* Integer value representing the shadow icon height, in pixels. To be considered,
* {@link #ITEM_PROPERTY_MARKER_SHADOW_width} must be also set.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_SHADOW_height = "shadow.height";
/**
* Integer value representing the horizontal position of the shadow icon within a sprite,
* if any, in pixels. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_SHADOW_ORIGIN_x = "shadow.origin.x";
/**
* Integer value representing the vertical position of the shadow icon within a sprite, if any,
* in pixels. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_SHADOW_ORIGIN_y = "shadow.origin.y";
/**
* Integer value representing the horizontal position to anchor the shadow icon with respect to the
* location of the marker on the map. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_SHADOW_ANCHOR_x = "shadow.anchor.x";
/**
* Integer value representing the vertical position to anchor the shadow icon with respect to the
* location of the marker on the map. Default value is 0.
*
* This property is optional.
*/
public static final String ITEM_PROPERTY_MARKER_SHADOW_ANCHOR_y = "shadow.anchor.y";
// marker infowindow properties
/**
* String value representing the content to be displayed in an info window; optional. Empty contents are not processed.
* When a marker icon is clicked on the map, additional information can be displayed either in a separate
* window/frame or in an info window floating above the map.
*
* If both {@link #ITEM_PROPERTY_MARKER_url} and info window settings are present in a marker definition, the info window takes precedence
* over the marker URL. Clicking on the marker icon will open the info window.
* @see #ITEM_PROPERTY_MARKER_url
*/
public static final String ITEM_PROPERTY_MARKER_INFOWINDOW_content = "infowindow.content";
/**
* Optional integer value representing the offset (in pixels) from the tip of the info window to the location
* on which the info window is anchored. Default value is 0.
*/
public static final String ITEM_PROPERTY_MARKER_INFOWINDOW_pixelOffset = "infowindow.pixelOffset";
/**
* Optional integer value representing the maximum width in pixels of the info window.
*/
public static final String ITEM_PROPERTY_MARKER_INFOWINDOW_maxWidth = "infowindow.maxWidth";
/**
* Optional floating-point value representing the latitude used to determine the info window position on the map.
* Neglected for info windows attached to markers.
*/
public static final String ITEM_PROPERTY_MARKER_INFOWINDOW_latitude = "infowindow.latitude";
/**
* Optional floating-point value representing the longitude used to determine the info window position on the map.
* Neglected for info windows attached to markers.
*/
public static final String ITEM_PROPERTY_MARKER_INFOWINDOW_longitude = "infowindow.longitude";
// item properties for pathData:
// see the common item properties that can be applied for items in pathData.
// item properties for pathStyle:
/**
* Flag that specifies whether the path is a polygon; optional.
*
* Default value: false.
*/
public static final String ITEM_PROPERTY_STYLE_isPolygon = "isPolygon";
/**
* Numeric integer value representing the stroke weight; optional.
*/
public static final String ITEM_PROPERTY_STYLE_strokeWeight = "strokeWeight";
/**
* The color of the stroke; optional. Can be represented as #-prefixed HTML color code or as predefined HTML color name
*/
public static final String ITEM_PROPERTY_STYLE_strokeColor = "strokeColor";
/**
* Numeric floating-point value in [0..1] representing the opacity of the path stroke; optional.
*/
public static final String ITEM_PROPERTY_STYLE_strokeOpacity = "strokeOpacity";
/**
* String value representing the color of the fill; optional.
*
* Can be represented as #-prefixed HTML color code or as predefined HTML color name
*/
public static final String ITEM_PROPERTY_STYLE_fillColor = "fillColor";
/**
* Numeric floating-point value in [0..1] representing the opacity of the path fill; optional.
*/
public static final String ITEM_PROPERTY_STYLE_fillOpacity = "fillOpacity";
/**
* Flag that specifies if the path is editable; optional.
*/
public static final String ITEM_PROPERTY_STYLE_editable = "editable";
/**
* Flag that specifies if the path is geodesic; optional.
*/
public static final String ITEM_PROPERTY_STYLE_geodesic = "geodesic";
// legend and resetMap control properties
/**
* Legend or resetMap item property with value of {@link java.lang.Boolean} or boolean {@link java.lang.String} that specifies if the legend or the resetMap is enabled
*
* Configurable individually for each legend or resetMap item
*
* Defaults to false
or "false"
*/
public static final String LEGEND_OR_RESET_MAP_PROPERTY_enabled = "enabled";
/**
* Legend or resetMap item property with value of type {@link net.sf.jasperreports.components.map.fill.CustomMapControlPositionEnum CustomMapControlPositionEnum}
*
* For {@link #ELEMENT_LEGEND_ITEM legendItem} it defaults to {@link net.sf.jasperreports.components.map.fill.CustomMapControlPositionEnum#RIGHT_CENTER CustomMapControlPositionEnum.RIGHT_CENTER}
*
* For {@link #ELEMENT_RESET_MAP_ITEM resetMapItem} it defaults to {@link net.sf.jasperreports.components.map.fill.CustomMapControlPositionEnum#RIGHT_TOP CustomMapControlPositionEnum.RIGHT_TOP}
*/
public static final String LEGEND_OR_RESET_MAP_PROPERTY_position = "position";
/**
* Legend or resetMap item property with value of type {@link java.lang.String} that specifies the label
*
* For {@link #ELEMENT_LEGEND_ITEM} it defaults to "Legend"
*
* For {@link #ELEMENT_RESET_MAP_ITEM} it defaults to "Reset map"
*/
public static final String LEGEND_OR_RESET_MAP_PROPERTY_label = "label";
// legend properties
/**
* Legend item property with value of type {@link net.sf.jasperreports.components.map.fill.CustomMapControlOrientationEnum CustomMapControlOrientationEnum}
*
* Defaults to {@link net.sf.jasperreports.components.map.fill.CustomMapControlOrientationEnum#VERTICAL VERTICAL}
*/
public static final String LEGEND_PROPERTY_orientation = "orientation";
/**
* Legend item property with value of type {@link java.lang.String} that specifies the legend maximum width in pixels when in non-fullscreen mode
*
* Defaults to "100px"
*/
public static final String LEGEND_PROPERTY_legendMaxWidth = "legendMaxWidth";
/**
* Legend item property with value of type {@link java.lang.String} that specifies the legend maximum width in pixels when in fullscreen mode
*
* Defaults to "150px"
*/
public static final String LEGEND_PROPERTY_legendMaxWidth_fullscreen = "legendMaxWidth.fullscreen";
/**
* Legend item property with value of type {@link java.lang.String} that specifies the legend maximum height in pixels when in non-fullscreen mode
*
* Defaults to "150px"
*/
public static final String LEGEND_PROPERTY_legendMaxHeight = "legendMaxHeight";
/**
* Legend item property with value of type {@link java.lang.String} that specifies the legend maximum height in pixels when in fullscreen mode
*
* Defaults to "300px"
*/
public static final String LEGEND_PROPERTY_legendMaxHeight_fullscreen = "legendMaxHeight.fullscreen";
/**
* Legend item property with value of {@link java.lang.Boolean} or boolean {@link java.lang.String} that specifies if the legend series should use marker icons or not
*
* Defaults to true
or "true"
*/
public static final String LEGEND_PROPERTY_useMarkerIcons = "useMarkerIcons";
// map elements
public static final String ELEMENT_MARKER_DATA = "markerData";
public static final String ELEMENT_LEGEND_ITEM = "legendItem";
public static final String ELEMENT_RESET_MAP_ITEM = "resetMapItem";
public static final String ELEMENT_PATH_STYLE = "pathStyle";
public static final String ELEMENT_PATH_DATA = "pathData";
// generic element parameters:
/**
* The name of map generic elements.
*/
public static final String MAP_ELEMENT_NAME = "map";
/**
* The qualified type of map generic elements.
*/
public static final JRGenericElementType MAP_ELEMENT_TYPE =
new JRGenericElementType(JRXmlConstants.JASPERREPORTS_NAMESPACE, MAP_ELEMENT_NAME);
/**
* The name of the parameter that provides the onErrorType attribute.
*/
public static final String PARAMETER_ON_ERROR_TYPE = "onErrorType";
/**
* The name of the parameter that provides the list of marker objects for the map.
*/
public static final String PARAMETER_MARKERS = "markers";
public static final String PARAMETER_LEGEND_PROPERTIES = "legendProperties";
public static final String PARAMETER_RESET_MAP_PROPERTIES = "resetMapProperties";
/**
* The name of the parameter that provides the map language.
*/
public static final String PARAMETER_LANGUAGE = "language";
/**
* The name of the parameter that provides the zoom factor.
*/
public static final String PARAMETER_ZOOM = "zoom";
/**
* The cached image renderer.
*/
public static final String PARAMETER_CACHE_RENDERER = "cacheRenderer";
/**
* The name of the parameter that provides the Google API map request parameters.
*/
public static final String PARAMETER_REQ_PARAMS = "reqParams";
/**
* The name of the flag parameter that specifies paths on the map
*/
public static final String PARAMETER_PATHS = "paths";
/**
* The name of the parameter that provides the path locations.
*/
public static final String PARAMETER_PATH_LOCATIONS = "locations";
public static final String PARAMETER_DEFAULT_MARKER_ICON = "defaultMarkerIcon";
// map defaults:
public static final Float DEFAULT_LATITUDE = 0f;
public static final Float DEFAULT_LONGITUDE = 0f;
public static final Integer DEFAULT_ZOOM = 0;
public static final MapTypeEnum DEFAULT_MAP_TYPE = MapTypeEnum.ROADMAP;
public static final OnErrorTypeEnum DEFAULT_ON_ERROR_TYPE = OnErrorTypeEnum.ERROR;
public static final String DEFAULT_PATH_NAME = "DEFAULT_PATH_NAME";
/**
* Returns a {@link net.sf.jasperreports.engine.JRExpression JRExpression}
* representing the latitude coordinate of the map center
*
* @return the latitude expression
*/
JRExpression getLatitudeExpression();
/**
* Returns a {@link net.sf.jasperreports.engine.JRExpression JRExpression}
* representing the longitude coordinate of the map center
*
* @return the longitude expression
*/
JRExpression getLongitudeExpression();
/**
* Returns a {@link net.sf.jasperreports.engine.JRExpression 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
*
* @return the address expression
*/
JRExpression getAddressExpression();
/**
* Returns a numeric expression
* representing the zoom factor of the map.
*
* @return the zoom expression
*/
JRExpression getZoomExpression();
/**
* Returns a {@link net.sf.jasperreports.engine.JRExpression JRExpression}
* representing the language for the labels on the map.
*
* @return the language expression
*/
JRExpression getLanguageExpression();
/**
* Returns the evaluation time of the map component element
*
* @return the evaluation time
*/
EvaluationTimeEnum getEvaluationTime();
/**
* Returns the evaluation group name for the map component element
*
* @return the evaluation group
*/
String getEvaluationGroup();
/**
* Returns the type of the Google map. Possible values are:
*
* - {@link net.sf.jasperreports.components.map.type.MapTypeEnum#ROADMAP ROADMAP} (default value)
* - {@link net.sf.jasperreports.components.map.type.MapTypeEnum#SATELLITE SATELLITE}
* - {@link net.sf.jasperreports.components.map.type.MapTypeEnum#TERRAIN TERRAIN}
* - {@link net.sf.jasperreports.components.map.type.MapTypeEnum#HYBRID HYBRID}
*
* @return the type of the Google map
* @see net.sf.jasperreports.components.map.type.MapTypeEnum
*/
MapTypeEnum getMapType();
/**
* 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)
*
* @return the scale factor
*/
MapScaleEnum getMapScale();
/**
* Returns the image format of the map. Possible values are:
*
* - {@link net.sf.jasperreports.components.map.type.MapImageTypeEnum#PNG PNG} (default value)
* - {@link net.sf.jasperreports.components.map.type.MapImageTypeEnum#PNG_8 PNG_8}
* - {@link net.sf.jasperreports.components.map.type.MapImageTypeEnum#PNG_32 PNG_32}
* - {@link net.sf.jasperreports.components.map.type.MapImageTypeEnum#GIF GIF}
* - {@link net.sf.jasperreports.components.map.type.MapImageTypeEnum#JPG JPG}
* - {@link net.sf.jasperreports.components.map.type.MapImageTypeEnum#JPG_BASELINE JPG_BASELINE}
*
* @return the image format of the map
* @see net.sf.jasperreports.components.map.type.MapImageTypeEnum
*/
MapImageTypeEnum getImageType();
/**
* Returns an attribute that customizes the way the engine handles a missing map image
* during report generation. Possible values are:
*
* - {@link net.sf.jasperreports.engine.type.OnErrorTypeEnum#ERROR ERROR} (default value)
* - {@link net.sf.jasperreports.engine.type.OnErrorTypeEnum#BLANK BLANK}
* - {@link net.sf.jasperreports.engine.type.OnErrorTypeEnum#ICON ICON}
*
* @return the onErrorType attribute
* @see net.sf.jasperreports.engine.type.OnErrorTypeEnum
*/
OnErrorTypeEnum getOnErrorType();
/**
* @return the {@link #ATTRIBUTE_MARKER_CLUSTERING} attribute
*/
Boolean getMarkerClustering();
/**
* @return the {@link #ATTRIBUTE_MARKER_SPIDERING} attribute
*/
Boolean getMarkerSpidering();
/**
* Returns a list of {@link MarkerItemData MarkerItemData} objects
* representing collections of markers on the map
*
* @return a list of marker data
* @see ItemData
*/
List getMarkerItemDataList();
/**
* @deprecated Replaced by {@link #getMarkerItemDataList()}.
*/
List getMarkerDataList();
Item getLegendItem();
Item getResetMapItem();
/**
* Returns a list of {@link ItemData ItemData} objects
* representing collections of path styles for the map
*
* @return a list of path styles
* @see ItemData
*/
List getPathStyleList();
/**
* Returns a list of {@link ItemData ItemData} objects
* representing collections of paths on the map
*
* @return a list of path data
* @see ItemData
*/
List getPathDataList();
/**
* @deprecated Replaced by {@link #getMarkerDataList()}.
*/
ItemData getMarkerData();
/**
* @deprecated Replaced by {@link #getMarkerDataList()}.
*/
MarkerDataset getMarkerDataset();
}