Map Attributes

ALIAS: maps/{mapname}

Example of USA Chart:

FusionCharts should load here..

JavaScript embedding code:

<script type="text/javascript">
FusionCharts.ready(function(){
    var myChart = new FusionCharts({
        "type": "usa",
        "dataFormat": "jsonurl",
        "dataSource": "chartdata.json"
        });
    });
</script>

Data for this chart:

...

Map Attributes

Functional Attributes

These attributes let you control a variety of functional elements on the map. For example, you can opt to show/hide data values, labels etc.

Name Type Range Description
showLabels Boolean 0/1 It sets the configuration whether the entity labels will be displayed or not.
includeNameInLabels Boolean 0/1 If you've opted to show map labels, this attributes lets you control whether to show entity names as a part of map labels?
includeValueInLabels Boolean 0/1 Whether to show entity values on the map as a part of map label?
useSNameInLabels Boolean 0/1 Whether to use the short name of entities in labels or full names?
useSNameInToolTip Boolean 0/1 Whether to use the short name of entities in tool-tip or full names?
showShadow Boolean 0/1 Whether to drop a shadow effect for the map?
caption String Allows you to add a caption of the map.
subCaption String Allows you to add a sub caption of the map.
captionPosition String top-left, top-right, bottom-left, bottom-right and top-center Allows you to set the position of the caption and sub caption. You can set the position these either on the top-left corner, top-right corner, bottom-left corner or on the bottom-right corner of the map. The default value is 'top-center'.
clickURL String The entire map can act as a hotspot. Use this URL to define the hotspot link for the map. The link can be specified in FusionCharts Link Format.
hoverOnEmpty Boolean 0/1 Whether to show tool tip for those entities whose value has not been defined in the XML data?
aboutMenuItemLabel String The menu item label for the custom context menu item.
entityLabelsOnTop Boolean 0/1 This attribute is used to show the entity labels above or below the markers in the maps. If 0, the entity-labels appear below the marker. By default, it is set to 1 and the entity-labels appear above the markers.

Map Cosmetics

These attributes let you configure map cosmetics like background color, background alpha, canvas color & alpha etc.

Name Type Range Description
showCanvasBorder Boolean 1/0 Whether to show a border around entire map object.
canvasBorderColor Color Hex Code If you've opted to show a border around entire map object, this attribute lets you control the color of the border.
canvasBorderThickness Number In Pixels If you've opted to show a border around entire map object, this attribute lets you control the thickness of the border in pixels.
canvasBorderAlpha Number 0-100 If you've opted to show a border around entire map object, this attribute lets you control the alpha of the border.
bgColor Color This attribute sets the background color for the map. You can set any hex color code as the value of this attribute.
bgAlpha Number 0-100 Sets the alpha (transparency) for the background.
bgRatio Number 0-100 If you've opted for a gradient background, this attribute lets you set the ratio of each color constituent.
bgAngle Number 0-360 Angle of the background color, in case of a gradient.
bgImage String To place any image as background of the map, enter the (path and) name of the image. It should be in the same domain as the map.
bgImageAlpha Number 0-100 Helps you specify alpha for the loaded background image.
bgImageDisplayMode String stretch, tile, fit, fill, center, none Helps you specify the mode in which the background image is to be displayed.Stretch - expands the image to fit the entire map area, without maintaining original image constraintsTile - the image is repeated as a pattern on the entire map areaFit - fits the image proportionately on the map areaFill -proportionately fills the entire map area with the imageCenter - the image is positioned at the center of the map areaNone - Default mode. None of the above modes are applied
bgImageVAlign String top, middle, bottom Helps you to vertically align the background image.
bgImageHAlign String left, middle, right Helps you to horizontally align the background image.
bgImageScale Number 0-300 Helps you magnify the background image. This attribute will only work when the attribute bgImageDisplayMode is set to none, center or tile.
logoURL String URL You can load an external logo (JPEG/PNG/SWF) on the map once it has rendered. This attribute lets you specify the URL of the same. Owing to Flash Player security settings, you can only specify logo that are on the sub-domain as the SWF file of the map.
logoPosition String TL, TR, BL, BR, CC Where to position the logo on the map:TL - Top-leftTR - Top-rightBR - Bottom rightBL - Bottom leftCC - Center of screen
logoAlpha Number 0-100 Once the logo has loaded on the map, you can configure its opacity using this atribute.
logoScale Number 0-300 You can also change the scale of externally loaded logo at run-time by specifying a value for this parameter.
logoLink String URL If you want to link the logo to an external URL, specify the link in this attribute. The link can be in FusionCharts Link Format, allowing you to link to new windows, pop-ups, frames etc.

Entity Cosmetics

These attributes let you configure how your entities will appear on the map.

Name Type Range Description
borderColor Color Hex Code Border Color for map entities
borderAlpha Number 0-100 Border alpha for map entities
fillColor Color Hex Code Default fill color to use for entities, if no color range has been specified.
fillAlpha Alpha 0-100 Alpha to be used for filling entities.
useHoverColor Boolean 0/1 Whether to use hover color for the map. If set to yes, whenever the end user hovers his mouse over a map entity, it will change its color to the color defined in attribute below.
hoverColor Color Hex Code When the end user hovers his mouse over any map entity, it changes its color. Using this attribute you can define that color.
showBorder Boolean 0/1 Whether the common entity border will be displayed or not. Default value is 1.
nullEntityColor Color Hex Code The default color for any map entity whose values are not provided in map data.
nullEntityAlpha Number 0-100 The default opacity of any map entity whose values are not provided in map data.
showEntityToolTip Boolean 0/1 Whether to show or hide tooltip for all entities present in a map. The default value is 1.
labelConnectorColor Hex code Specifies the color of the static label connector. This attribute is used when you want to explicitly define the color of the label connector. If not set, the label connector color is taken from connectorColor attribute.
labelConnectorAlpha Number 0-100 Specifies the transparency of the static label connector. This attribute is used when you want to explicitly define the transparency of the label connector. If not set, the label connector alpha is taken from connectorAlpha attribute.

Number Formatting Properties

FusionCharts XT offers you a lot of options to format your numbers on the chart.

Using the attributes below, you can control a myriad of options like:

  • Formatting of commas and decimals
  • Number prefixes and suffixes
  • Decimal places to which the numbers will round to
  • Scaling of numbers based on a user defined scale
  • Custom number input formats

These attributes let you appropriately format the numbers displayed on the chart.

Name Type Range Description
formatNumber Boolean 0/1 This configuration determines whether the numbers displayed on the map will be formatted using commas, e.g., 40,000 if formatNumber='1' and 40000 if formatNumber='0'
decimals Number 0-10 Number of decimal places to which all numbers on the map will be rounded to.
forceDecimals Boolean 0/1 Whether to add 0 padding at the end of decimal numbers. For example, If you limit the maximum number of decimal digits to 2, a number like 55.345 will be rounded to 55.34. This does not mean that all numbers will be displayed with a fixed number of decimal places. For instance 55 will not be displayed as 55.00 and 55.1 will not become 55.10. In order to have fixed number of decimal places attached to all the numbers, set this attribute to 1.
numberPrefix String Character Using this attribute, you could add prefix to all the numbers visible on the map. For example, to represent all dollars figure on the map, you could specify this attribute to ' $' to show like $40000, $50000. For more details, please see Advanced Number Formatting section.
numberSuffix String Character Using this attribute, you could add suffix to all the numbers visible on the map. For example, to represent all figure quantified as per annum on the map, you could specify this attribute to ' /a' to show like 40000/a, 50000/a. For more details, please see Advanced Number Formatting section.
decimalSeparator String Character This option helps you specify the character to be used as the decimal separator in a number. For more details, please see Advanced Number Formatting section.
thousandSeparator String Character This option helps you specify the character to be used as the thousands separator in a number. For more details, please see Advanced Number Formatting section.
thousandSeparatorPosition List of comma separated Numbers This option helps you specify the position of the thousand separator. For more details, read this.
inDecimalSeparator String Character In some countries, commas are used as decimal separators and dots as thousand separators. In XML, if you specify such values, it will give a error while converting to number. So, FusionMaps XT accepts the input decimal and thousand separator from user, so that it can convert it accordingly into the required format. This attribute lets you input the decimal separator. For more details, please see Advanced Number Formatting section.
inThousandSeparator String Character In some countries, commas are used as decimal separators and dots as thousand separators. In XML, if you specify such values, it will give a error while converting to number. So, FusionMaps XT accepts the input decimal and thousand separator from user, so that it can convert it accordingly into the required format. This attribute lets you input the thousand separator. For more details, please see Advanced Number Formatting section.
formatNumberScale Boolean 0/1 Configuration whether to add K (thousands) and M (millions) to a number after truncating and rounding it - e.g., if formatNumberScale is set to 1, 1043 will become 1.04K (with decimals set to 2 places). Same with numbers in millions - an M will added at the end. For more details, please see Advanced Number Formatting section.
defaultNumberScale String The default unit of the numbers that you're providing to the map. For more details, please see Advanced Number Formatting section.
numberScaleUnit String Unit of each block of the scale. For more details, please see Advanced Number Formatting section.
numberScaleValue String range of the various blocks that constitute the scale. For more details, please see Advanced Number Formatting section.
scaleRecursively Boolean 0/1 Whether to scale the number recursively? For more details, read this.
maxScaleRecursion Number How many recursions to complete during recursive scaling? -1 completes the entire set of recursion.
scaleSeparator String What character to use to separate the scales that are generated after recursion?

Tooltips

These attributes let you control the tool tip. You can set the background color, border color, separator character and few other details.

Name Type Range Description
showToolTip Boolean 0/1 Whether to show tool tip on map? When this attribute is set to 0, all the tooltips including entity tooltips, marker toolitps and connector tooltips are disabled.
toolTipBgColor Color Background Color for tool tip.
toolTipBorderColor Color Border Color for tool tip.
toolTipSepChar String The character specified as the value of this attribute separates the name and value displayed in tool tip.
showToolTipShadow Boolean 0/1 Whether to show shadow for tool-tips on the map.

Font Properties

These attributes let you control the generic font properties for all the text on the map.

Name Type Range Description
baseFont String Font Name This attribute lets you set the font face (family) of all the text (data labels, values etc.) on map.
baseFontSize Number 0-72 This attribute sets the base font size of the map i.e., all the values and the names in the map which lie on the canvas will be displayed using the font size provided here.
baseFontColor Color This attribute sets the base font color of the map i.e., all the values and the names in the map which lie on the canvas will be displayed using the font color provided here.

Hover effects

You can show an effect on the elements of the map when the user hovers his mouse over an element using hover effects of maps.

These attributes let you configure the cosmetics of the hover for all data plots in the map.

Name Type Range Description
showHoverEffect Boolean 0 / 1 Lets you enable hover effect for entities and markers in the map
showEntityHoverEffect Boolean 0 / 1 Lets you enable hover effect just for entities on the map
showMarkerHoverEffect Boolean 0 / 1 Lets you enable hover effect just for makers on the map, if defined
showConnectorHoverEffect Boolean 0 / 1 Lets you enable hover effect just for connectors on the map, if defined
entityFillHoverColor Color Specifies the fill color for a map entity on hover
entityFillHoverAlpha Number 0 - 100 Specifies the alpha for a map entity on hover
entityFillHoverRatio Comma separatedNumbers Sums up to 100 Specifies the fill ratio for an map entity on hover
entityFillHoverAngle Number 0 - 360 Specifies the fill angle for a map entity on hover
entityBorderHoverThickness Number In Pixels Specifies the border thickness for a map entity on hover
markerFillHoverColor Color N/A Specifies the fill color for a map marker on hover
markerFillHoverAlpha Number 0 - 100 Specifies the fill alpha for a map marker on hover
markerFillHoverAngle Number 0 - 360 Specifies the fill angle for a map marker on hover
markerFillHoverRatio Comma separatedNumbers Sums up to 100 Specifies the fill ratio for a map marker on hover
markerBorderHoverThickness Number In Pixels Specifies the border thickness for a map marker on hover
markerBorderHoverColor Color Specifies the border color for a map marker on hover
markerBorderHoverAlpha Number(1 -100) In Pixels Specifies the border alpha for a map marker on hover
connectorHoverColor Color Specifies the fill color for a map connector on hover
connectorHoverThickness Number In Pixels Specifies the border thickness for a map connector on hover
connectorHoverAlpha Number 0 -100 Specifies the border alpha for a map connector on hover

Legend Properties

If you've defined color ranges, the color range names appear in a legend. You can place the legend at the bottom of the map or to the right of the map.

Also, using the attributes below, you can configure the functional and cosmetic properties of the legend.

These attributes let you configure legend properties in a map.

Name Type Range Description
showLegend Boolean 0/1 Whether to show legend for the map?
interactiveLegend Boolean 0/1 This attribute lets you interact with the legend in your map. When you click a legend item, the entities associated with that color range are hidden from the map. Re-clicking the legend item causes the entities to reappear.
legendAllowDrag Boolean 0/1 The legend can be made drag-able by setting this attribute to 1. End viewers of the map can drag the legend around on the map.
legendCaption String Lets you add a caption to your legend.
reverseLegend Boolean 0/1 You can reverse the ordering of the legend items in the legend by setting this attribute to 1.
legendPosition String BOTTOM or RIGHT The legend can be plotted at two positions on the map - below the map (BOTTOM) and on the RIGHT side of the map.
legendIconScale Number (0-5) Sets the magnification of legend icons. The default value is 1 which denotes 100% size.
legendShadow Boolean 0/1 Whether to show a shadow for legend?
legendBgColor Color Hex Code Background color for the legend.
legendBgAlpha Number 0-100 Background alpha for the legend.
legendBorderColor Color Hex Code Border Color for the legend.
legendBorderThickness Number In Pixels Border thickness for the legend.
legendBorderAlpha Number 0-100 Border alpha for the legend.
legendScrollBgColor Color Hex Code If you've too many items on the legend, a scroll bar shows up on the same. This attribute lets you configure the background color of the scroll bar.
legendScrollBarColor Color Hex Code If you've too many items on the legend, a scroll bar shows up on the same. This attribute lets you configure the bar color of the scroll bar.
legendScrollBtnColor Color Hex Code If you've too many items on the legend, a scroll bar shows up on the same. This attribute lets you configure the color of buttons of the scroll bar.
legendPointerWidth Number Allows you to set the width of the Gradient Legend pointers.
legendPointerHeight Number Allows you to set the height of the Gradient Legend pointers.
legendPointerBorderThickness Number Sets the border thickness of Gradient Legend pointers.
legendScaleLineColor Color Hex Code Sets the color of the line showing the numeric scale of Gradient Legend.
legendScaleLineAlpha Number 0-100 Sets the opacity of the line showing the numeric scale of Gradient Legend.
legendScaleLineThickness Number Sets the thickness of the line showing the numeric scale of Gradient Legend.

Marker Properties

Markers are custom defined points on the map, which help you pin-point locations like cities, houses, malls, junctions etc. Using the properties listed below, you can configure the various aspects of the markers.

Name Type Range Description
markerFont String Font Name This attribute sets the font face for all the defined marker labels. You can over-ride this using STYLES.
markerFontSize Number 0-72 This attribute sets the font size for all the defined marker labels on the map. You can over-ride this using STYLES.
markerFontColor Color This attribute sets the font color for all the defined marker labels on the map. You can over-ride this using STYLES.
showMarkerToolTip Boolean 0/1 Whether to show tool tips for the defined markers?
showMarkerLabels Boolean 0/1 You can opt to show/hide label for all the markers on the map using this attribute.
markerLabelPadding Number Pixels This attribute lets you set a global label padding between the marker icon and its label. You can later over-ride the label padding for each individual marker too.
markerBgColor Color This attribute lets you set a common background color for all the defined markers on the map. You can later over-ride individual marker colors by using SHAPE definitions.
markerBorderColor Color This attribute lets you set a common border color for all the defined markers on the map. You can later over-ride individual marker border colors by using SHAPE definitions.
markerRadius Number Pixels This attribute lets you set a common radius for all the defined markers on the map. You can later over-ride individual marker border colors by using SHAPE definitions.
connectorColor Color Hex Code Sets the color of the marker connectors. Also, if labelConnectorColor is not set in XML/JSON data, the same color is applied to the label connector lines (if any) on the map.
connectorAlpha Number 0-100 Sets the opacity of the marker connectors. Also, if labelConnectorAlpha is not set in XML/JSON data, the same opacity is applied to the label connector lines (if any) on the map.
showHoverEffect Boolean 0 / 1 Lets you enable hover effect for this specific entity
fillHoverColor Color Fll color for this specific marker on hover
fillHoverAlpha Number 0 - 100 Alpha for this specific marker on hover
fillHoverRatio Comma separatedNumbers Sums up to 100 Fill ratio for this specific marker on hover
fillHoverAngle Number 0 - 360 Fill angle for this specific marker on hover
borderHoverThickness Number In Pixels Border thickness for this specific marker on hover
borderHoverColor Color Border color for this specific marker on hover
borderHoverAlpha Number 0 - 100 Border alpha for this specific marker on hover
markerConnColor - deprecated Color Hex Code Sets the color of the marker connectors.This attribute is deprecated. Use connectorColor instead.
markerConnAlpha - deprecated Number 0-100 Sets the opacity of the marker connectorsThis attribute is deprecated. Use connectorAlpha instead.
connectorThickness or markerConnThickness - deprecated Number Pixels If you've defined any marker connectors, this attribute lets you set the thickness of all those connectors.
showConnectorToolTip Boolean 0/1 Whether to show or hide tooltip for all marker connectors present in a map. The default value is 1.
connectorDashed or markerConnDashed - deprecated Boolean 0/1 Whether the marker connector line should appear as dashed?
connectorDashLen or markerConnDashLen - deprecated Number Pixels If marker connector line is to appear as dash, this attribute lets you set the dash length of each part of dash.
connectorDashGap or markerConnDashGap - deprecated Number Pixels If marker connector line is to appear as dash, this attribute lets you set the dash gap of each part of dash.
autoScaleMarkers Boolean 0/1 This attribute lets you to scale the markers automatically with respect to the map dimensions. By default, this attribute is set to 0.
markerFillColor Color 0/1 Using this attribute, you can specify the fill color for the marker shape (hex code without #). If you specify a comma separated list of hex codes (without #), FusionMaps XT will use those colors to form a gradient.
markerFillAlpha Number 0-100 Used to specify the fill alpha. In case of gradients, you'll need to specify a comma separated list of alpha.
markerFillRatio Number 0-100 If you're using gradient fills for the marker, this attribute lets you set the ratio (on a scale of 0-100) for the gradient component colors.
markerFillAngle Number 0-360 If you're using gradient fills for the marker, this attribute lets you set the angle for the gradient.
markerBorderAlpha Number 0-100 Border alpha for the marker shape.

Map Padding & Margins

These attributes let you configure map margins and paddings.

Name Type Range Description
legendPadding Number In Pixels Padding of legend from right/bottom side of map
chartLeftMargin Number In Pixels Amount of empty space that you want to put on the left side of your map. Nothing is rendered in this space.
chartRightMargin Number In Pixels Amount of empty space that you want to put on the right side of your map. Nothing is rendered in this space.
chartTopMargin Number In Pixels Amount of empty space that you want to put on the top of your map. Nothing is rendered in this space.
chartBottomMargin Number In Pixels Amount of empty space that you want to put on the bottom of your map. Nothing is rendered in this space.

Attributes to allow exporting of map as image/PDF

These attributes let you to control the saving of map as image.

Name Type Range Description
exportEnabled or imageSaveURL- deprecated Boolean (0/1) Whether the map will allow exporting to images/PDFs?
exportShowMenuItem Boolean (0/1) Whether the menu items related to export (e.g., Save as JPEG etc.) will appear in the context menu of map.
exportFormats String Lets you configure what output formats to allow for export of map, in the export context menu, and also customize the label for each menu item. The attribute value should be a pipe (|) delimited separated key-value pair. Example: exportFormat=‘PNG=Export as High Quality Image|JPG|PDF=Export as PDF File
exportHandler String In case of server side exporting, this refers to the path of the server-side export handler (the ready-to-use scripts that we provide).In case of client-side exporting, this refers to the DOM-Id of FusionCharts Export component that is embedded in your web page, along with the map.
exportAction String 'save' or 'download' In case of server-side exporting, the action specifies whether the exported image will be sent back to client as download, or whether it'll be saved on the server.
exportTargetWindow String '_self' or '_blank' In case of server-side exporting and when using download as action, this lefts you configure whether the return image/PDF will open in same window (as an attachment for download), or whether it will open in a new window.
exportCallback String Name of JavaScript function that'll be called back when export process has finished in case of:Client side exportBatch exportServer-side export using 'save' as action
exportFileName String Using this attribute you can specify the name (excluding the extension) of the output (export) file.

Attributes for <data> ... <entity> element

The <entity> element under <data> element is used to declare properties of the various entities on the map. Each <entity> element under the <data> element can have the different functional and cosmetic attributes.

These attributes let you configure <data> ... <entity> element.

Name Type Range Description
value Number Numeric value of the .
displayValue String If you want to display your custom value for each entity (apart from it's long name, short name or value), you can specify it here.
toolText String Lets you specify a custom tool text for the entity.
color Color Hex Code Lets you specify a custom color for the entity. If color range is defined, each entity takes its color from the range it belongs to. However, if you need to force a color for an entity (over-riding the range value), you can specify the hex code here.
alpha Number 0-100 Custom alpha (transparency) for the entity
link String If you want to link the entity to a URL, you can specify the URL in FusionCharts format. The link can open in same window, new window, pop-up, frames or as JavaScript functions.Please see the section `Drill Down Maps` to learn more about this.
font String If you want the label of this particular entity to appear in a different font (other from the one defined in STYLES/map element), specify the font face here.
fontSize String If you want the label of this particular entity to appear in a different font size (other from the one defined in STYLES/map element), specify the font size here.
fontColor Boolean 0/1 If you want the label of this particular entity to appear in a different font color (other from the one defined in STYLES/map element), specify the font color here.
fontBold Boolean 0/1 If you want the label of this particular entity to appear bold (other from the one defined in STYLES/map element), set this as 1.
showLabel Boolean 0/1 Whether to show the label for this entity? This attribute over-rides the value specified for showLabels attribute for element.
showToolTip Boolean 0/1 Whether to show tooltip for the entity. Default value is 1.
labelConnectorColor Hex code Sets a color to the label connector line (if any).
labelConnectorAlpha Number 0-100 Specifies the transparency of the label connector line (if any).
useHoverColor Boolean 0/1 Whether to show hover color when user hovers mouse over entity. Set this attribute to 0 to disable hover color.

<colorRange> element

The <colorRange> element within the <map> element helps to distinguish various entities based on their data. Essentially, the <colorRange> element is used to contain the various range definitions.

These attribute let you configure the <colorRange> element.

Name Type Range Description
gradient Boolean 0/1 Whether to show Gradient Legend. Default value is 0.
minValue Number Sets the minimum value or the lower limit of the numeric range and Gradient Legend.
code Color Hex Code Specifies the starting color of the lower limit of Gradient Legend.
alpha Number 0-100 Starting opacity of Gradient Legend. Default value is 100.
startLabel String Specifies the label for the lower limit of Gradient Legend.
endLabel String Specifies the label for the upper limit of Gradient Legend.

<markers> element

FusionMaps XT allows user-defined markers on the map. Markers are points that you can define anywhere on the map to represent various locations like cities, junctions, houses, office locations, malls or any other entity that needs a point representation. All data pertinent to markers are defined within the <markers> element under <map> element. The <markers> element may contain the sub-elements <definition> and <appilcation>.

<marker> ... <definition> element

The <definition> element is used to contain the definitions of the various elements. The <definition> tag contains a series of <marker> tags which define the individual markers.

These attributes let you configure <marker> ... <definition> element.

<marker> ... <definition> ... <marker> element

These attribute let you configure <marker> ... <data> ... <marker> element

Name Type Range Description
id Alphanumeric Gives an ID to the marker, to which it can be referred to in JavaScript API.
shapeId String Using this attribute, you can set the shape that this marker will assume on the map already defined.
x Number Relative X-position of the marker.
y Number Relative Y-position of the marker.
label String You can over-ride the labels for each marker during its application. This label will over-ride the label specified during definition.
labelPos String LEFT, RIGHT, CENTER, TOP, BOTTOM Like label, you can also over-ride the label position for each marker during its application.
toolText String If you need to provide custom tool text for a marker, you can do so using this attribute.
link String If you need your marker to link to other pages, when clicked, define the link here. The link can open in same window, new window, pop-up, frames, throw events etc. Please see `Drill Down Maps` section for more information on link format.
scale Number 0-5 If you're using the same shape (shapeId) to represent multiple markers on the map, you can have them differ in size using this attribute. This attributes set the scaling of a particular marker. Valid values are floating numbers between 0 and 5.
radius number In pixels In case of arc, circle or polygon, this attribute lets you set the radius of the same. The value of the radius attribute in element overrides the value of this attribute.

<marker> ... <shapes> ... <shapes> element

The <shapes> element is used to declare custom shapes.

These attributes let you configure <marker> ... <shapes> ... <shapes> element

Name Type Range Description
id Alphanumeric Each shape needs to be given a unique Id. During application, you'll directly refer to the ID of each shape to plot it on the map.
type String CIRCLE, ARC, POLYGON, IMAGE type specifies what kind of shape the marker will draw as. Valid values are circle, arc, polygon or image. So, if you want to create a pentagon, select polygon for this attribute and then later set sides to 5.
url String URL If you're using an image marker shape, you necessarily need to specify it's URL. FusionMaps XT can load GIF, JPEG and PNG files from the same sub-domain only (owing to cross browser security restrictions).
sides Number 3-20 If you've opted to plot a polygon shaped marker, you can specify the number of sides the polygon will have, using this attribute. Valid values are 3-20.
alpha Number 0-100 This attribute lets you configure the alpha of the entire marker.
labelPadding Number In Pixels This attribute lets you set the distance (in pixels) between your marker shape and the marker label.
fillColor Color In Pixels Using this attribute, you can specify the fill color for the marker shape (hex code without #). If you specify a comma separated list of hex codes (without #), FusionMaps XT will use those colors to form a gradient.
fillAlpha Number 0-100 Used to specify the fill alpha. In case of gradients, you'll need to specify a comma separated list of alpha.
fillRatio Number 0-100 If you're using gradient fills for the marker, this attribute lets you set the ratio (on a scale of 0-100) for the gradient component colors.
fillAngle Number 0-360 If you're using gradient fills for the marker, this attribute lets you set the angle for the gradient.
fillPattern String LINEAR, RADIAL If you're using gradient fills for the marker, this attribute lets you set the pattern for gradient - valid values are `linear` or `radial`.
showBorder Boolean 0/1 Whether to show border for the marker shape?
borderColor Color Hex Code Border color for the marker shape.
borderThickness Number In Pixels Border thickness for the marker shape.
borderAlpha Number 0-100 Border alpha for the marker shape.
radius Number In Pixels In case of arc, circle or polygon, this attribute lets you set the radius of the same.
innerRadius Number In Pixels In case of arc, this attribute lets you set the inner radius of the same.
startAngle Number 0-360 In case of arc or polygon, this attribute lets you set the starting draw angle.
endAngle Number 0-360 In case of arc, this attribute lets you set the ending draw angle.
xScale Number 0-1000 This attribute lets you dynamically re-scale the x-scale of your images after they've been loaded. Valid range is 0-1000.
yScale Number 0-1000 This attribute lets you dynamically re-scale the y-scale of your images after they've been loaded. Valid range is 0-1000.
vAlign String TOP, MIDDLE, BOTTOM When using an image marker, you can specify how the image will vertically align with respect to the marker's y position using this attribute. Valid values are `top`, `middle` and `bottom`. For markers which are simple icons, you can use the middle vertical align. In that case, the image will vertically be at the center position of the marker. However, if you've an image icon like a pin-point or a needle with its pointer faced downwards, you'll need to set the vertical alignment position to `top`, so that the pointer exactly points to the given marker location. Horizontally, the images are always aligned centrally.

<marker> ... <connector> ... <connector> element

The <connector> element is used to connect two different marker points on the map.

These attributes let you configure <marker> ... <connector> ... <connector> element

Name Type Range Description
from String Id of the marker from where the connector will start.
to String Id of the marker where the connector will end.
link String Each connector can also link to an external URL. For this attribute, you can specify the link for the connector in FusionCharts Link format.
label String Each connector can have a visible text label. This attribute lets you set the text.
toolText String If you want to set a custom tool text for the connectors, this attribute lets you do so.
thickness Number 0-10 Thickness of the connector line.
color Color Hex Code Color of the connector line.
alpha Number 0-100 Alpha (transparency) of the connector line.
dashed Boolean 0/1 Whether the connector line should appear as dashed?
dashLen Number 0-10 If the connector line is to appear as dashed, this attribute defines the length of each dashed line.
dashGap Number 0-10 If the connector line is to appear as dashed, this attribute defines the gap between each dashed line.
showHoverEffect Boolean 0 / 1 Lets you enable hover effect for this specific connector
hoverColor Color Color for this specific connector on hover
hoverAlpha Number 0 - 100 Alpha for this specific connector on hover
hoverThickness Number In Pixels Border thickness for this specific connector on hover
showToolTip Boolean 0/1 Whether to show tooltip for the connector. Default value is 1.

<entityDef> element

FusionMaps XT allows you to re-define the IDs of all the entities of the map. Apart from re-defining identities, it can also re-define the short name and long name of each identity. These re-definitions are contained within the <entityDef> element.

These attributes let you configure <entityDef> element.

<entityDef> ... <entity> element

To re-define the marker, you need to create <entity> element under <entityDef> element. Each <entity> element under <entityDef> element can have numerous attributes.

These attributes let you configure <entityDef> ... <entity> element.

Name Type Range Description
internalId String The internal and default ID of any entity of the map.
newId String The new ID of any entity of the map which overrides the internal ID.
sName String The short descriptive name of an entity.
lName String The long descriptive name of an entity.
showHoverEffect Boolean 0 / 1 Lets you enable hover effect for this specific entity
borderHoverThickness Number In Pixels Border thickness for the specific entity on hover
fillHoverColor Color Fill color for the specific entity on hover
fillHoverAlpha Number 0 - 100 Alpha for the specific entity on hover
fillHoverRatio Comma separatedNumbers Sums up to 100 If hover color is defined as a gradient using, this attribute lets you specify the distribution of those colors in a ratio that should sum to 100
fillHoverAngle Number 0 - 360 Fill angle for the specific entity on hover