FusionMaps地图XML文档详解
FusionMaps地图是通过XML配置文档来设置表现形式，包括颜色，字体等。也是通过XML配置文档设置FusionMaps的一些功能。
一个简单的XML文档：
|
<map animation='1' borderColor='005879' fillColor='D7F4FF' numberSuffix=' Mill.' includeValueInLabels='1' labelSepChar=': ' baseFontSize='9' showShadow='0' showBevel='0' showCanvasBorder='0'> <colorRange> <color minValue='0' maxValue='500' displayValue='0到500' color='A7E9BC' /> <color minValue='500' maxValue='1000' displayValue='500到1000' color='FFFFCC' /> <color minValue='1000' maxValue='5000' displayValue='1000到5000' color='FF9377' /> </colorRange> <data> <entity id='1' value='515' /> <entity id='2' value='373' /> <entity id='3' value='3875' /> <entity id='4' value='727' /> <entity id='5' value='885' /> <entity id='6' value='32' /> <entity id='7' value='32' /> <entity id='8' value='3875' /> <entity id='9' value='727' /> <entity id='10' value='885' /> <entity id='11' value='32' /> <entity id='12' value='32' /> <entity id='13' value='322' /> </data> </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属性。 |
Fusionmap提供了中国地图以及省和直辖市地图，但没有地级市地区，如果需要，请参考《用FusionMaps制作中国地图》
1条留言 我要留言
1 楼 茶余饭后 | 2014-04-04 at 11:58 下午
只是路过学习啦!
请 登陆 评论