{{ target: component-geo3D-common }}

map(string)

地图类型。echarts-gl 中使用的地图类型同 geo 组件相同。

你可以在地图下载界面下载到需要的地图文件引入并注册到 ECharts 中。

ECharts 提供了两种格式的地图数据，一种是可以直接通过 script 标签引入的 js 文件，引入后会自动注册地图名字和数据。还有一种是 JSON 文件，需要通过 AJAX 异步加载后手动注册。

下面是两种类型的使用示例：

** JavaScript 引入示例 **

<script src="echarts.js"></script>
<script src="map/js/china.js"></script>
<script>
var chart = echarts.init(document.getElementById('main'));
chart.setOption({
    series: [{
        type: 'map',
        map: 'china'
    }]
});
</script>

** JSON 引入示例 **

$.get('map/json/china.json', function (chinaJson) {
    echarts.registerMap('china', chinaJson);
    var chart = echarts.init(document.getElementById('main'));
    chart.setOption({
        series: [{
            type: 'map',
            map: 'china'
        }]
    });
});

ECharts 使用 geoJSON 格式的数据作为地图的轮廓。除此之外，你也可以通过其它手段获取地图的 geoJSON 格式的数据注册到 ECharts 中。

{{ use: partial-box-size-geo3D( componentType=${componentType}, componentName=${componentName}, defaultBoxHeight = 10, defaultBoxDepth = ‘auto’ ) }}

regionHeight(number) = 3

三维地图每个区域的高度。这个高度是模型的高度，小于 boxHeight。boxHeight - regionHeight 这一片区域会被用于三维柱状图，散点图等的展示。

{{ use: partial-environment( componentType=${componentType}, componentName=${componentName} ) }}

groundPlane(Object)

地面可以让整个组件有个“摆放”的地方，从而使整个场景看起来更真实，更有模型感。

groundPlane 下支持设置单独的 realisticMaterial, colorMaterial, lambertMaterial 等材质。如果不设置则默认取组件下的材质参数。

show(boolean) = false

是否显示地面。

color(string) = ‘#aaa’

地面颜色。

instancing(boolean) = false

instancing会将 GeoJSON 中所有的 geometry 合并成一个，在 GeoJSON 拥有特别多（上千）的 geometry 时可以有效提升绘制效率。

label(Object)

标签的相关设置。

{{ use: partial-label( prefix=“##”, defaultShow=false ) }}

itemStyle(Object)

${componentName} 中三维图形的视觉属性，包括颜色，透明度，描边等。

{{ use: partial-item-style-geo3D( prefix=“##”, hasCallback=true, useColorPalette=true ) }}

emphasis(Object)

鼠标 hover 高亮时图形和标签的样式。

label(Object)

{{ use: partial-label-geo3D( prefix=“###”, defaultShow=false ) }}

itemStyle(Object)

{{ use: partial-item-style( prefix=“###” ) }}

{{ if: ${inMap} }} data(Array) {{ else: }} regions(Array) {{ /if }}

地图区域的设置。

name(string)

所对应的地图区域的名称，例如 '广东'，'浙江'。

{{ if: ${inMap} }}

value(number)

该区域的数据值。 {{ /if }}

regionHeight(number)

区域的高度。可以设置不同的高度用来表达数据的大小。当 GeoJSON 为建筑的数据时，也可以通过这个值表示简直的高度。如下图:

itemStyle(Object)

单个区域的样式设置。

{{ use: partial-item-style-geo3D( prefix=“###” ) }}

label(Object)

单个区域的标签设置。

{{ use: partial-label-geo3D( prefix=“###”, defaultShow=false ) }}

emphasis(Object)

单个区域的标签和样式的高亮设置。

itemStyle(Object)

{{ use: partial-item-style-geo3D( prefix=“####” ) }}

label(Object)

{{ use: partial-label-geo3D( prefix=“####”, defaultShow=false ) }}

{{ use: partial-shading( componentType=${componentType}, componentName=${componentName} ) }}

{{ use: partial-light( componentType=${componentType}, componentName=${componentName}, defaultMainLightAlpha=40, defaultMainLightBeta=30 ) }}

{{ use: partial-post-effect( componentType=${componentType}, componentName=${componentName} ) }}

{{ use: partial-temporal-super-sampling( componentType=${componentType}, componentName=${componentName} ) }}

{{ use: partial-view-control( componentType=${componentType}, componentName=${componentName}, defaultAlpha=40, defaultBeta=0, defaultDistance=100, defaultMinAlpha=5, defaultMinBeta=-80, defaultMaxBeta=80 ) }}

{{ use: partial-zlevel }}

{{ use: partial-viewport }}

{{ target:partial-box-size-geo3D(master=partial-box-size)}}

{{ block: boxWidthDescriptionExtra }}

下面是${componentName} 中boxWidth, boxHeight, boxDepth, regionHeight的示意图。

{{ /block }}

{{ block: boxDepthDescriptionExtra }} 组件深度默认自动，保证三维组件的显示比例跟输入的 GeoJSON 的比例相同。 {{ /block }}

{{ block: boxHeightDescriptionExtra}} 组件高度。这个高度包含三维地图上的柱状图、散点图的高度。 {{ /block }}

{{ target: partial-label-geo3D }}

{{ use: partial-label( prefix=${prefix}, defaultShow=${defaultShow}, defaultDistance=2, defaultTextFontSize=20, defaultTextColor=‘#000’, defaultTextBorderWidth=1, defaultTextBorderColor=“#fff” ) }}

{{ target: partial-item-style-geo3D }}

{{ use: partial-item-style( prefix=${prefix|default(‘##’)}, colorName=‘color’, hasCallback = ${hasCallback}, useColorPalette = ${useColorPalette} ) }}

#${prefix|default(‘##’)} borderWidth(number) = ${defaultBorderWidth|default(0)}

图形描边的宽度。加上描边后可以更清晰的区分每个区域。如下图：

#${prefix|default(‘##’)} borderColor(string) = ${defaultBorderColor|default(‘#333’)}

图形描边的颜色。