到顶部
Android API
公众的

位置管理器

延伸对象
java.lang.Object对象
   ↳ android位置。位置管理器

课程概述

此类提供对系统位置服务的访问。这些服务允许应用程序定期更新设备的地理位置,或触发指定的应用程序意图当设备接近给定的地理位置。

你没有直接实例化这个类;相反,通过检索Context.getSystemService(Context.LOCATION_SERVICE).

除非另有说明,否则所有位置API方法都需要这个访问_角色_位置ACCESS_FINE_LOCATION(访问线路_位置)权限。如果您的应用程序只有粗略权限,那么它将没有访问GPS或被动位置提供商。其他提供商仍将返回位置结果,但更新速度将受到限制位置将被模糊到一个粗略的精确度水平。

总结

常量
字符串 GPS_提供商 GPS位置提供商的名称。
字符串 钥匙位置已更改 用于额外持有仓位值的捆绑包的密钥使用PendingIntent广播位置更改时。
字符串 钥匙_遥控器_启用 用于保存布尔状态值的Bundle额外项的键当使用PendingIntent广播提供者启用/禁用的事件时。
字符串 钥匙_接近_进入 用于Bundle额外保存布尔值的键,指示是否接近警报正在进入(true)或退出(false)。。
字符串 键_状态_已更改 用于保存Integer状态值的Bundle额外项的键使用PendingIntent广播状态更改时。
字符串 模式更改操作 广播意图操作位置_模式变化。
字符串 网络_提供者 网络位置提供商的名称。
字符串 被动_提供商 一个特殊的位置提供程序,用于接收位置,而无需实际启动定位装置。
字符串 提供商更改操作 配置位置提供程序时的广播意图操作更改。
公共方法
布尔值 添加GpsStatusListener(Gps状态。监听器监听器)
添加GPS状态侦听器。
布尔值 addNmeaListener(添加网络监听程序)(Gps状态。Nmea监听器监听器)
添加NMEA侦听器。
无效 添加接近警报(双纬度、双经度、浮动半径、长期有效期、,处理意图意图)
为位置给定的位置设置接近警报(纬度、经度)和给定半径。
无效 添加测试提供程序(字符串名称,布尔要求网络,布尔要求卫星,布尔要求单元格,布尔hasMonetaryCost,布尔支持高度,布尔支持速度,布尔支持轴承,int powerRequirement,int accuracy)
创建模拟位置提供程序并将其添加到活动提供程序集。
无效 已启用清除测试提供程序(字符串提供商)
删除与给定提供程序关联的任何模拟启用值。
无效 清除测试提供程序位置(字符串提供商)
删除与给定提供程序关联的任何模拟位置。
无效 清除测试提供程序状态(字符串提供商)
删除与给定提供程序关联的所有模拟状态值。
列表<字符串> 获取所有提供程序()
返回所有已知位置提供程序的名称列表。
字符串 获得最佳提供商(标准条件,仅启用布尔值)
返回最符合给定条件的提供程序的名称。
Gps状态 获取GpsStatus(Gps状态状态)
检索有关GPS引擎当前状态的信息。
位置 获取最新已知位置(字符串提供商)
返回一个位置,指示来自上一个已知位置的数据从给定提供程序获取的位置修复。
位置提供者 获取提供程序(字符串名称)
返回与的位置提供程序关联的信息给定名称,如果不存在使用该名称的提供程序,则为null。
列表<字符串> 获取提供程序(仅启用布尔值)
返回位置提供程序的名称列表。
列表<字符串> 获取提供程序(标准条件,仅启用布尔值)
返回满足给定条件,如果没有,则为null。
布尔值 已启用isProvider(字符串提供商)
返回给定提供程序的当前启用/禁用状态。
无效 删除GpsStatusListener(Gps状态。监听器监听器)
删除GPS状态侦听器。
无效 删除NmeaListener(Gps状态。Nmea监听器监听器)
删除NMEA侦听器。
无效 删除接近警报(处理意图意图)
删除具有给定PendingIntent的接近警报。
无效 删除测试提供程序(字符串提供商)
删除具有给定名称的模拟位置提供程序。
无效 删除更新(处理意图意图)
删除指定待定意图的所有位置更新。
无效 删除更新(LocationListener(位置侦听器)监听器)
删除指定LocationListener的所有位置更新。
无效 请求位置更新(长minTime,浮点minDistance,标准标准,处理意图意图)
使用标准和待定意图注册位置更新。
无效 请求位置更新(长minTime,浮点minDistance,标准标准,LocationListener(位置侦听器)倾听者,活套活套)
使用条件和回调注册位置更新在指定的活套螺纹上。
无效 请求位置更新(字符串提供者,long minTime,float minDistance,LocationListener(位置侦听器)监听器)
使用命名提供程序注册位置更新待定意图。
无效 请求位置更新(字符串提供者,long minTime,float minDistance,LocationListener(位置侦听器)倾听者,活套活套)
使用命名提供程序注册位置更新,并在指定的活套线程。
无效 请求位置更新(字符串提供者,long minTime,float minDistance,处理意图意图)
使用命名提供程序注册位置更新待定意图。
无效 请求单个更新(字符串供应商,LocationListener(位置侦听器)倾听者,活套活套)
使用命名提供程序和回调。
无效 请求单个更新(标准标准,LocationListener(位置侦听器)倾听者,活套活套)
使用标准和回调。
无效 请求单个更新(字符串供应商,处理意图意图)
使用命名提供程序和待定意图注册单个位置更新。
无效 请求单个更新(标准标准,处理意图意图)
使用标准和待定意图注册单个位置更新。
布尔值 sendExtra命令(字符串供应商,字符串命令,捆绑额外费用)
向位置提供程序发送其他命令。
无效 已启用setTestProvider(字符串提供程序,启用布尔值)
为给定提供程序设置模拟启用值。
无效 设置测试提供程序位置(字符串供应商,位置位置)
为给定提供程序设置模拟位置。
无效 设置测试提供程序状态(字符串provider,int状态,捆绑额外,长更新时间)
设置给定提供程序的模拟状态值。
[展开]
继承的方法
来自班级java.lang.Object对象

常量

公众静态最终的字符串 GPS_提供商

已在中添加API级别1

GPS位置提供商的名称。

此提供程序使用确定位置卫星。根据情况,此提供商可能需要一段时间才能返回定位装置。需要许可ACCESS_FINE_LOCATION(访问线路_位置).

GPS位置提供商的附加捆绑包可以包含以下键/值对:

  • 卫星数-用于导出定位的卫星数

常量值: “全球定位系统”

公众静态最终的字符串 钥匙位置已更改

用于额外捆绑保存位置值的密钥使用PendingIntent广播位置更改时。

常量值: “位置”

公众静态最终的字符串 钥匙_遥控器_启用

用于保存布尔状态值的Bundle额外项的键当使用PendingIntent广播提供者启用/禁用的事件时。

常量值: “提供商已启用”

公众静态最终的字符串 钥匙_接近_进入

已在中添加API级别1

用于Bundle额外保存布尔值的键,指示是否接近警报正在进入(true)或退出(false)。。

常量值: “进入”

公众静态最终的字符串 键_状态_已更改

用于保存Integer状态值的Bundle额外项的键使用PendingIntent广播状态更改时。

常量值: “状态”

公众静态最终的字符串 模式更改操作

已在中添加API等级19

广播意图操作位置_模式变化。用于位置模式应用程序编程接口。如果您与isProviderEnabled(字符串),使用提供商更改操作而不是。未来,可能会有模式更改,但不会导致提供商更改操作广播。

常量值: “android.location.MODE_CHANGED”

公众静态最终的字符串 网络_提供者

已在中添加API级别1

网络位置提供商的名称。

此提供程序根据手机塔和WiFi接入点的可用性。检索结果通过网络查找。

常量值: “网络”

公众静态最终的字符串 被动_提供商

已在中添加API级别8

一种特殊的位置提供程序,用于在不实际启动的情况下接收位置定位装置。

此提供程序可用于被动接收位置更新当其他应用程序或服务在没有实际请求的情况下请求它们时你自己的位置。此提供程序将返回由其他提供程序。您可以查询获取提供者()确定方法位置更新的来源。需要许可ACCESS_FINE_LOCATION(访问线路_位置),尽管GPS是未启用此提供程序可能只返回粗略修复。

常量值: “被动”

公众静态最终的字符串 提供商更改操作

已在中添加API级别9

配置位置提供程序时的广播意图操作更改。用于isProviderEnabled(字符串)。如果您正在与位置_模式API,使用模式更改操作而不是。

常量值: “android.location.PROVIDERS_CHANGED”

公共方法

公众布尔值 添加GpsStatusListener (Gps状态。监听器监听器)

添加GPS状态侦听器。

参数
听众 要注册的GPS状态侦听器对象
退换商品
  • 如果成功添加侦听器,则为true
投掷
安全例外 如果ACCESS_FINE_LOCATION权限不存在

公众布尔值 addNmeaListener(添加网络监听程序) (Gps状态。Nmea监听器监听器)

已在中添加API级别5

添加NMEA侦听器。

参数
听众 Gps状态。Nmea监听器要注册的对象
退换商品
  • 如果成功添加侦听器,则为true
投掷
安全例外 如果ACCESS_FINE_LOCATION权限不存在

公众无效 添加ProximityAlert (双纬度、双经度、浮动半径、长期有效期、,处理意图意图)

已在中添加API级别1

为位置给定的位置设置接近警报(纬度、经度)和给定半径。

当设备检测到它已进入或退出位置,给定的PendingIntent将用于创建Intent被解雇。

激发的Intent将添加一个带有键的额外布尔值钥匙_接近_进入。如果值为true,则设备为进入邻近区域;如果为false,则表示它正在退出。

由于位置估计的近似性质,如果设备短暂通过给定区域,这是可能的不会解雇任何意向。类似地,意向可以是如果设备经过离给定区域很近但实际上并没有输入它。

过期给定的毫秒数之后参数,位置管理器将删除此邻近警报,不再监视它。值-1表示应该没有过期时间。

在内部,此方法同时使用网络_提供者GPS_提供商.

在API版本17之前,此方法可以与ACCESS_FINE_LOCATION(访问线路_位置)访问_角色_位置.从API版本17及更高版本开始,此方法需要ACCESS_FINE_LOCATION(访问线路_位置)许可。

参数
纬度 中心点的纬度警报区域
经度 中心点的经度警报区域
半径 中心点的半径报警区域,单位:米
到期 此接近警报的时间(毫秒),或-1表示没有过期
意图 将用于生成意向的PendingIntent当检测到进入或离开警戒区时开火

公众无效 addTest提供程序 (字符串名称,布尔要求网络,布尔要求卫星,布尔要求单元格,布尔hasMonetaryCost,布尔支持高度,布尔支持速度,布尔支持轴承,int powerRequirement,int accuracy)

创建模拟位置提供程序并将其添加到活动提供程序集。

参数
名称 提供程序名称
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置未启用系统设置
非法数据异常 如果具有给定名称的提供程序已存在

公众无效 已启用清除测试提供程序 (字符串提供商)

删除与给定提供程序关联的任何模拟启用值。

参数
供应商 提供程序名称
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置}未启用系统设置
非法数据异常 如果不存在具有给定名称的提供程序

公众无效 清除测试提供程序位置 (字符串提供商)

删除与给定提供程序关联的任何模拟位置。

参数
供应商 提供程序名称
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置}未启用系统设置
非法数据异常 如果不存在具有给定名称的提供程序

公众无效 清除测试提供程序状态 (字符串提供商)

删除与给定提供程序关联的所有模拟状态值。

参数
提供者 提供程序名称
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置}未启用系统设置
非法数据异常 如果不存在具有给定名称的提供程序

公众的列表<字符串> 获取所有提供程序 ()

已在中添加API级别1

返回所有已知位置提供程序的名称列表。

返回所有提供程序,包括不允许返回的提供程序被调用活动访问或当前被禁用。

退换商品
  • 包含提供者名称的字符串列表

公众的字符串 获得最佳提供商 (标准条件,仅启用布尔值)

已在中添加API级别1

返回最符合给定条件的提供程序的名称。仅提供程序允许调用活动访问的返回。如果有几个供应商符合标准,那么最好的供应商返回准确度。如果没有供应商符合标准,标准按以下顺序放宽:

  • 功率要求
  • 精确
  • 轴承
  • 速度
  • 海拔高度

注意,对货币成本的要求没有删除在这个过程中。

参数
标准 需要匹配的标准
仅启用 如果为true,则只返回当前启用的提供程序
退换商品
  • 最符合要求的提供商的名称

公众的Gps状态 获取GpsStatus (Gps状态状态)

检索有关GPS引擎当前状态的信息。只能从onGpsStatusChanged(int)回调以确保数据以原子方式复制。调用方可以传入Gps状态对象设置为最新状态信息,或传递null以创建新的Gps状态对象。

参数
地位 包含GPS状态详细信息的对象,或为空。
退换商品
  • 包含更新的GPS状态的status对象。

公众的位置 获取最新已知位置 (字符串提供者)

已在中添加API级别1

返回一个位置,指示来自上一个已知位置的数据从给定提供程序获取的位置修复。

这是可以做到的而不启动提供程序。请注意,此位置可以过时,例如,如果设备已关闭并且已移动到其他位置。

如果提供程序当前被禁用,则返回null。

参数
提供者 提供者的名称
退换商品
  • 提供程序的最后已知位置,或为null
投掷
安全例外 如果没有适当的许可
非法数据异常 如果提供程序为空或不存在

公众的位置提供者 获取提供者 (字符串名称)

已在中添加API级别1

返回与的位置提供程序关联的信息给定名称,如果不存在使用该名称的提供程序,则为null。

参数
名称 提供程序名称
退换商品
  • LocationProvider或null
投掷
非法数据异常 如果名称为空或不存在
安全例外 如果不允许调用方访问给定的提供程序。

公众的列表<字符串> 获取提供程序 (仅启用布尔值)

已在中添加API级别1

返回位置提供程序的名称列表。

参数
仅启用 如果为true,则仅显示当前返回enabled。
退换商品
  • 包含提供者名称的字符串列表

公众的列表<字符串> 获取提供程序 (标准条件,仅启用布尔值)

已在中添加API级别1

返回满足给定条件,如果没有,则为null。仅允许将返回调用活动访问的。

参数
标准 返回的提供程序必须匹配的条件
仅启用 如果为true,则仅显示当前返回enabled。
退换商品
  • 包含提供程序名称的字符串列表

公众布尔值 已启用isProvider (字符串提供商)

已在中添加API级别1

返回给定提供程序的当前启用/禁用状态。

如果用户已在“设置”菜单中启用此提供程序,则为true返回,否则返回false

呼叫方应改用位置_模式除非它们依赖于特定于提供者的API,例如requestLocationUpdates(字符串、长、浮点、LocationListener).

参数
供应商 提供者的名称
退换商品
  • 如果提供程序存在并且已启用,则为true
投掷
非法数据异常 如果提供程序为空
安全例外 如果没有适当的许可

公众无效 删除GpsStatusListener (Gps状态。监听器监听器)

删除GPS状态侦听器。

参数
听众 要删除的GPS状态侦听器对象

公众无效 删除NmeaListener (Gps状态。Nmea监听器监听器)

已在中添加API级别5

删除NMEA侦听器。

参数
听众 Gps状态。Nmea监听器要删除的对象

公众无效 删除接近警报 (处理意图意图)

已在中添加API级别1

删除具有给定PendingIntent的接近警报。

在API版本17之前,此方法可以与ACCESS_FINE_LOCATION(访问线路_位置)访问_角色_位置.从API版本17及更高版本开始,此方法需要ACCESS_FINE_LOCATION(访问线路_位置)许可。

参数
意图 不再需要通知的PendingIntent接近警报
投掷
非法数据异常 如果意图为空
安全例外 如果ACCESS_FINE_LOCATION(访问线路_位置)权限不存在

公众无效 删除测试提供程序 (字符串提供商)

删除具有给定名称的模拟位置提供程序。

参数
供应商 提供程序名称
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置}未启用系统设置
非法数据异常 如果不存在具有给定名称的提供程序

公众无效 删除更新 (处理意图意图)

删除指定挂起意图的所有位置更新。

在此调用后,将不再更新此待定意图。

参数
意图 不再需要位置更新的挂起意向对象
投掷
非法数据异常 如果意图为空

公众无效 删除更新 (LocationListener(位置侦听器)监听器)

已在中添加API级别1

删除指定LocationListener的所有位置更新。

此次通话后,更新将不再此侦听器发生。

参数
听众 不再需要位置更新的侦听器对象
投掷
非法数据异常 如果侦听器为空

公众无效 请求位置更新 (长minTime,浮动minDistance,标准标准,处理意图意图)

已在中添加API级别9

使用标准和待定意图注册位置更新。

这个请求位置更新()请求单个更新()将当前活动注册为由命名的提供程序或由匹配的提供程序定期更新指定的标准,具有位置和状态更新。

接收第一次位置更新可能需要一些时间。如果需要一个直接的位置,应用程序可以使用getLastKnownLocation(字符串)方法。

位置更新由以下任一方接收LocationListener(位置侦听器)回调,或通过广播意图处理意图.

如果调用方提供了待定意图,则位置会更新用密钥发送钥匙位置已更改和a位置值。

可以使用minTime参数控制位置更新间隔。位置更新之间的时间间隔永远不会小于minTime,尽管它可能更依赖于位置提供程序实现和其他应用程序请求的更新间隔。

为minTime选择一个合理的值对于保存电池寿命。每次位置更新都需要电源GPS、WIFI、Cell和其他无线电设备。选择一个高达在提供合理用户体验的同时,这也是可能的。如果您的应用程序不在前台并显示则应用程序应避免使用活动提供者(例如网络提供者GPS_提供商),但如果您坚持,请选择最小时间5*60*1000(5分钟)或更高。如果您的应用程序位于前台并显示位置,然后选择一个更快的更新间隔。

minDistance参数还可用于控制位置更新的频率。如果它大于0,则位置提供商只会在以下情况下向您的应用程序发送更新位置至少更改了minDistance米,并且已超过至少minTime毫秒。然而,它是更多的位置提供商很难使用minDistance节省电力参数,所以minTime应该是节约电池的主要工具生活。

如果应用程序想被动地观察位置由其他应用程序触发的更新,但不使用否则,请使用被动_提供商此提供程序不会主动打开或修改活动位置提供程序,所以您不需要对minTime和最小距离。但是,如果应用程序执行繁重的工作在位置更新(例如网络活动)时,您应该为minTime和/或minDistance选择非零值以进行速率限制如果另一个应用程序启用具有极快更新的位置提供商。

如果用户禁用了提供程序,则更新将停止,并发送提供商可用性更新。一旦再次启用提供程序,位置更新将立即恢复,提供商可用已发送更新。提供商还可以随时发送状态更新,提供特定于提供商的额外服务。如果提供了回调然后通过以下方式更新状态和可用性onProviderDisabled(字符串),onProviderEnabled(字符串)onStatusChanged(字符串,int,捆绑)。或者,如果提供了待定意图,然后更新了状态和可用性广播意图是否有额外的键钥匙_遥控器_启用键_状态_已更改.

如果LocationListener(位置侦听器)已使用,但未指定Looper那么调用线程必须已经成为活套螺纹,例如调用Activity。如果使用LocationListener(位置侦听器)然后在提供的Looper线程上进行回调。

在使用Jellybean之前,minTime参数是只有一个提示,而一些位置提供程序实现忽略了它。从Jellybean及以后,它是Android兼容的必备功能设备来观察minTime和minDistance参数。

参数
最小时间 位置更新之间的最小时间间隔(毫秒)
最小距离 位置更新之间的最小距离(米)
标准 包含位置管理器选择计算位置的适当提供者和参数
意图 处理意图每次位置更新时发送
投掷
非法数据异常 如果条件为空
非法数据异常 如果意图为空
安全例外 如果没有适当的许可

公众无效 请求位置更新 (长minTime,浮点minDistance,标准标准,LocationListener(位置侦听器)倾听者,活套活套)

已在中添加API级别9

使用条件和回调注册位置更新在指定的活套线程上。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
最小时间 位置更新之间的最小时间间隔(毫秒)
最小距离 位置更新之间的最小距离(米)
标准 包含位置管理器选择计算位置的适当提供者和参数
听众 LocationListener(位置侦听器)谁的onLocationChanged(位置)方法将被调用每次位置更新
活套 其消息队列将用于的Looper对象实现回调机制,或使用null对调用进行回调线
投掷
非法数据异常 如果条件为空
非法数据异常 如果侦听器为空
安全例外 如果没有合适的许可

公众无效 请求位置更新 (字符串提供者,long minTime,float minDistance,LocationListener(位置侦听器)监听器)

已在中添加API级别1

使用命名提供程序注册位置更新待定意图。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
提供者 要注册的提供程序的名称
最小时间 位置更新之间的最小时间间隔(毫秒)
最小距离 位置更新之间的最小距离(米)
听众 LocationListener(位置侦听器)谁的onLocationChanged(位置)方法将被调用每次位置更新
投掷
非法数据异常 如果提供程序为空或不存在在此设备上
非法数据异常 如果侦听器为空
运行期异常 如果调用线程没有Looper
安全例外 如果没有适当的许可

公众无效 请求位置更新 (字符串提供者,long minTime,float minDistance,LocationListener(位置侦听器)倾听者,活套活套)

已在中添加API级别1

使用命名提供程序注册位置更新,并在指定的活套线程。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
供应商 要注册的提供程序的名称
最小时间 位置更新之间的最小时间间隔(毫秒)
最小距离 位置更新之间的最小距离(米)
听众 LocationListener(位置侦听器)谁的onLocationChanged(位置)方法将被调用每次位置更新
活套 其消息队列将用于的Looper对象实现回调机制,或使用null对调用进行回调线
投掷
非法数据异常 如果提供程序为空或不存在
非法数据异常 如果侦听器为null
安全例外 如果没有适当的许可

公众无效 请求位置更新 (字符串提供者,long minTime,float minDistance,处理意图意图)

使用命名提供程序注册位置更新待定意图。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
供应商 要注册的提供程序的名称
最小时间 位置更新之间的最小时间间隔(毫秒)
最小距离 位置更新之间的最小距离(米)
意图 处理意图每次位置更新时发送
投掷
非法数据异常 如果提供程序为空或不存在在此设备上
非法数据异常 如果意图为空
安全例外 如果没有适当的许可

公众无效 请求单个更新 (字符串供应商,LocationListener(位置侦听器)倾听者,活套活套)

已在中添加API级别9

使用命名提供程序和回调。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
供应商 要注册的提供程序的名称
听众 LocationListener(位置侦听器)谁的onLocationChanged(位置)方法将在以下情况下调用位置更新可用
活套 其消息队列将用于的Looper对象实现回调机制,或使用null对调用进行回调线
投掷
非法数据异常 如果提供程序为空或不存在
非法数据异常 如果侦听器为空
安全例外 如果没有适当的许可

公众无效 请求单个更新 (标准标准,LocationListener(位置侦听器)倾听者,活套活套)

已在中添加API级别9

使用条件和注册单个位置更新回调。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
标准 包含位置管理器选择计算位置的适当提供者和参数
听众 LocationListener(位置侦听器)谁的onLocationChanged(位置)方法将在以下情况下调用位置更新可用
活套 其消息队列将用于的Looper对象实现回调机制,或使用null对调用进行回调线
投掷
非法数据异常 如果条件为空
非法数据异常 如果侦听器为空
安全例外 如果没有适当的许可

公众无效 请求单个更新 (字符串供应商,处理意图意图)

已在中添加API级别9

使用命名提供程序和待定意图注册单个位置更新。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
供应商 要注册的提供程序的名称
意图 处理意图发送以进行位置更新
投掷
非法数据异常 如果提供程序为空或不存在
非法数据异常 如果意图为空
安全例外 如果没有适当的许可

公众无效 请求单个更新 (标准标准,处理意图意图)

已在中添加API级别9

使用标准和待定意图注册单个位置更新。

请参见requestLocationUpdates(long、float、Criteria、PendingIntent)有关如何使用此方法的更多详细信息。

参数
标准 包含位置管理器选择的参数计算位置的适当提供者和参数
意图 处理意图发送以进行位置更新
投掷
非法数据异常 如果提供程序为空或不存在
非法数据异常 如果意图为空
安全例外 如果没有适当的许可

公众布尔值 sendExtra命令 (字符串供应商,字符串命令,捆绑额外费用)

向位置提供程序发送其他命令。可用于支持特定于提供程序的Location Manager API扩展

参数
供应商 位置提供程序的名称。
命令 要发送给提供程序的命令的名称。
额外费用 命令的可选参数(或null)。提供者可以选择用命令的结果填充额外的Bundle。
退换商品
  • 如果命令成功,则为true。

公众无效 已启用setTestProvider (字符串提供程序,启用布尔值)

为给定提供程序设置模拟启用值。此值将就地使用提供程序的任何实际值。

参数
供应商 提供程序名称
启用 模拟启用值
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置}未启用系统设置
非法数据异常 如果不存在具有给定名称的提供程序

公众无效 设置测试提供程序位置 (字符串供应商,位置位置)

为给定提供程序设置模拟位置。

此位置将取代提供商的任何实际位置。位置对象的字段数必须至少设置为根据文档,被视为有效的LocationProvider位置位置类。

参数
供应商 提供程序名称
位置 模拟位置
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置}未启用系统设置
非法数据异常 如果不存在具有给定名称的提供程序
非法数据异常 如果位置不完整

公众无效 设置测试提供程序状态 (字符串提供程序,int状态,捆绑额外,长更新时间)

设置给定提供程序的模拟状态值。这些值将就地使用提供程序的任何实际值。

参数
供应商 提供程序名称
地位 模拟状态
额外费用 包含模拟附加功能的捆绑包
更新时间 模拟更新时间
投掷
安全例外 如果ACCESS_MOCK_LOCATION权限不存在设置。安全。允许_锁定_位置}未启用系统设置
非法数据异常 如果不存在具有给定名称的提供程序