public final class TencentLocationRequest
extends java.lang.Object
限定符和类型 | 字段和说明 |
---|---|
static int |
REQUEST_LEVEL_ADMIN_AREA
定位结果信息级别: 3号定位接口, 包含经纬度, 行政区划,位置地址和位置名称.
|
static int |
REQUEST_LEVEL_GEO
定位结果信息级别: 0号定位接口, 仅包含经纬度坐标表示的地位置(经纬度).
|
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()
创建一个缺省的定位请求.
|
android.os.Bundle |
getExtras()
返回 Extra 信息.
|
long |
getInterval()
返回定位周期(位置监听器回调周期), 单位为ms(毫秒).
|
java.lang.String |
getPhoneNumber()
返回电话号码
|
java.lang.String |
getQQ()
返回QQ号.
|
int |
getRequestLevel()
返回定位的request level.
|
java.lang.String |
getSmallAppKey()
返回小程序key.
|
boolean |
isAllowCache()
检查是否允许使用缓存.
|
boolean |
isAllowDirection()
检查是否允许使用设备传感器获取方向
|
boolean |
isAllowGPS()
检查是否允许使用GPS.
|
boolean |
isIndoorLocationMode()
检查是否启动室内定位模式
|
TencentLocationRequest |
setAllowDirection(boolean allowDirection)
设置是否允许使用设备传感器获取方向.
|
TencentLocationRequest |
setAllowGPS(boolean allowGPS)
设置是否允许使用GPS进行定位,默认允许.
|
TencentLocationRequest |
setIndoorLocationMode(boolean indoorLocationMode)
设置启动室内定位
|
TencentLocationRequest |
setInterval(long millis)
设置定位周期(位置监听器回调周期), 单位为 ms (毫秒).
|
TencentLocationRequest |
setPhoneNumber(java.lang.String phoneNumber)
设置电话号.
|
TencentLocationRequest |
setQQ(java.lang.String qq)
设置 QQ 号.
|
TencentLocationRequest |
setRequestLevel(int requestLevel)
设置定位的 request level.
|
TencentLocationRequest |
setSmallAppKey(java.lang.String smallappkey)
设置分渠道的key编码号,例如小程序里面区分业务.
|
java.lang.String |
toString() |
public static final int REQUEST_LEVEL_GEO
public static final int REQUEST_LEVEL_NAME
public static final int REQUEST_LEVEL_ADMIN_AREA
public static final int REQUEST_LEVEL_POI
public TencentLocationRequest(TencentLocationRequest request)
public static void copy(TencentLocationRequest to, TencentLocationRequest from)
完成复制后, 目标请求 to 的各参数和源请求 from 相同.
to
- 目标请求from
- 源请求public static TencentLocationRequest create()
缺省定位请求各参数如下:
REQUEST_LEVEL_NAME
public TencentLocationRequest setInterval(long millis)
当定位周期大于0时, 不论是否有得到新的定位结果, 位置监听器都会按定位周期定时被回调; 当定位周期等于0时, 仅当有新的定位结果时, 位置监听器才会被回调(即, 回调时机存在不确定性). 如果需要周期性回调, 建议将 定位周期 设置为 5000-10000ms
注意:
millis
- 定位周期java.lang.IllegalArgumentException
- 设置的定位周期为负public TencentLocationRequest setRequestLevel(int requestLevel)
不同的 request level 得到的定位结果信息完整程度不同. 通常, 定位结果中所含信息越多消耗的流量也越多, 请选择合理的 request level 以节省流量.
requestLevel
- java.lang.IllegalArgumentException
- Request Level 为非法值REQUEST_LEVEL_GEO
,
REQUEST_LEVEL_NAME
,
REQUEST_LEVEL_ADMIN_AREA
,
REQUEST_LEVEL_POI
public TencentLocationRequest setAllowGPS(boolean allowGPS)
如果允许使用GPS,在室外可提升定位精度(约3~10米),GPS首次获取位置较慢且耗电较高
allowGPS
- public TencentLocationRequest setAllowDirection(boolean allowDirection)
注意: 通过本方法获取的方向可用于指南针方向, 这个方向不同于GPS定位时得到的 bearing.
allowDirection
- public TencentLocationRequest setIndoorLocationMode(boolean indoorLocationMode)
public TencentLocationRequest setQQ(java.lang.String qq)
若您的应用能提供 QQ 号, 强烈建议提供 QQ 号, 有助于我们改进腾讯相关服务.
qq
- public TencentLocationRequest setSmallAppKey(java.lang.String smallappkey)
若您的应用能提供该次定位的场景标志, 强烈建议提供, 定位服务可根据key值,提供定位个性化服务.
smallappkey
- public java.lang.String getSmallAppKey()
public java.lang.String getQQ()
public TencentLocationRequest setPhoneNumber(java.lang.String phoneNumber)
public java.lang.String getPhoneNumber()
public long getInterval()
public int getRequestLevel()
public boolean isAllowCache()
public boolean isAllowGPS()
public boolean isIndoorLocationMode()
public boolean isAllowDirection()
public android.os.Bundle getExtras()
public java.lang.String toString()
toString
在类中 java.lang.Object