com.autonavi.gbl.pos.PosService类 参考

定位服务接口类 更多...

类 com.autonavi.gbl.pos.PosService 继承关系图:

Public 成员函数
	PosService (IPosServiceImpl control)
boolean	isRecycled ()
long	getPtr ()
	获取当前服务的指针 更多...
void	onCreate ()
	服务创建时回调，HMI不需要主动调用 建议，服务实现者实现接口时候，初始化观察者信息 更多...
LocGPSHistory	getGPSHistory ()
	主动获取定位引擎GPS历史信息 更多...
.ErrorCode1 int	init (PosWorkPath path, LocModeType locModeType, IThreadObserver threadObserver)
	定位服务初始化 更多...
.ServiceInitStatus1 int	isInit ()
	获取是否初始化 更多...
void	setSignInfo (LocSignData pLocSignData)
	设置信号信息 更多...
void	switchParallelRoad (@LocSwitchRoadType.LocSwitchRoadType1 int switchRoadType, java.math.BigInteger pstRoadID)
	*  更多...
void	saveLocStorage ()
	保存定位上下文信息 更多...
void	signalRecordSwitch (boolean open, boolean encryption, int logLevel, @LocLogType.LocLogType1 int logType)
	信号记录功能开关（老接口，建议使用下面的新的SignalRecordSwitch(bool open, const LocLogConf& conf)） 更多...
void	signalRecordSwitch (boolean open, boolean encryption, int logLevel)
	信号记录功能开关 更多...
void	signalRecordSwitch (boolean open, LocLogConf conf)
boolean	requestCallBackPos (int nMode)
	主动请求定位引擎回调位置信息 更多...
void	setDefaultPos (Coord3DDouble defaultPos)
	设置初始默认位置 更多...
void	setContextPos (Coord3DDouble contextPos, float heading)
	设置客户端保存的最后位置 更多...
void	setIssueSubmitInfo (String subInfo)
	设置用户上报参数 @detail 设置用户上报问题的类型、上报时间、导航开始和结束时间,没有的参数赋值为-1. 更多...
void	addLocInfoObserver (IPosLocInfoObserver pObserver, int nFlag)
	添加定位信息观察者 更多...
void	removeLocInfoObserver (IPosLocInfoObserver pObserver)
	删除定位信息观察者 更多...
void	addParallelRoadObserver (IPosParallelRoadObserver pObserver)
	添加主辅路信息观察者 更多...
void	removeParallelRoadObserver (IPosParallelRoadObserver pObserver)
	删除主辅路信息观察者 更多...
void	addSwitchParallelRoadObserver (IPosSwitchParallelRoadObserver pObserver)
	添加切换平行路观察者 更多...
void	removeSwitchParallelRoadObserver (IPosSwitchParallelRoadObserver pObserver)
	删除切换平行路观察者 更多...
void	addSignInfoObserver (IPosSignInfoObserver pObserver)
	添加源始信号观察者 更多...
void	removeSignInfoObserver (IPosSignInfoObserver pObserver)
	删除源始信号观察者 更多...
void	addMapMatchFeedbackObserver (IPosMapMatchFeedbackObserver pObserver)
	添加地图匹配反馈信息观察者 更多...
void	removeMapMatchFeedbackObserver (IPosMapMatchFeedbackObserver pObserver)
	删除地图匹配反馈信息观察者 更多...
void	addNgmInfoObserver (INgmInfoObserver pObserver)
	添加定位'NGM信息反馈'观察者 更多...
void	removeNgmInfoObserver (INgmInfoObserver pObserver)
	删除定位'NGM信息反馈'观察者 更多...
void	addSensorParaObserver (IPosSensorParaObserver pObserver)
	添加定位'传感器标定信息回传'观察者 更多...
void	removeSensorParaObserver (IPosSensorParaObserver pObserver)
	删除定位'传感器标定信息回传'观察者 更多...
void	addPosDrInfoObserver (IPosDrInfoObserver pObserver)
	添加DR相关信息观察者 更多...
void	removePosDrInfoObserver (IPosDrInfoObserver pObserver)
	删除DR相关信息观察者 更多...
void	addAttitudeAngleObserver (IPosAttitudeAngleObserver pObserver)
	添加AttitudeAngle信息观察者 更多...
void	removeAttitudeAngleObserver (IPosAttitudeAngleObserver pObserver)
	删除AttitudeAngle信息观察者 更多...
String	getDebugInfo (int type)
	获取定位调试信息 更多...
void	setOverheadSwitch (boolean isOpen)
	是否发起气压计辅助高架导航的偏航请求 更多...
void	onDestroy ()
	服务销毁时回调，HMI不需要主动调用 建议，服务实现者实现接口时候，销毁观察者信息 更多...

静态 Public 成员函数
static Coord3DDouble	encryptLonLat (Coord3DDouble wgs84Pos)
	WGS84坐标加密成GCJ02坐标 更多...
static String	getEngineVersion ()
	获取定位引擎版本 更多...

Protected 成员函数
	PosService (long cPtr, boolean cMemoryOwn)
IPosServiceImpl	getControl ()
void	unbind ()
void	clean ()
synchronized void	delete ()

详细描述

定位服务接口类

调用init方法
调用setLogSwitch
调用setFunctionSwitch
调用setSignalTypes
调用setMode

注意

定位的其它接口（静态成员函数除外）只有在完成如上时序启动定位后才可以调用

构造及析构函数说明

PosService() [1/2]

com.autonavi.gbl.pos.PosService.PosService ( long  cPtr, boolean  cMemoryOwn  )

protected

PosService() [2/2]

com.autonavi.gbl.pos.PosService.PosService

(

IPosServiceImpl

control

)

成员函数说明

addAttitudeAngleObserver()

void com.autonavi.gbl.pos.PosService.addAttitudeAngleObserver

(

IPosAttitudeAngleObserver

pObserver

)

添加AttitudeAngle信息观察者

返回

void

addLocInfoObserver()

void com.autonavi.gbl.pos.PosService.addLocInfoObserver	(	IPosLocInfoObserver	pObserver,
		int	nFlag
	)

添加定位信息观察者

此接口用来添加客户端定位信号回调观察者

参数

[in]	pObserver	观察者
[in]	nFlag	0表示定频，非0表示变频。当前此字段为无效字段。未实现

注解

异步接口

thread: mutil

addMapMatchFeedbackObserver()

void com.autonavi.gbl.pos.PosService.addMapMatchFeedbackObserver

(

IPosMapMatchFeedbackObserver

pObserver

)

添加地图匹配反馈信息观察者

此接口用来添加客户端地图匹配反馈信息观察者

注解

thread: mutil

addNgmInfoObserver()

void com.autonavi.gbl.pos.PosService.addNgmInfoObserver

(

INgmInfoObserver

pObserver

)

添加定位'NGM信息反馈'观察者

'NGM信息反馈'功能的具体实现由外部实现，若不需要'NGM信息反馈'功能则忽略该方法

注解

thread: mutil

addParallelRoadObserver()

void com.autonavi.gbl.pos.PosService.addParallelRoadObserver

(

IPosParallelRoadObserver

pObserver

)

添加主辅路信息观察者

此接口用来添加客户端主辅路信息观察者

参数

[in]

pObserver

观察者

注解

异步接口

thread: mutil

addPosDrInfoObserver()

void com.autonavi.gbl.pos.PosService.addPosDrInfoObserver

(

IPosDrInfoObserver

pObserver

)

添加DR相关信息观察者

定位引擎使用观察者模式对外通知DR相关信息

注解

thread: mutil

addSensorParaObserver()

void com.autonavi.gbl.pos.PosService.addSensorParaObserver

(

IPosSensorParaObserver

pObserver

)

添加定位'传感器标定信息回传'观察者

"传感器标定信息"的具体使用由外部实现，若不需要使用"传感器标定信息"则忽略该方法

注解

thread: mutil

addSignInfoObserver()

void com.autonavi.gbl.pos.PosService.addSignInfoObserver

(

IPosSignInfoObserver

pObserver

)

添加源始信号观察者

此接口用来添加客户端源始信号观察者

参数

[in]

pObserver

观察者

注解

异步接口

thread: mutil

addSwitchParallelRoadObserver()

void com.autonavi.gbl.pos.PosService.addSwitchParallelRoadObserver

(

IPosSwitchParallelRoadObserver

pObserver

)

添加切换平行路观察者

此接口用来添加客户端切换平行路观察者

参数

[in]

pObserver

观察者

注解

异步接口

thread: mutil

clean()

void com.autonavi.gbl.pos.PosService.clean ( )

protected

delete()

synchronized void com.autonavi.gbl.pos.PosService.delete ( )

protected

encryptLonLat()

static Coord3DDouble com.autonavi.gbl.pos.PosService.encryptLonLat ( Coord3DDouble  wgs84Pos )

static

WGS84坐标加密成GCJ02坐标

此接口用来对WGS84坐标进行加密，生成GCJ02坐标

注意

超过中国范围的不进行转换，直接将wgs84Pos赋值给gcj02Pos

参数

[in]

wgs84Pos

输入，WGS84坐标，经纬度坐标

注解

thread: mutil

getControl()

IPosServiceImpl com.autonavi.gbl.pos.PosService.getControl ( )

protected

getDebugInfo()

String com.autonavi.gbl.pos.PosService.getDebugInfo

(

int

type

)

获取定位调试信息

此接口用于获取定位引擎调试信息

参数

[in]

type

调试信息类型； 1.引擎匹配基本信息

返回

const char* 调试信息字符串（Json）

注解

thread: mutil

getEngineVersion()

static String com.autonavi.gbl.pos.PosService.getEngineVersion ( )

static

获取定位引擎版本

定位引擎版本号由如下四个部分组成

• 主版本号
• 次版本号
• 数据标识号
• BUILD号，前置自动加0，共4位

  返回

  dice::String16 返回数据版本信息字符串指针

  注解

  thread: mutil

getGPSHistory()

LocGPSHistory com.autonavi.gbl.pos.PosService.getGPSHistory

(

)

主动获取定位引擎GPS历史信息

返回

history GPS历史信息

注解

同步接口

getPtr()

long com.autonavi.gbl.pos.PosService.getPtr

(

)

获取当前服务的指针

返回

注解

HMI不应该主动调用,这个是由服务管理类进行调用

实现了 com.autonavi.gbl.servicemanager.IService.

init()

.ErrorCode1 int com.autonavi.gbl.pos.PosService.init	(	PosWorkPath	path,
		LocModeType	locModeType,
		IThreadObserver	threadObserver
	)

定位服务初始化

用于初始化定位服务 @Param[in] locModeType 初始化定义类型参数

返回

ErrorCode 成功 其他 失败

注解

thread multi

isInit()

.ServiceInitStatus1 int com.autonavi.gbl.pos.PosService.isInit

(

)

获取是否初始化

得到服务当前状态，判断是否已经初始化

返回

ServiceInitStatus 初始化状态

注解

thread: main

实现了 com.autonavi.gbl.servicemanager.IService.

isRecycled()

boolean com.autonavi.gbl.pos.PosService.isRecycled

(

)

实现了 com.autonavi.gbl.servicemanager.IService.

onCreate()

void com.autonavi.gbl.pos.PosService.onCreate

(

)

服务创建时回调，HMI不需要主动调用 建议，服务实现者实现接口时候，初始化观察者信息

实现了 com.autonavi.gbl.servicemanager.IService.

onDestroy()

void com.autonavi.gbl.pos.PosService.onDestroy

(

)

服务销毁时回调，HMI不需要主动调用 建议，服务实现者实现接口时候，销毁观察者信息

实现了 com.autonavi.gbl.servicemanager.IService.

removeAttitudeAngleObserver()

void com.autonavi.gbl.pos.PosService.removeAttitudeAngleObserver

(

IPosAttitudeAngleObserver

pObserver

)

删除AttitudeAngle信息观察者

返回

void

removeLocInfoObserver()

void com.autonavi.gbl.pos.PosService.removeLocInfoObserver

(

IPosLocInfoObserver

pObserver

)

删除定位信息观察者

此接口用来删除客户端定位信号回调观察者

参数

[in]

pObserver

观察者

注解

异步接口，所以外部删除观察者后，如果直接把观察者销毁释放掉可能会导致定位引擎崩溃。应该先销毁定位引擎

thread: mutil

removeMapMatchFeedbackObserver()

void com.autonavi.gbl.pos.PosService.removeMapMatchFeedbackObserver

(

IPosMapMatchFeedbackObserver

pObserver

)

删除地图匹配反馈信息观察者

此接口用来删除客户端地图匹配反馈信息观察者

注解

thread: mutil

removeNgmInfoObserver()

void com.autonavi.gbl.pos.PosService.removeNgmInfoObserver

(

INgmInfoObserver

pObserver

)

删除定位'NGM信息反馈'观察者

'NGM信息反馈'功能的具体实现由外部实现，若不需要'NGM信息反馈'功能则忽略该方法

注解

thread: mutil

removeParallelRoadObserver()

void com.autonavi.gbl.pos.PosService.removeParallelRoadObserver

(

IPosParallelRoadObserver

pObserver

)

删除主辅路信息观察者

此接口用来删除客户端主辅路信息观察者

参数

[in]

pObserver

观察者

注解

异步接口，所以外部删除观察者后，如果直接把观察者销毁释放掉可能会导致定位引擎崩溃。应该先销毁定位引擎

thread: mutil

removePosDrInfoObserver()

void com.autonavi.gbl.pos.PosService.removePosDrInfoObserver

(

IPosDrInfoObserver

pObserver

)

删除DR相关信息观察者

定位引擎使用观察者模式对外通知DR相关信息

注解

thread: mutil

removeSensorParaObserver()

void com.autonavi.gbl.pos.PosService.removeSensorParaObserver

(

IPosSensorParaObserver

pObserver

)

删除定位'传感器标定信息回传'观察者

"传感器标定信息"的具体使用由外部实现，若不需要使用"传感器标定信息"则忽略该方法

注解

thread: mutil

removeSignInfoObserver()

void com.autonavi.gbl.pos.PosService.removeSignInfoObserver

(

IPosSignInfoObserver

pObserver

)

删除源始信号观察者

此接口用来删除源始信号观察者

参数

[in]

pObserver

观察者

注解

异步接口，所以外部删除观察者后，如果直接把观察者销毁释放掉可能会导致定位引擎崩溃。应该先销毁定位引擎

thread: mutil

removeSwitchParallelRoadObserver()

void com.autonavi.gbl.pos.PosService.removeSwitchParallelRoadObserver

(

IPosSwitchParallelRoadObserver

pObserver

)

删除切换平行路观察者

此接口用来删除客户端切换平行路观察者

参数

[in]

pObserver

观察者

注解

异步接口，所以外部删除观察者后，如果直接把观察者销毁释放掉可能会导致定位引擎崩溃。应该先销毁定位引擎

thread: mutil

requestCallBackPos()

boolean com.autonavi.gbl.pos.PosService.requestCallBackPos

(

int

nMode

)

主动请求定位引擎回调位置信息

上层通过此接口主动请求引擎回调位置信息，异步方式

参数

[in]

nMode

回调模式：0表示使用历史位置立刻回调 1表示等待新的GPS信号输入后才回调

返回

bool 表示发起请求是当前是否定位成功（如果发请求时还没有有效的GPS输入，则返回false）

注解

thread: mutil

saveLocStorage()

void com.autonavi.gbl.pos.PosService.saveLocStorage

(

)

保存定位上下文信息

定位引擎工作需要有上下文信息，此接口由上层调用，将上下文信息保存在文件(GNaviPosConfig.dat)中，以保持定位所需的上下文信息

注解

异步接口

thread: mutil

setContextPos()

void com.autonavi.gbl.pos.PosService.setContextPos	(	Coord3DDouble	contextPos,
		float	heading
	)

设置客户端保存的最后位置

参数

contextPos	最后位置的经纬度
heading	最后位置的航向

返回

void

注解

仅AUTO侧使用

setDefaultPos()

void com.autonavi.gbl.pos.PosService.setDefaultPos

(

Coord3DDouble

defaultPos

)

设置初始默认位置

设置的默认位置，在本地没有定位上下文时才生效（一般为第一次安装程序）

参数

[in]

dice::Coord3D<double>&

defaultPos 初始默认位置（经纬度坐标）

注解

请在调用 init() 前调用此接口。

thread: mutil

setIssueSubmitInfo()

void com.autonavi.gbl.pos.PosService.setIssueSubmitInfo

(

String

subInfo

)

设置用户上报参数 @detail 设置用户上报问题的类型、上报时间、导航开始和结束时间,没有的参数赋值为-1.

@detail 针对导航中报错，仅有导航开始时间、报错时间 @detail 针对导航结束页报错，仅有导航开始时间、导航结束时间、报错时间 @detail 针对主图和意见与反馈，仅有报错时间和点选内容 info是json串: 键值 描述 数据类型 默认值 备注 issueType 上报类型 int32_t -1 主图：7002，结束导航：-1 submitTime 上报时间(UTC) int64_t -1 单位：毫秒 naviStartTime 导航开始时间(UTC) int64_t -1 单位：毫秒 naviStopTime 导航结束时间(UTC) int64_t -1 单位：毫秒 eg:{"issueType":-1,"submitTime":-1,"naviStartTime":-1,"naviStopTime":-1}

返回

void

setOverheadSwitch()

void com.autonavi.gbl.pos.PosService.setOverheadSwitch

(

boolean

isOpen

)

是否发起气压计辅助高架导航的偏航请求

默认为关闭。无论是否开启该功能，只要有气压计信息输入，内部识别功能都会工作，区别仅仅在于是否触发偏航。

• true：打开气压计高架识别偏航功能
• false：关闭气压计高架识别偏航功能

  注解

  thread: mutil

setSignInfo()

void com.autonavi.gbl.pos.PosService.setSignInfo

(

LocSignData

pLocSignData

)

设置信号信息

给定位服务设置信号信息

参数

[in]

pLocSignData

信号数据

注解

thread: mutil

signalRecordSwitch() [1/3]

void com.autonavi.gbl.pos.PosService.signalRecordSwitch	(	boolean	open,
		boolean	encryption,
		int	logLevel
	)

信号记录功能开关

上层通过此接口控制是否打开定位引擎的信号日志。定位引擎信号日志文件以时间命名，后缀名为loc。
如20170223171307.loc表示2017年2月23日 17点13分07秒开始记录的日志文件。

参数

open	- false：关闭 - true：打开

返回

void

注解

默认情况下，不开启loc文件记录

连续两次设置open等于true会导致引擎内部关闭正在写的文件，重新再开一个文件写日志

异步接口

thread: mutil

signalRecordSwitch() [2/3]

void com.autonavi.gbl.pos.PosService.signalRecordSwitch	(	boolean	open,
		boolean	encryption,
		int	logLevel,
		@LocLogType.LocLogType1 int	logType
	)

信号记录功能开关（老接口，建议使用下面的新的SignalRecordSwitch(bool open, const LocLogConf& conf)）

上层通过此接口控制是否打开定位引擎的信号日志。定位引擎信号日志文件以时间命名，后缀名为loc。
如20170223171307.loc表示2017年2月23日 17点13分07秒开始记录的日志文件。

参数

[in]	open	false：关闭 true：打开
[in]	encryption	false：不加密 true：加密
[in]	logLevel	0：简单定位信息 1：全部信息输出
	logType	LocLogEmpty 输出全部关闭 LocLogLOC, 生成*.loc文件(定位引擎完整信息记录LocLogType::locLogLOC) 默认值 LocLogLOG, 生成*.log文件(定位引擎PDR信息记录LocLogType::locLogLOG)，仅在需要采集PDR数据时使用 注:当前车机端暂不支持pdr,*.log暂时不支持 LocLogALL 同时生成*.loc和*.log 注:当前车机端暂不支持pdr,*.log暂时不支持

注解

默认情况下，不开启loc文件记录

连续两次设置nOpen等于true会导致引擎内部关闭正在写的文件，重新再开一个文件写日志

异步接口

thread: mutil

signalRecordSwitch() [3/3]

void com.autonavi.gbl.pos.PosService.signalRecordSwitch	(	boolean	open,
		LocLogConf	conf
	)

switchParallelRoad()

void com.autonavi.gbl.pos.PosService.switchParallelRoad	(	@LocSwitchRoadType.LocSwitchRoadType1 int	switchRoadType,
		java.math.BigInteger	pstRoadID
	)

     * 

      切换主辅路      *      用户按下界面上的主辅路切换时，客户端通过此接口通知定位引擎开始切换主辅路 
                  导航和巡航的主辅路切换有差异。                   - 导航下的主辅路切换由客户端、引导、定位三个模块共同进行才能完成一次      *             - 巡航下的主辅路切换只由客户端发起，定位内部即可完成切换

参数

switchRoadType

切换路线类型。主路->辅路，辅路->主路，桥上->桥下, 桥下->桥上      *

返回

     void      * 

注解

       pstRoadID道路ID均为0时，定位只需透传切换信息      * 

       异步接口      * 

参见

        GOBJECTID      

unbind()

void com.autonavi.gbl.pos.PosService.unbind ( )

protected

---

该类的文档由以下文件生成:

• PosService.java