com.tencent.map.geolocation
类 TencentLocationRequest

java.lang.Object
  com.tencent.map.geolocation.TencentLocationRequest

public final class TencentLocationRequest
extends java.lang.Object

定位请求, 客户端使用本类指定定位周期等参数.

版本：

3.0

作者：

kingcmchen@tencent.com

字段摘要

static int	REQUEST_LEVEL_ADMIN_AREA 定位结果信息级别: 3号定位接口, 包含经纬度, 行政区划.
static int	REQUEST_LEVEL_FORMATTED_ADDRESS 定位结果信息级别: 5号定位接口, 包含经经纬度, 位置描述, 附近的POI.
static int	REQUEST_LEVEL_GEO 定位结果信息级别: 0号定位接口, 仅包含经纬度坐标表示的地位置(经纬度).
static int	REQUEST_LEVEL_GLOBAL_ADMIN_AREA 定位结果信息级别: 7号定位接口, 包含经纬度, 国际行政区划的位置, 部分国家与地区无法得到行政区划.
static int	REQUEST_LEVEL_NAME 定位结果信息级别: 1号定位接口, 包含经纬度, 位置名称, 位置地址.
static int	REQUEST_LEVEL_POI 定位结果信息级别: 4号定位接口, 包含经纬度, 行政区划, 附近的POI.

构造方法摘要

TencentLocationRequest(TencentLocationRequest request)

方法摘要

static void	copy(TencentLocationRequest to, TencentLocationRequest from) 复制定位请求.
static TencentLocationRequest	create() 创建一个缺省的定位请求.
Bundle	getExtras() 返回 Extra 信息.
long	getInterval() 返回定位周期(位置监听器回调周期), 单位为ms(毫秒).
java.lang.String	getPhoneNumber() 返回电话号码
java.lang.String	getQQ() 返回QQ号.
int	getRequestLevel() 返回定位的request level.
boolean	isAllowCache() 检查是否允许使用缓存.
boolean	isAllowDirection() 检查是否允许使用设备传感器获取方向
TencentLocationRequest	setAllowCache(boolean allowCache) 设置是否允许使用缓存.
TencentLocationRequest	setAllowDirection(boolean allowDirection) 设置是否允许使用设备传感器获取方向.
TencentLocationRequest	setInterval(long millis) 设置定位周期(位置监听器回调周期), 单位为 ms (毫秒).
TencentLocationRequest	setPhoneNumber(java.lang.String phoneNumber) 设置电话号.
TencentLocationRequest	setQQ(java.lang.String qq) 设置 QQ 号.
TencentLocationRequest	setRequestLevel(int requestLevel) 设置定位的 request level.
java.lang.String	toString()

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

REQUEST_LEVEL_GEO

public static final int REQUEST_LEVEL_GEO

定位结果信息级别: 0号定位接口, 仅包含经纬度坐标表示的地位置(经纬度).

另请参见：

常量字段值

REQUEST_LEVEL_NAME

public static final int REQUEST_LEVEL_NAME

定位结果信息级别: 1号定位接口, 包含经纬度, 位置名称, 位置地址.

另请参见：

常量字段值

REQUEST_LEVEL_ADMIN_AREA

public static final int REQUEST_LEVEL_ADMIN_AREA

定位结果信息级别: 3号定位接口, 包含经纬度, 行政区划.

另请参见：

常量字段值

REQUEST_LEVEL_POI

public static final int REQUEST_LEVEL_POI

定位结果信息级别: 4号定位接口, 包含经纬度, 行政区划, 附近的POI.

另请参见：

常量字段值

REQUEST_LEVEL_FORMATTED_ADDRESS

public static final int REQUEST_LEVEL_FORMATTED_ADDRESS

定位结果信息级别: 5号定位接口, 包含经经纬度, 位置描述, 附近的POI.

另请参见：

常量字段值

REQUEST_LEVEL_GLOBAL_ADMIN_AREA

public static final int REQUEST_LEVEL_GLOBAL_ADMIN_AREA

定位结果信息级别: 7号定位接口, 包含经纬度, 国际行政区划的位置, 部分国家与地区无法得到行政区划.

另请参见：

常量字段值

构造方法详细信息

TencentLocationRequest

public TencentLocationRequest(TencentLocationRequest request)

方法详细信息

copy

public static void copy(TencentLocationRequest to,
                        TencentLocationRequest from)

复制定位请求.

完成复制后, 目标请求 to 的各参数和源请求 from 相同.

参数：

to - 目标请求

from - 源请求

create

public static TencentLocationRequest create()

创建一个缺省的定位请求.

缺省定位请求各参数如下:

• 定位周期(位置监听器回调周期): 10s
• Request Level: REQUEST_LEVEL_NAME
• 缓存: 允许使用缓存
• 设备方向: 不允许获取设备方向
• QQ号: 空字符串

setInterval

public TencentLocationRequest setInterval(long millis)

设置定位周期(位置监听器回调周期), 单位为 ms (毫秒).

当定位周期大于0时, 不论是否有得到新的定位结果, 位置监听器都会按定位周期定时被回调; 当定位周期等于0时, 仅当有新的定位结果时, 位置监听器才会被回调(即, 回调时机存在不确定性). 如果需要周期性回调, 建议将 定位周期 设置为 5000-10000ms

注意:

• 不建议将 定位周期 设置为 1000ms 以下
• 不保证(尤其不保证设备休眠情况下)定位周期的绝对精确, 客户端业务不应依赖这里的定位周期.

参数：

millis - 定位周期

抛出：

java.lang.IllegalArgumentException - 设置的定位周期为负

setRequestLevel

public TencentLocationRequest setRequestLevel(int requestLevel)

设置定位的 request level.

不同的 request level 得到的定位结果信息完整程度不同. 通常, 定位结果中所含信息越多消耗的流量也越多, 请选择合理的 request level 以节省流量.

参数：

requestLevel -

抛出：

java.lang.IllegalArgumentException - Request Level 为非法值

另请参见：

REQUEST_LEVEL_GEO, REQUEST_LEVEL_NAME, REQUEST_LEVEL_ADMIN_AREA, REQUEST_LEVEL_POI

setAllowCache

public TencentLocationRequest setAllowCache(boolean allowCache)

设置是否允许使用缓存.

如果允许使用缓存, 用户移动范围较小的情况下可以有效减少网络请求, 节省电量和流量. 长时间连续定位时建议允许使用缓存, 单次定位时建议不使用缓存

参数：

allowCache -

setAllowDirection

public TencentLocationRequest setAllowDirection(boolean allowDirection)

设置是否允许使用设备传感器获取方向.

注意: 通过本方法获取的方向可用于指南针方向, 这个方向不同于GPS定位时得到的 bearing.

参数：

allowDirection -

setQQ

public TencentLocationRequest setQQ(java.lang.String qq)

设置 QQ 号.

若您的应用能提供 QQ 号, 强烈建议提供 QQ 号, 有助于我们改进腾讯相关服务.

参数：

qq -

getQQ

public java.lang.String getQQ()

返回QQ号.

setPhoneNumber

public TencentLocationRequest setPhoneNumber(java.lang.String phoneNumber)

设置电话号.

getPhoneNumber

public java.lang.String getPhoneNumber()

返回电话号码

getInterval

public long getInterval()

返回定位周期(位置监听器回调周期), 单位为ms(毫秒).

getRequestLevel

public int getRequestLevel()

返回定位的request level.

isAllowCache

public boolean isAllowCache()

检查是否允许使用缓存.

isAllowDirection

public boolean isAllowDirection()

检查是否允许使用设备传感器获取方向

getExtras

public Bundle getExtras()

返回 Extra 信息.

toString

public java.lang.String toString()

覆盖：

类 java.lang.Object 中的 toString