联合(网格方式)
===============

1.描述
------------

对使用网格存储的两个输入要素合并到新的要素类中,获取两个要素类的相交和分别被裁剪的部分。

2.使用限制
----------------

输入要素需要为网格存储的形式,只能合并polygon类型的要素类。

3.算子id
----------------
com.analyse.overlay.UnionWithGrid

4.参数列表
---------------

+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
| 参数类型 | 参数名称          | 参数关键字                 | 必要性 | 参数说明                                                                        | 数据类型 |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
| 输入参数 | table_left        | 左表数据源地址             | Y      | 数据源地址                                                                      | String   |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
|          | table_right       | 右表数据源地址             | Y      | 输入要素类或图层                                                                | String   |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
|          | geo_name          | 用于擦除重叠输入要素的要素 | Y      | 用于擦除重叠输入要素的要素                                                      | String   |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
|          | if_cal_area       | 是否计算面积               | Y      | 是否计算图形面积                                                                | String   |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
|          | inputBSM_left     | 左图层标识码               | Y      | 用于左图层聚合的唯一标识码                                                      | String   |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
|          | inputBSM_right    | 右图层标识码               | Y      | 用于右图层聚合的唯一标识码                                                      | String   |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+
| 输出参数 | output_table      | 结果图层                   | Y      | 该要素类只包含两要素相交部分                                                    | String   |
+----------+-------------------+----------------------------+--------+---------------------------------------------------------------------------------+----------+


5.配置面板
--------------------
.. image:: ../../../_static/images/union_grid_panel.jpg
   :width: 300px

6.调用示例
------------------
.. code::
  
    {
      "params": {
        "table_left":"bd2022.whrdc:2181,guangzhou_3d_test,DLTB122",
        "table_right":"bd2022.whrdc:2181,guangzhou_3d_test,DLTB123",
        "geo_name":"the_geom",
        "inputBSM_left":"BSM",
        "inputBSM_right":"BSM",
        "if_cal_area":"false",
        "output_table":"bd2022.whrdc:2181,guangzhou_3d_test,DLTB122un"
      },
      "identifier":"com.analyse.overlay.UnionWithGrid"
    }