com.tencent.map.geolocation
接口 TencentLocation

public interface TencentLocation

地理位置.

地理位置由经度, 纬度, 高度, 精度组成, 可能还包含名字, 地址等其他可选信息.

作者：

kingcmchen@tencent.com

字段摘要

static int	ERROR_BAD_JSON 错误码, 表示 GPS, Wi-Fi 或基站错误引起的定位失败.
static int	ERROR_NETWORK 错误码, 表示网络问题引起的定位失败.
static int	ERROR_OK 错误码, 表示定位成功.
static int	ERROR_UNKNOWN 错误码, 表示未知原因引起的定位失败.
static int	ERROR_WGS84 错误码, 表示无法进行坐标转换引起的定位失败.
static java.lang.String	EXTRA_ADDRDESP_LANDMARK key, 用于获取一级地标(可识别性较强、规模较大的地点、小区等), 仅用于5号定位接口.
static java.lang.String	EXTRA_ADDRDESP_OTHERS_RESULTS key, 用于获取其他结果, 仅用于5号定位接口.
static java.lang.String	EXTRA_ADDRDESP_SECOND_LANDMARK key, 用于获取二级地标(较一级地标更为精确，规模更小), 仅用于5号定位接口.
static java.lang.String	EXTRA_DIRECTION key, 用于获取设备方向.
static java.lang.String	GPS_PROVIDER 位置来源, GPS location provider.
static java.lang.String	NETWORK_PROVIDER 位置来源, Network location provider.

方法摘要

float	getAccuracy() 返回当前位置的精度.
java.lang.String	getAddress() 返回当前位置的地址.
double	getAltitude() 返回当前位置的海拔, 单位为m(米), 仅当位置来自GPS时可能有效.
java.lang.Integer	getAreaStat() 返回当前位置的行政区划.
float	getBearing() 返回当前位置方向, 单位为度, 仅当位置来自GPS时可能有效.
java.lang.String	getCity() 返回当前位置的城市.
java.lang.String	getCityCode() 返回当前位置的城市编码.
java.lang.String	getDistrict() 返回当前位置的区县.
long	getElapsedRealtime() 返回当前位置的生成时间(从设备启动时开始算起).
Bundle	getExtra() 返回当前位置相关的某些其他信息, 某个特定的字符串为 key.
double	getLatitude() 返回当前位置的纬度.
double	getLongitude() 返回当前位置的经度.
java.lang.String	getName() 返回当前位置的名称.
java.lang.String	getNation() 返回当前位置的国家.
java.util.List<TencentPoi>	getPoiList() 返回当前位置周围的 POI.
java.lang.String	getProvider() 返回当前位置的来源.
java.lang.String	getProvince() 返回当前位置的省份.
float	getSpeed() 返回移动速度, 单位为m/s (米/秒), 仅当位置来自GPS时可能有效.
java.lang.String	getStreet() 返回当前位置的街道.
java.lang.String	getStreetNo() 返回当前位置的街道编号.
long	getTime() 返回当前位置的生成时间.
java.lang.String	getTown() 返回当前位置的乡镇.
java.lang.String	getVillage() 返回当前位置的村.

字段详细信息

GPS_PROVIDER

static final java.lang.String GPS_PROVIDER

位置来源, GPS location provider.

NETWORK_PROVIDER

static final java.lang.String NETWORK_PROVIDER

位置来源, Network location provider.

EXTRA_ADDRDESP_OTHERS_RESULTS

static final java.lang.String EXTRA_ADDRDESP_OTHERS_RESULTS

key, 用于获取其他结果, 仅用于5号定位接口.

用法:

 String key = TencentLocation.EXTRA_ADDRDESP_OTHERS_RESULTS;
 ArrayList<TencentAddress> value = tencentLocation.getExtra().getParcelableArrayList(key);
 

使用场景: getAddress() 不满足需求时可使用其他结果自行进行拼接, 获取到的其他结果为 TencentAddress 的 ArrayList, 列表中的元素分别代表:

• ST_NO - 门牌
• FAMOUS_AREA - 知名区域，如商圈或人们普遍认为有较高知名度的区域
• ST - 街道
• RD_CROSS - 交叉路口

请参考 TencentAddress#getDtype()

另请参见：

常量字段值

EXTRA_ADDRDESP_LANDMARK

static final java.lang.String EXTRA_ADDRDESP_LANDMARK

key, 用于获取一级地标(可识别性较强、规模较大的地点、小区等), 仅用于5号定位接口.

用法:

 String key = TencentLocation.EXTRA_ADDRDESP_LANDMARK;
 TencentAddress value = tencentLocation.getExtra().getParcelable(key);
 

另请参见：

常量字段值

EXTRA_ADDRDESP_SECOND_LANDMARK

static final java.lang.String EXTRA_ADDRDESP_SECOND_LANDMARK

key, 用于获取二级地标(较一级地标更为精确，规模更小), 仅用于5号定位接口.

用法:

 String key = TencentLocation.EXTRA_ADDRDESP_SECOND_LANDMARK;
 TencentAddress value = tencentLocation.getExtra().getParcelable(key);
 

另请参见：

常量字段值

EXTRA_DIRECTION

static final java.lang.String EXTRA_DIRECTION

key, 用于获取设备方向.

用法:

 String key = TencentLocation.EXTRA_DIRECTION;
 double value = tencentLocation.getExtra().getDouble(key);
 

另请参见：

TencentLocationRequest#setAllowDirection}, 常量字段值

ERROR_OK

static final int ERROR_OK

错误码, 表示定位成功.

另请参见：

常量字段值

ERROR_NETWORK

static final int ERROR_NETWORK

错误码, 表示网络问题引起的定位失败.

另请参见：

常量字段值

ERROR_BAD_JSON

static final int ERROR_BAD_JSON

错误码, 表示 GPS, Wi-Fi 或基站错误引起的定位失败.

另请参见：

常量字段值

ERROR_WGS84

static final int ERROR_WGS84

错误码, 表示无法进行坐标转换引起的定位失败.

注意: 仅出现在需要将WGS84坐标转换成GCJ-02坐标时的情形

另请参见：

常量字段值

ERROR_UNKNOWN

static final int ERROR_UNKNOWN

错误码, 表示未知原因引起的定位失败.

另请参见：

常量字段值

方法详细信息

getProvider

java.lang.String getProvider()

返回当前位置的来源.

返回：

provider 的名字, 可能为 null

另请参见：

#GPS_PROVIDER}, #NETWORK_PROVIDER}

getLatitude

double getLatitude()

返回当前位置的纬度.

getLongitude

double getLongitude()

返回当前位置的经度.

getAltitude

double getAltitude()

返回当前位置的海拔, 单位为m(米), 仅当位置来自GPS时可能有效.

返回：

0, 如果无法得到海拔

getAccuracy

float getAccuracy()

返回当前位置的精度.

通常精度为, GPS：<20米，WiFi：30-180米，基站：150-800米.

getName

java.lang.String getName()

返回当前位置的名称.

返回：

位置名称, 仅当 request level 为 TencentLocationRequest.REQUEST_LEVEL_NAME, 否则返回 null

getAddress

java.lang.String getAddress()

返回当前位置的地址.

返回：

位置地址, 仅当 request level 为 TencentLocationRequest.REQUEST_LEVEL_NAME, 否则返回 null

getNation

java.lang.String getNation()

返回当前位置的国家.

返回：

国家, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getProvince

java.lang.String getProvince()

返回当前位置的省份.

返回：

省份, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getCity

java.lang.String getCity()

返回当前位置的城市.

返回：

城市, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getDistrict

java.lang.String getDistrict()

返回当前位置的区县.

返回：

区县, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getTown

java.lang.String getTown()

返回当前位置的乡镇.

返回：

乡镇, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getVillage

java.lang.String getVillage()

返回当前位置的村.

返回：

村, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getStreet

java.lang.String getStreet()

返回当前位置的街道.

返回：

街道, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getStreetNo

java.lang.String getStreetNo()

返回当前位置的街道编号.

返回：

街道编号, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getAreaStat

java.lang.Integer getAreaStat()

返回当前位置的行政区划.

返回：

0-表示国内(中国大陆), 1-表示国外

getPoiList

java.util.List<TencentPoi> getPoiList()

返回当前位置周围的 POI.

返回：

周围的POI, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 时才有效, 否则返回空的列表

getBearing

float getBearing()

返回当前位置方向, 单位为度, 仅当位置来自GPS时可能有效.

返回：

0, 如果无法得到方向

另请参见：

Location#getBearing()}

getSpeed

float getSpeed()

返回移动速度, 单位为m/s (米/秒), 仅当位置来自GPS时可能有效.

返回：

0, 如果无法得到速度

另请参见：

Location#getSpeed()}

getTime

long getTime()

返回当前位置的生成时间.

另请参见：

System#currentTimeMillis()}

getElapsedRealtime

long getElapsedRealtime()

返回当前位置的生成时间(从设备启动时开始算起).

另请参见：

SystemClock#elapsedRealtime()}

getCityCode

java.lang.String getCityCode()

返回当前位置的城市编码.

返回：

城市编码, 当 request level 为 TencentLocationRequest.REQUEST_LEVEL_POI 或 TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA 否则返回 null

getExtra

Bundle getExtra()

返回当前位置相关的某些其他信息, 某个特定的字符串为 key.

当允许获取设备方向时可通过以下key访问额外信息:

• EXTRA_DIRECTION: 获取设备方向, 结果类型为 double

当 request level 为 5号接口时可通过以下 key 访问额外信息:

• EXTRA_ADDRDESP_OTHERS_RESULTS: 获取其他结果, 结果类型为 ArrayList<TencentAddress>
• EXTRA_ADDRDESP_LANDMARK: 获取一级地标, 结果类型为 TencentAddress
• EXTRA_ADDRDESP_SECOND_LANDMARK: 获取二级地标, 结果类型为 TencentAddress