When a map-id is passed, it tries to return (if available) the reference of the instance of the FusionCharts object.

This is same as the FusionCharts.items[] static array which also provides the reference of the map object.

var mapReference = FusionCharts("myMapId");

It is not recommended to use this function unless absolutely needed.

var chartHTMLReference = FusionCharts.getObjectReference("myMapId");

It can take an Object as parameter containing all map parameters. See, first example on right.

It can take linear string parameters (second example on right) as listed below:

1. swfUrl : Path to the map SWF file or type: JavaScript Map Alias (to render JavaScript map) as listed here
2. id : DOM id to be set to the map
3. width : Width of the map
4. height : Height of the map
5. renderAt : Container HTML element's (normally a DIV) Id or HTMLNode object where the chart will be rendered
6. dataSource : XML or JSON map data. It can be a URL for XML or JSON, it can be XML or JSON in string or it can be a JSON object
7. dataFormat : Defines the format of the dataSource.
   • It is xmlurl when data source is a URL to XML data
   • It is xml when the data source is an XML String
   • It is jsonurl when data source is a URL to JSON data
   • It is json when the data source is a JSON String or JSON object
8. otherParameters : It contains other map parameters. Click here to see detailed list of map parameters

Additionally, it can take a mixture of linear parameters and an Object parameter at the end. The linear parameters should be in order. You can pass any one or more (up to no. 7 in the list above) linear parameters before you can pass the Object parameter. See the third example on right.

NOTE: You must pass the values for swfUrl/type, dataSource and dataFormat to render a map. The map will fail to render if any one of these parameters are missing.

You may also pass an instance of FusionCharts object to it in order to render each FusionCharts object.

This function fires up the map rendering processes. Hence, a number of events are fired after this function call. The events are listed in sequence below:

• Initialize
• DataLoadRequested
• DataLoadRequestCompleted
• DataUpdated
• Loaded ( or FC_Loaded )
• DataLoaded ( or FC_DataLoaded )
• Rendered ( or FC_Rendered )
• DrawComplete

On various issues when map does not get rendered these error events are fired:

• DataLoadRequestCancelled
• DataLoadCancelled
• DataLoadError (FC_DataLoadError)
• DataXMLInvalid (FC_DataXMLInvalid)

var myMap = FusionCharts.render({ swfUrl : "Maps/FCMap_World.swf", id : "myMapId", renderAt : "mapContainer", dataSource : "Data.xml" })

or

var myMap = FusionCharts.render("Maps/FCMap_World.swf", "myMapId", "400", "300", "mapContainer", "Data.xml", "xmlurl");

or

var myMap = FusionCharts.render("Maps/FCMap_World.swf", "myMapId", "400", "300", "mapContainer", {dataFormat : "xmlurl", dataSource : "Data.xml" });

The name of the event type is passed as the first parameter.

The second parameter is the name of the function which was added as the event listener for that event by addEventListener

You may also remove a function from multiple events by passing the event names in an array.

Example:

FusionCharts.removeEventListener("Rendered", doSomething);

The name of the configuration and the value of the configuration are passed as parameters. See first example on the right.

You can also pass a collection of configurations as Object to the function. The parameter object will contain name and value pairs of the configuration name and the corresponding values. See second example on the right.

This function is called after the map gets instantiated as JavaScript object new FusionCharts. It takes a string containing the id of an HTML container Element like DIV or SPAN.

You can also pass the HTMLNode object of a container element to this function.

This function fires the map rendering process. Hence, a number of events are fired after this function call. The events are listed in sequence below:

• Initialize
• DataLoadRequested
• DataLoadRequestCompleted
• DataUpdated
• Loaded ( or FC_Loaded )
• DataLoaded ( or FC_DataLoaded )
• Rendered ( or FC_Rendered )
• DrawComplete

On various issues when map does not get rendered these error events are fired:

• DataLoadRequestCancelled
• DataLoadCancelled
• DataLoadError (FC_DataLoadError)
• DataXMLInvalid (FC_DataXMLInvalid)

myMap.render("mapContainer");

or

myMap.render(document.getElementById ("mapContainer"));

Note of caution:

When specifying XML as string, please make sure that there are no conflicts in quotes between the JS function call and the quotation mark used to enclose attributes in XML string.

myMap.setXMLData("<map><set value='100' /></map>");

Note of caution:

When specifying JSON as string, please make sure that there are no conflicts in quotes between the JS function call and the quotation mark used to enclose JSON properties and values.

myMap.setJSONData( {
    "map":{
        "numberPrefix":"$"   
     },   
     "data":[
      	{ "id": "AL", "value": "70"  },
    	{ "id": "AK", "value": "100" },
    	{ "id": "AZ", "value": "90"  },
    	{ "id": "AR", "value": "72"  }
       ] 
    }
 );


or

myMap.setJSONData('{"map":{ "numberPrefix":"$" }, "data":[ {"id": "AL", "value": "70" }, { "id": "AK", "value": "100" }, 
{"id": "AZ", "value": "90" }, { "id": "AR", "value": "72" } ] });

This function takes two parameters. The first is dataSource of the data. The second is the dataFormat. The data source can be a URL to XML source, URL to JSON source, XML as string, JSON as string and JSON as object. Hence, to identify the format correctly dataFormat is passed as second parameter.

dataFormat : Defines the format of the dataSource.

• It is xmlurl when data source is a URL to XML data
• It is xml when the data source is an XML String
• It is jsonurl when data source is a URL to JSON data
• It is json when the data source is a JSON String or JSON object

myMap.setChartData( "myxmldata.jsp" , "xmlurl");
 
or
 
myMap.setChartData( "<map><set value='2310'/></map>" , "xml");
 
or
 
myMap.setChartData( "myjsondata.php" , "jsonurl");
 
or
 
myMap.setChartData( "{ map : {}, data :[{ value : 100 }] }" , "json");


or

myMap.setChartData( { map : {}, data :[{ value : 100 }] } , "json");

setDataXML is deprecated.

myMap.setDataXML( "<map><set value='213' /></map>");

var myXML = FusionCharts("myMapId").getChartData( "xml");


var myJSONObj = FusionCharts("myMapId").getChartData( "json" );

var myJSONObj = FusionCharts("myMapId").getJSONData();

getXML is deprecated.

var myXML = FusionCharts("myMapId").getXML();

Value of the attribute; or "null" if the attribute was empty or not found in XML/SON.

var color = FusionCharts("myMapId").getChartAttribute( "bgColor");

Additionally, you can also configure the overlay button using the overlayButton property. These settings also go as another object.

The configureLink function can accept parameters in either of two formats :

• As two separate parameters, the first parameter is an Object containing all configurations (map and overlayButton). The second parameter accepts a number which denotes the level being configured. The first drill-down level is 0 (zero). See example at the top on the right.
• As a single dimensional indexed array each element of which is an object containing all map and overlay button related configurations. Each drill down level is denoted by the index of the array where the first level is Zero. So, the Object in a particular array index actually applies those settings to the level number which is equal to array index number. See example at the bottom on the right.

Overlay Button settings:

The following are the properties that we can pass as settings for overlay buttons:

• show: (true or false) whether to show the overlay button
• message: String contain the text for close button
• bgColor: Hex coded background color of the overlay button
• borderColor: Hex coded border color of the overlay button
• font: Name of the font
• fontColor: Hex coded color of the overlay button's text
• fontSize:  Size of the font of overlay button text
• bold: (true or false) Whether the overlay button's text will be bold
• padding: padding around the overlay button in pixels
  
  

myChart.configureLink(
  {
    swfUrl: 'Maps/FCMap_World.swf',
    width: '30%',
           
    overlayButton:
    {    
      message: ' x ',
      bgColor:'999999',
      canvasBorderColor: 'cccccc'
    }
  },
0);
 

myChart.configureLink(
     [ {swfUrl: 'Maps/FCMap_World.swf'},
       {swfUrl: 'Maps/Pie2D.swf'},
       {swfUrl: 'Maps/Line2D.swf'}, 
       {swfUrl: 'Maps/Area2D.swf'}
     ] 
    );

In cases, while saving a map to a server location, a callback function is invoked to convey status of export.

exportMap is deprecated. Use exportChart instead.

myMap.exportMap( { exportFormat : 'jpg'} )

FusionCharts("myMapId").print()

Additionally, the function will raise the BeforeDispose event prior to removing a map and disposed after the map has been removed.

FusionCharts("myMapId").dispose();

var strCharType = FusionCharts("myMapId").isActive();

var strCharType = FusionCharts("myMapId").signature();

FusionCharts.printManager.enabled(true);

var goPrint = FusionCharts.printManager.isReady();

This function needs to be called before you call FusionCharts.debugMode.enabled()

When the outputFormat is set to event, the output function assigned to the debugger (using debugMode method) is sent arguments exactly matching FusionCharts Advanced events model.

FusionCharts.debugMode.outputFormat('verbose');