op_ima_obj_pos_set_geodetic()
摘要
在大地坐标系中设置移动站点的位置。
语法
op_ima_obj_pos_set_geodetic (objid, lat, lon, alt)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
目标移动站点的对象 ID(节点或子网) [站点对象 ID 可以从 Id 和 Topo 包中的多个 KP 获得: op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。] |
lat |
double |
为站点设置的纬度 |
lon |
double |
为站点设置的经度 |
alt |
double |
为站点设置的高度,或 OPC_IMA_GEODETIC_ALTITUDE_UNCHANGED(参见详情) |
返回类型
Compcode
发生错误时为 OPC_COMPCODE_FAILURE(参见错误一节);否则为 OPC_COMPCODE_SUCCESS。
示例
obj_type = op_id_to_type (mob_site_id);
if (obj_type == OPC_OBJTYPE_NODE_MOB || obj_type == OPC_OBJTYPE_SUBNET_MOB)
{
op_ima_obj_pos_set_geodetic (mob_site_id, new_lat, new_lon, new_alt);
}
详情
本 KP 设置的站点位置以大地坐标系 {纬度 / 经度 / 高度} 表示。该坐标系中,纬度和经度的单位为度,高度的单位为米。
由 objid 指定的移动站点不得使用其他位置指定方式,例如:
- 轨迹
- 查询过程(由 op_ima_obj_pos_query_proc_set() 设置)
- 随机移动
如果 alt 指定为 OPC_IMA_GEODETIC_ALTITUDE_UNCHANGED,则新位置只设置 lat 和 lon。
用途
本函数提供了一种通过在大地坐标系中指定坐标来设置移动节点或子网位置的方法。
错误
- 可恢复错误:对象 ID(
<objid>)超出范围。 - 可恢复错误:对象 ID(
<objid>)指向受限对象。 - 可恢复错误:无法为对象(
<objid>)设置大地位置;它不是移动节点或子网(对象类型为<obj_type>)。 - 可恢复错误:无法为对象(
<objid>)设置大地位置;它使用轨迹。 - 可恢复错误:无法为对象(
<objid>)设置大地位置;其位置由查询回调定义。