com.tencent.map.geolocation

接口 TencentLocationListener

public interface TencentLocationListener

位置监听器.

定位 SDK 通过位置监听器将位置变化通知给客户端.

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	CELL 设备名, Cell.
static java.lang.String	GPS 设备名, GPS.
static java.lang.String	RADIO 已过时。
static int	STATUS_DENIED 状态码, 位置权限被拒绝，通常由于LBE类似的管理软件禁止了app的定位权限.
static int	STATUS_DISABLED 状态码, 代表设备(wifi、基站、GPS)已关闭.
static int	STATUS_ENABLED 状态码, 代表设备(wifi、基站、GPS)已开启(开启并不意味着可用).
static int	STATUS_GPS_AVAILABLE 状态码，GPS可用，代表GPS开关打开，且搜星定位成功
static int	STATUS_GPS_UNAVAILABLE 状态码，GPS不可用，不可用有多种可能，比如GPS开关被关闭，GPS开关开着但是没办法搜到卫星等等
static int	STATUS_LOCATION_SWITCH_OFF 状态码，表示位置服务开关未打开
static int	STATUS_UNKNOWN 状态码, 未知状态.
static java.lang.String	WIFI 设备名, WiFi.

方法概要

限定符和类型	方法和说明
void	onLocationChanged(TencentLocation location, int error, java.lang.String reason) 位置发生变化.
void	onStatusUpdate(java.lang.String name, int status, java.lang.String desc) GPS, WiFi, Radio 等状态发生变化.

字段详细资料

GPS

static final java.lang.String GPS

设备名, GPS.

另请参阅:

常量字段值

WIFI

static final java.lang.String WIFI

设备名, WiFi.

另请参阅:

常量字段值

RADIO

@Deprecated
static final java.lang.String RADIO

已过时。

设备名, 基站信号.

另请参阅:

CELL, 常量字段值

CELL

static final java.lang.String CELL

设备名, Cell.

另请参阅:

常量字段值

STATUS_DISABLED

static final int STATUS_DISABLED

状态码, 代表设备(wifi、基站、GPS)已关闭.

另请参阅:

常量字段值

STATUS_ENABLED

static final int STATUS_ENABLED

状态码, 代表设备(wifi、基站、GPS)已开启(开启并不意味着可用).

另请参阅:

常量字段值

STATUS_DENIED

static final int STATUS_DENIED

状态码, 位置权限被拒绝，通常由于LBE类似的管理软件禁止了app的定位权限.

注意: 位置权限被拒绝通常发生在禁用当前应用的 ACCESS_COARSE_LOCATION 等定位权限

另请参阅:

常量字段值

STATUS_GPS_AVAILABLE

static final int STATUS_GPS_AVAILABLE

状态码，GPS可用，代表GPS开关打开，且搜星定位成功

另请参阅:

常量字段值

STATUS_GPS_UNAVAILABLE

static final int STATUS_GPS_UNAVAILABLE

状态码，GPS不可用，不可用有多种可能，比如GPS开关被关闭，GPS开关开着但是没办法搜到卫星等等

另请参阅:

常量字段值

STATUS_LOCATION_SWITCH_OFF

static final int STATUS_LOCATION_SWITCH_OFF

状态码，表示位置服务开关未打开

另请参阅:

常量字段值

STATUS_UNKNOWN

static final int STATUS_UNKNOWN

状态码, 未知状态.

另请参阅:

常量字段值

方法详细资料

onLocationChanged

void onLocationChanged(TencentLocation location,
                       int error,
                       java.lang.String reason)

位置发生变化.

参数:

location - 新的位置, *可能*来自缓存. 定位失败时 location 无效或者为 null

error - 错误码, 仅当错误码为 TencentLocation.ERROR_OK 时表示定位成功, 为其他值时表示定位失败

reason - 错误描述, 简要描述错误原因

另请参阅:

TencentLocation.ERROR_BAD_JSON, TencentLocation.ERROR_NETWORK, TencentLocation.ERROR_OK, TencentLocation.ERROR_UNKNOWN

onStatusUpdate

void onStatusUpdate(java.lang.String name,
                    int status,
                    java.lang.String desc)

GPS, WiFi, Radio 等状态发生变化.

参数:

name - 设备名, GPS, WIFI, CELL 中的某个

status - 状态码, STATUS_ENABLED, STATUS_DISABLED, STATUS_UNKNOWN, STATUS_GPS_AVAILABLE, STATUS_GPS_UNAVAILABLE, STATUS_DENIED中的某个 在使用status之前,请先按照name进行区分

desc - 状态描述

另请参阅:

GPS, WIFI, CELL