FusionMaps地图XML文档详解

最近在用FusionMaps来制作地图。FusionMaps是通过XML配置文档来设置表现形式，包括颜色，字体等。也是通过XML配置文档设置FusionMaps的一些功能。

一个标准的XML文档：

<map animation='0' showShadow='0' showBevel='0' showLabels='0' showMarkerLabels='1' fillColor='F1f1f1'borderColor='CCCCCC' baseFont='Verdana' baseFontSize='10' markerBorderColor='000000' markerBgColor='FF5904'markerRadius='6' legendPosition='bottom' useHoverColor='0' showToolTip='0' showMarkerToolTip='1' >

   <data>

      <entity id='NA' />

      <entity id='SA' />

      <entity id='EU' />

      <entity id='AS' />

      <entity id='AF' />

      <entity id='AU' />

   </data>

   <markers>

      <definition>

         <marker id='CA' x='116.65' y='94.85' label='Sales Office' labelPos='top'/>

         <marker id='US' x='131.57' y='133.22' label='Headquarters' labelPos='bottom'/>

         <marker id='CN' x='532.3' y='150.68' label='Call Center' labelPos='bottom'/>

         <marker id='BR' x='228.55' y='276.03' label='Production Center' labelPos='bottom'/>

         <marker id='AU' x='621.83' y='311.21' label='Q & A' labelPos='bottom'/>

         <marker id='RU' x='532.3' y='76.73' label='Back Office' labelPos='bottom'/>

         <marker id='IN' x='499.26' y='202.5' label='Accounts' labelPos='bottom'/>

      </definition>

      <shapes>

         <shape id='USMap' type='image' url='Resources/us_flag.jpg' labelPadding='12' />

         <shape id='CAMap' type='image' url='Resources/canada_flag.jpg' labelPadding='12' />

         <shape id='CNMap' type='image' url='Resources/china_flag.jpg' labelPadding='12' />

         <shape id='BRMap' type='image' url='Resources/brazil_flag.jpg' labelPadding='12' />

         <shape id='AUMap' type='image' url='Resources/aus_flag.jpg' labelPadding='12' />

         <shape id='RUMap' type='image' url='Resources/rus_flag.jpg' labelPadding='12' />

         <shape id='INMap' type='image' url='Resources/ind_flag.jpg' labelPadding='12' />

      </shapes>

      <application>

         <marker id='CA' shapeId='CAMap' toolText='Canada&lt;BR&gt;2 Managers&lt;BR&gt;11 Staff'/>

         <marker id='US' shapeId='USMap' toolText='United States&lt;BR&gt;CEO, CFO, 3 Managers&lt;BR&gt;26 Staff'/>

         <marker id='CN' shapeId='CNMap' toolText='China&lt;BR&gt;1 Manager&lt;BR&gt;7 Support Staff'/>

         <marker id='BR' shapeId='BRMap' toolText='Brazil&lt;BR&gt;COO, 2 Managers&lt;BR&gt;32 Factory Staff'/>

         <marker id='AU' shapeId='AUMap' toolText='Australia&lt;BR&gt;1 Manager&lt;BR&gt;(Outsourced Agency)'/>

         <marker id='RU' shapeId='RUMap' toolText='Russia&lt;BR&gt;1 Manager&lt;BR&gt;6 Staff'/>

         <marker id='IN' shapeId='INMap' toolText='India&lt;BR&gt;1 Manager&lt;BR&gt;5 Accountants'/>

      </application>

   </markers>

   <styles>

      <definition>

         <style name='TTipFont' type='font' isHTML='1' color='FFFFFF' bgColor='666666' size='11'/>

         <style name='HTMLFont' type='font' color='333333' borderColor='CCCCCC' bgColor='FFFFFF'/>

         <style name='myShadow' type='Shadow' distance='1'/>

      </definition>

      <application>

         <apply toObject='MARKERS' styles='myShadow' />

         <apply toObject='MARKERLABELS' styles='HTMLFont,myShadow' />

         <apply toObject='TOOLTIP' styles='TTipFont' />

      </application>

   </styles>

</map>

一、<map>元素的功能性属性：

Attribute Name	Type	Range	Description
animation	Boolean	0/1	是否让地图支持动态效果，默认的动画为淡入。 设置0为否，1为是。
showLabels	Boolean	0/1	是否显示实体的labels。
includeNameInLabels	Boolean	0/1	是否在labels中显示实体名称。
includeValueInLabels	Boolean	0/1	是否在labels中显示实体的值。
useSNameInLabels	Boolean	0/1	是否在labels活实体名称中用简写来表示。
useSNameInToolTip	Boolean	0/1	是否在提示文本中用简写来表示。
showShadow	Boolean	0/1	是否显示地图阴影。
showBevel	Boolean	0/1	是否显示3D地图。
clickURL	String		整个地图可以作为一个热点，指向一个URL，链接必须符合FusionMaps的格式。
defaultAnimation	Boolean	0/1	地图默认的是有淡入的效果。如果你想通过STYLE功能来自定义动画效果，你可以将次此值设为0。
hoverOnEmpty	Boolean	0/1	当XML中没有设置了某个实体的值，是否让其在提示信息显示出来。
showPrintMenuItem	Boolean	0/1	是否显示”Print Chart” 按钮。默认为1。
exposeHoverEvent	Boolean	0/1	当鼠标移到一实体上时，是否激发Javascript事件或者Flash事件。
showAboutMenuItem	Boolean	0/1	是否右键后显示about信息。在这里可以设置你的公司名或者链接。默认的about信息是”About FusionMaps ” 。
aboutMenuItemLabel	String		about信息上的文本。
aboutMenuItemLink	String	URL	about信息上的文本连接。

二、<map>元素的外观性属性：

Attribute Name	Type	Range	Description
showCanvasBorder	Boolean	1/0	是否显示实体的边框。
canvasBorderColor	Color	Hex Code	实体边框的颜色。
canvasBorderThickness	Number	In Pixels	实体边框的粗细。
canvasBorderAlpha	Number	0-100	实体边框的透明度。
bgColor	Color		设置整个地图的背景颜色。
bgAlpha	Number	0-100	设置整个地图的背景透明度。
bgRatio	Number	0-100	设置整个地图的背景颜色比率。
bgAngle	Number	0-360	设置整个地图的背景颜色角度。
bgSWF	String		可以用一个透明swf文件作为地图的背景。这个文件要与地图文件在同一个域中。
bgSWFAlpha	Number	0-100	背景flash的透明度。
logoURL	String	URL	可以加载一个logo。这个图要与地图文件在同一个域中。
logoPosition	String	TL, TR, BL, BR, CC	Logo的位置：TL – 左上，TR – 右上，BR – 右下，BL – 左下，CC – 中间
logoAlpha	Number	0-100	Logo的透明度。
logoScale	Number	0-300	Logo的比例大小。
logoLink	String	URL	Logo指向的链接。

三、设置Map的数字格式，利用下面这些属性，可以控制以下功能： 

1、数字逗号和小数点的格式； 2、数字前缀和后缀； 3、在哪一位四舍五入； 4、在哪一个数量级进行缩放； 5、自定义输入格式。

Attribute Name	Type	Range	Description
formatNumber	Boolean	0/1	配置是否启动数字格式。例如：当配置为1时，显示 40,000 ，配置为0时，显示 40000 。
formatNumberScale	Boolean	0/1	配置是否将数字转化为K (千) and M (百万)。例如： 配置为1, 1043 将转化为1.04K (小数点后两位).
defaultNumberScale	String		数字默认的单位。在数字格式高级部分有更详细的介绍。
numberScaleUnit	String		数字的单位。在数字格式高级部分有更详细的介绍。
numberScaleValue	String		Range of the various blocks that constitute the scale. For more details, please see Advanced Number Formatting section.
numberPrefix	String	Character	数字前缀
numberSuffix	String	Character	数字后缀
decimalSeparator	String	Character	设置一个小数点分隔符。
thousandSeparator	String	Character	设置一个千分隔符。
inDecimalSeparator	String	Character	设置不同的分隔符。
inThousandSeparator	String	Character	设置不同的分隔符。
decimals	Number	0-10	小数点的位数。

四、设置Map的字体属性：

Attribute Name	Type	Range	Description
baseFont	String	Font Name	设置字体。
baseFontSize	Number	0-72	字体大小。
baseFontColor	Color		字体颜色。

允许将地图保存为图片的属性 （在Map标签中）

Attribute Name	Type	Range	Description
imageSave	Boolean	(0/1)	是否支持图片保存功能。
imageSaveURL	URL		图片保存地址，应与地图文件同域。
imageSaveDialogColor	Color		保存图片时候弹出的窗口颜色。
imageSaveDialogFontColor	Color		保存图片时候弹出的窗口字体颜色。

五、书签属性（在map标签中），书签用来在地图上定义一个点，用来指向一个城市，屋子或者市场等。你可以通过一下的配置项来设置书签。 

Attribute Name	Type	Range	Description
markerFont	String	Font Name	设置书签字体，在STYLES 中可以重写。
markerFontSize	Number	0-72	设置书签字体大小。
markerFontColor	Color		设置书签字体颜色。
showMarkerToolTip	Boolean	0/1	是否显示提示书签的提示信息。
showMarkerLabels	Boolean	0/1	是否显示书签的信息。
markerLabelPadding	Number	Pixels	设置书签信息和图标之间的距离。也可以在后面为每个书签重写该值。
markerBgColor	Color		书签背景颜色。
markerBorderColor	Color		书签边框颜色。
markerRadius	Number	Pixels	书签的半径。
markerConnThickness	Number	Pixels	如果设置了连接线，这个属性用来设置连接线的粗细。
markerConnColor	Color		如果设置了连接线，这个属性用来设置连接线的颜色。
markerConnAlpha	Number	0-100	如果设置了连接线，这个属性用来设置连接线的透明度。
markerConnDashed	Boolean	0/1	如果设置了连接线，这个属性用来设置连接线是否为虚线。
markerConnDashLen	Number	Pixels	如果设置了连接线为虚线，这个属性用来设置虚线的长短。
markerConnDashGap	Number	Pixels	如果设置了连接线为虚线，这个属性用来设置虚线间的长短。

六、提示信息（在map标签中）

Attribute Name	Type	Range	Description
showToolTip	Boolean	0/1	是否显示提示信息。
toolTipBgColor	Color		提示信息的背景颜色。
toolTipBorderColor	Color		提示信息的边框颜色。
toolTipSepChar	String		提示信息中，设置名称和值之间的分隔符。
showToolTipShadow	Boolean	0/1	是否在提示信息中显示阴影。

 地图的内边距和外边距（在map标签中） 

Attribute Name	Type	Range	Description
legendPadding	Number	In Pixels	设置图例在右/下的内边距。
mapLeftMargin	Number	In Pixels	设置地图距离左边的距离。
mapRightMargin	Number	In Pixels	设置地图距离右边的距离。
mapTopMargin	Number	In Pixels	设置地图距离上边的距离。
mapBottomMargin	Number	In Pixels	设置地图距离下边的距离。

七、图例属性（在map标签中）

如果你定义了区域范围颜色，这些颜色块会出现在图例中。你可以将颜色块放在地图的下面或右边。
当然，利用下面的属性，可以设置自定义图例。 

Attribute Name	Type	Range	Description
showLegend	Boolean	0/1	是否显示图例。
legendCaption	String		图例的标题
legendPosition	String	BOTTOM or RIGHT	图例的位置，下面或右边。
legendBgColor	Color	Hex Code	图例的背景颜色。
legendBgAlpha	Number	0-100	图例的背景透明度。
legendBorderColor	Color	Hex Code	图例边框颜色。
legendBorderThickness	Number	In Pixels	图例边框粗细。
legendBorderAlpha	Number	0-100	图例边框透明度。
legendShadow	Boolean	0/1	是否显示图例阴影。
legendAllowDrag	Boolean	0/1	是否允许拖动图例。
legendScrollBgColor	Color	Hex Code	图例拉动框的背景颜色。
legendScrollBarColor	Color	Hex Code	图例拉动框的颜色。
legendScrollBtnColor	Color	Hex Code	图例拉动框的按钮颜色
reverseLegend	Boolean	0/1	是否颠倒图例的顺序。

八、<entity>实体属性（在每个单独的entity标签中）

Attribute Name	Type	Range	Description
value	Number		实体的值。
displayValue	String		显示信息。
toolText	String		提示信息。
color	Color	Hex Code	实体颜色。
alpha	Number	0-100	透明度。
link	String		指向的连接，可以是一个窗口，弹出窗口，框架或者是Javascript函数。在“下钻地图”中有更详细的介绍。
font	String		字体。
fontSize	String		字体大小。
fontColor	Boolean	0/1	字体颜色。
fontBold	Boolean	0/1	字体粗细。
showLabel	Boolean	0/1	是否显示标签信息。这个属性重写了<map>中的showLabels属性。