ALIAS: maps/{mapname}
Example of USA Chart:
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 |
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 |
<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 |