public class LocationProvider
extends Object
java.lang.Object | |
↳ | android.location.LocationProvider |
位置提供者的抽象超类。 位置提供者提供关于设备的地理位置的定期报告。
每个提供者都有一套可以使用它的标准; 例如,一些提供商需要GPS硬件和多个卫星的可视性; 其他人则需要使用蜂窝无线电,或访问特定运营商的网络或访问互联网。 它们也可能具有不同的电池消耗特性或用户的货币成本。 Criteria
类允许根据用户指定的标准来选择提供者。
Constants |
|
---|---|
int |
AVAILABLE |
int |
OUT_OF_SERVICE |
int |
TEMPORARILY_UNAVAILABLE |
Public methods |
|
---|---|
int |
getAccuracy() 返回描述此提供者水平精度的常量。 |
String |
getName() 返回此提供者的名称。 |
int |
getPowerRequirement() 返回此提供商的功率要求。 |
boolean |
hasMonetaryCost() 如果使用此提供程序可能会对用户收取费用,则返回true,如果使用空闲,则返回false。 |
boolean |
meetsCriteria(Criteria criteria) 如果此提供程序符合给定条件,则返回true,否则返回false。 |
boolean |
requiresCell() 如果提供者需要访问适当的蜂窝网络(例如,使用信元塔ID),则返回true,否则返回false。 |
boolean |
requiresNetwork() 如果提供者需要访问数据网络(例如Internet),则返回true,否则返回false。 |
boolean |
requiresSatellite() 如果提供者需要访问基于卫星的定位系统(例如GPS),则返回true,否则返回false。 |
boolean |
supportsAltitude() 如果提供者能够提供高度信息,则返回true,否则返回false。 |
boolean |
supportsBearing() 如果提供者能够提供方位信息,则返回true,否则返回false。 |
boolean |
supportsSpeed() 如果提供者能够提供速度信息,则返回true,否则返回false。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
int getAccuracy ()
返回描述此提供者水平精度的常量。 如果提供者返回更细粒度或确切位置,则返回ACCURACY_FINE
,否则,如果位置仅为近似值,则返回ACCURACY_COARSE
。
Returns | |
---|---|
int |
int getPowerRequirement ()
返回此提供商的功率要求。
Returns | |
---|---|
int |
the power requirement for this provider, as one of the constants Criteria.POWER_REQUIREMENT_*. |
boolean hasMonetaryCost ()
如果使用此提供程序可能会对用户收取费用,则返回true,如果使用空闲,则返回false。 每个提供商都要提供准确的信息。
Returns | |
---|---|
boolean |
boolean meetsCriteria (Criteria criteria)
如果此提供程序符合给定条件,则返回true,否则返回false。
Parameters | |
---|---|
criteria |
Criteria
|
Returns | |
---|---|
boolean |
boolean requiresCell ()
如果提供者需要访问适当的蜂窝网络(例如,使用信元塔ID),则返回true,否则返回false。
Returns | |
---|---|
boolean |
boolean requiresNetwork ()
如果提供者需要访问数据网络(例如Internet),则返回true,否则返回false。
Returns | |
---|---|
boolean |
boolean requiresSatellite ()
如果提供者需要访问基于卫星的定位系统(例如GPS),则返回true,否则返回false。
Returns | |
---|---|
boolean |
boolean supportsAltitude ()
如果提供者能够提供高度信息,则返回true,否则返回false。 在大多数情况下报告海拔高度但偶尔不报告的提供商应该返回true。
Returns | |
---|---|
boolean |
boolean supportsBearing ()
如果提供者能够提供方位信息,则返回true,否则返回false。 在大多数情况下报告承重,但可能偶尔不报告的提供商应该返回true。
Returns | |
---|---|
boolean |
boolean supportsSpeed ()
如果提供者能够提供速度信息,则返回true,否则返回false。 在大多数情况下报告速度但偶尔可能不报告的提供商应该返回true。
Returns | |
---|---|
boolean |