Android(安卓)位置服务

Android 位置 API 使您可以轻松构建位置感知应用程序,而无需关注底层位置技术的细节。

这在 Google Play 服务 的帮助下成为可能,该服务通过自动位置跟踪、地理围栏和活动识别为您的应用程序添加位置感知。

本教程向您展示如何在 APP 中使用位置服务来获取当前位置、定期更新位置、查找地址等。


Location 对象

Location 对象表示一个地理位置,它可以由纬度、经度、时间戳和其他信息(如方位角、高度和速度)组成。

有以下重要方法可以用于 Location 对象以获取特定于位置的信息:

编号方法 & 描述
1

float distanceTo(Location dest)

返回此位置与给定位置之间的近似距离(米)。

2

float getAccuracy()

获取此位置的估计精度,单位为米。

3

double getAltitude()

获取海拔高度(如有),以海平面以上米为单位。

4

float getBearing()

以度为单位获取方位角。

5

double getLatitude()

获取纬度,单位为度。

6

double getLongitude()

获取经度,单位为度。

7

float getSpeed()

获取速度(如果可用),以米/秒为单位。

8

boolean hasAccuracy()

如果此位置具有准确性,则为 True

9

boolean hasAltitude()

如果此位置具有海拔高度,则为 True

10

boolean hasBearing()

如果此位置具有方位角,则为 True

11

boolean hasSpeed()

如果此位置具有速度,则为 True

12

void reset()

清除位置的内容。

13

void setAccuracy(float accuracy)

设置此位置的估计精度,米。

14

void setAltitude(double altitude)

设置海拔高度,以海平面以上米为单位。

15

void setBearing(float bearing)

设置方位角,以度为单位。

16

void setLatitude(double latitude)

设置纬度,单位为度。

17

void setLongitude(double longitude)

设置经度,单位为度。

18

void setSpeed(float speed)

设置地面上的速度(米/秒)。

19

String toString()

返回一个字符串,该字符串包含此对象的简明、可读的描述。


获取当前位置

要获取当前位置,请创建一个 LocationClient 对象的位置客户端,使用 connect() 方法将其连接到LocationServices,然后调用其 getLastLocation() 方法。此方法以 location 对象的形式返回最近的位置,该对象包含纬度和经度坐标以及如上所述的其他信息。要在活动中具有基于位置的功能,您必须实现两个接口:

  • GooglePlayServicesClient.ConnectionCallbacks
  • GooglePlayServicesClient.OnConnectionFailedListener

这些接口提供了以下重要的回调方法,您需要在活动类中实现这些方法:

编号回调方法 & 描述
1

abstract void onConnected(Bundle connectionHint)

当位置服务成功连接到位置客户端时,将调用此回调方法您将使用 connect() 方法连接到位置客户端

2

abstract void onDisconnected()

当客户端断开连接时调用此回调方法您将使用 disconnect() 方法断开与位置客户端的连接。

3

abstract void onConnectionFailed(ConnectionResult result)

当将客户端连接到服务时发生错误时,将调用此回调方法。

您应该在活动类的 onCreate() 方法中创建位置客户端,然后在 onStart() 中将其连接,以便位置服务在您的活动完全可见时维护当前位置。您应该使用 onStop() 方法断开客户端连接,以便在看不到您的应用程序时,位置服务不会维护当前位置。这样可以最大程度地节省电池电量。

获取更新的位置

如果您愿意进行位置更新,那么除了上述接口之外,您还需要实现 LocationListener 接口。此接口提供以下回调方法,您需要在活动类中实现:

编号回调方法 & 描述
1

abstract void onLocationChanged(Location location)

此回调方法用于在位置发生更改时从 LocationClient 接收通知。


位置服务质量

LocationRequest 对象用于向 LocationClient 请求位置更新的服务质量(QoS)。您可以使用以下有用的 setter 方法来处理 QoS。您可以在 Android 官方文档中查看等效的 getter 方法。

编号方法 & 描述
1

setExpirationDuration(long millis)

设置此请求的持续时间(毫秒)。

2

setExpirationTime(long millis)

设置启动后的请求过期时间(毫秒)。

3

setFastestInterval(long millis)

显式设置位置更新的最快间隔(毫秒)。

4

setInterval(long millis)

设置活动位置更新的所需间隔(毫秒)。

5

setNumUpdates(int numUpdates)

设置位置更新的次数。

6

setPriority(int priority)

设置请求的优先级。

例如,如果您的应用程序想要高精度定位,它应该创建一个定位请求,setPriority(int) 设置为 PRIORITY_high_accuracysetInterval(long) 设置为 5 秒。您还可以使用更大的间隔和/或其他优先级,如 PRIORITY_LOW_POWER 来请求 “城市” 级别的精度,或 PRIORITIY_BALANCED_POWER_accuracy 来请求 "街道" 级别的精度。

注意:建议 活动 应在进入后台时删除所有位置请求(例如在 onPause()),或至少将请求切换到更大的间隔和更低的质量以节省功耗。

显示位置地址

一旦有了 Location 对象,就可以使用 Geocoder.getFromLocation() 方法获取给定纬度和经度的地址。这个方法是同步的,可能需要很长时间才能完成其工作,因此您应该使用 AsyncTask 类的 doInBackground() 方法调用该方法。

必须对 AsyncTask 进行子类化才能使用,子类将重写 doInBackground(Params…) 方法以在后台执行任务,并在后台计算完成后在UI线程上调用onPostExecute(Result) 方法以显示结果。AyncTask 中还有一个更重要的方法是 execute(Params…Params),该方法使用指定的参数执行任务。


实例

下面的示例向您展示了如何在应用程序中使用位置服务来获取当前位置及其等效地址等。

提示:为了实验这个例子,您需要实际的移动设备配备最新的 Android 操作系统,否则您使用模拟器可能会出问题。

创建 Android 应用程序
步骤描述
1您将使用 Android studio IDE 创建一个 Android 应用程序,并在 com.example.demo.myapplication 包下将其命名为 myapplication。
2添加 src/GPSTracker.java 文件以及必要代码。
3修改 src/MainActivity.ava f文件并添加所需的代码,如下所示,以获取当前位置及其等效地址。
4修改布局 XML 文件 res/layout/activity_main.xml 添加包括 3 个按钮和两个文本视图的所有 GUI 组件以显示位置/地址。
5修改 res/values/strings.xml 定义必要常量。
6修改 AndroidManifest.xml 文件。
7运行应用程序以启动 Android 模拟器并验证应用程序中所做更改的结果。

下面是修改的主活动文件 MainActivity.java 的内容:

  1. package com.example.demo.myapplication;
  2. import android.Manifest;
  3. import android.app.Activity;
  4. import android.os.Bundle;
  5. import android.support.v4.app.ActivityCompat;
  6. import android.test.mock.MockPackageManager;
  7. import android.view.View;
  8. import android.widget.Button;
  9. import android.widget.Toast;
  10. public class MainActivity extends Activity {
  11. Button btnShowLocation;
  12. private static final int REQUEST_CODE_PERMISSION = 2;
  13. String mPermission = Manifest.permission.ACCESS_FINE_LOCATION;
  14. // GPSTracker class
  15. GPSTracker gps;
  16. @Override
  17. public void onCreate(Bundle savedInstanceState) {
  18. super.onCreate(savedInstanceState);
  19. setContentView(R.layout.activity_main);
  20. try {
  21. if (ActivityCompat.checkSelfPermission(this, mPermission)
  22. != MockPackageManager.PERMISSION_GRANTED) {
  23. ActivityCompat.requestPermissions(this, new String[]{mPermission},
  24. REQUEST_CODE_PERMISSION);
  25. // 如果用户不允许上述任何权限,则此条件将每次都执行,否则你的其他部分代码将起作用
  26. }
  27. } catch (Exception e) {
  28. e.printStackTrace();
  29. }
  30. btnShowLocation = (Button) findViewById(R.id.button);
  31. // 显示位置按钮单击事件
  32. btnShowLocation.setOnClickListener(new View.OnClickListener() {
  33. @Override
  34. public void onClick(View arg0) {
  35. // 创建类对象
  36. gps = new GPSTracker(MainActivity.this);
  37. // 检查 GPS 是否可用
  38. if(gps.canGetLocation()){
  39. double latitude = gps.getLatitude();
  40. double longitude = gps.getLongitude();
  41. // \n 是换行
  42. Toast.makeText(getApplicationContext(), "Your Location is - \nLat: "
  43. + latitude + "\nLong: " + longitude, Toast.LENGTH_LONG).show();
  44. }else{
  45. // 无法获取定位
  46. // GPS 或网络未启用
  47. // 要求用户在设置中启用 GPS/网络
  48. gps.showSettingsAlert();
  49. }
  50. }
  51. });
  52. }
  53. }

下面是修改的主活动文件 GPSTracker.java 的内容:

  1. package com.example.demo.myapplication;
  2. import android.app.AlertDialog;
  3. import android.app.Service;
  4. import android.content.Context;
  5. import android.content.DialogInterface;
  6. import android.content.Intent;
  7. import android.location.Location;
  8. import android.location.LocationListener;
  9. import android.location.LocationManager;
  10. import android.os.Bundle;
  11. import android.os.IBinder;
  12. import android.provider.Settings;
  13. import android.util.Log;
  14. public class GPSTracker extends Service implements LocationListener {
  15. private final Context mContext;
  16. // GPS 状态标识
  17. boolean isGPSEnabled = false;
  18. // 网络状态标识
  19. boolean isNetworkEnabled = false;
  20. // 是否能获取位置标识
  21. boolean canGetLocation = false;
  22. Location location; // 位置
  23. double latitude; // 纬度
  24. double longitude; // 经度
  25. // 更改更新的最小距离(米)
  26. private static final long MIN_DISTANCE_CHANGE_FOR_UPDATES = 10; // 10 meters
  27. // 更新之间的最短时间(毫秒)
  28. private static final long MIN_TIME_BW_UPDATES = 1000 * 60 * 1; // 1 minute
  29. // 声明位置管理器
  30. protected LocationManager locationManager;
  31. public GPSTracker(Context context) {
  32. this.mContext = context;
  33. getLocation();
  34. }
  35. public Location getLocation() {
  36. try {
  37. locationManager = (LocationManager) mContext.getSystemService(LOCATION_SERVICE);
  38. // 获取 GPS 状态
  39. isGPSEnabled = locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER);
  40. // 获取网络状态
  41. isNetworkEnabled = locationManager
  42. .isProviderEnabled(LocationManager.NETWORK_PROVIDER);
  43. if (!isGPSEnabled && !isNetworkEnabled) {
  44. // 网络不可用
  45. } else {
  46. this.canGetLocation = true;
  47. // 首先通过网络基站获取位置
  48. if (isNetworkEnabled) {
  49. locationManager.requestLocationUpdates(
  50. LocationManager.NETWORK_PROVIDER,
  51. MIN_TIME_BW_UPDATES,
  52. MIN_DISTANCE_CHANGE_FOR_UPDATES, this);
  53. Log.d("Network", "Network");
  54. if (locationManager != null) {
  55. location = locationManager
  56. .getLastKnownLocation(LocationManager.NETWORK_PROVIDER);
  57. if (location != null) {
  58. latitude = location.getLatitude();
  59. longitude = location.getLongitude();
  60. }
  61. }
  62. }
  63. // 如果启用 GPS,则使用 GPS 服务获取经纬度
  64. if (isGPSEnabled) {
  65. if (location == null) {
  66. locationManager.requestLocationUpdates(
  67. LocationManager.GPS_PROVIDER,
  68. MIN_TIME_BW_UPDATES,
  69. MIN_DISTANCE_CHANGE_FOR_UPDATES, this);
  70. Log.d("GPS Enabled", "GPS Enabled");
  71. if (locationManager != null) {
  72. location = locationManager
  73. .getLastKnownLocation(LocationManager.GPS_PROVIDER);
  74. if (location != null) {
  75. latitude = location.getLatitude();
  76. longitude = location.getLongitude();
  77. }
  78. }
  79. }
  80. }
  81. }
  82. } catch (Exception e) {
  83. e.printStackTrace();
  84. }
  85. return location;
  86. }
  87. /**
  88. * 停止使用 GPS 监听器
  89. * 调用此函数将停止在应用程序中使用 GPS
  90. * */
  91. public void stopUsingGPS(){
  92. if(locationManager != null){
  93. locationManager.removeUpdates(GPSTracker.this);
  94. }
  95. }
  96. /**
  97. * 获取纬度的函数
  98. * */
  99. public double getLatitude(){
  100. if(location != null){
  101. latitude = location.getLatitude();
  102. }
  103. // 返回纬度
  104. return latitude;
  105. }
  106. /**
  107. * 获取纬度的经度
  108. * */
  109. public double getLongitude(){
  110. if(location != null){
  111. longitude = location.getLongitude();
  112. }
  113. // 返回经度
  114. return longitude;
  115. }
  116. /**
  117. * 检查 GPS/wifi 是否可用的函数
  118. * @return boolean
  119. * */
  120. public boolean canGetLocation() {
  121. return this.canGetLocation;
  122. }
  123. /**
  124. * 用于显示设置警报对话框的功能
  125. * 按下设置按钮将启动设置选项
  126. * */
  127. public void showSettingsAlert(){
  128. AlertDialog.Builder alertDialog = new AlertDialog.Builder(mContext);
  129. // 设置对话框标题
  130. alertDialog.setTitle("GPS is settings");
  131. // 设置对话框信息
  132. alertDialog.setMessage("GPS is not enabled. Do you want to go to settings menu?");
  133. // 按下设置按钮时
  134. alertDialog.setPositiveButton("Settings", new DialogInterface.OnClickListener() {
  135. public void onClick(DialogInterface dialog,int which) {
  136. Intent intent = new Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS);
  137. mContext.startActivity(intent);
  138. }
  139. });
  140. // 按下取消按钮时
  141. alertDialog.setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
  142. public void onClick(DialogInterface dialog, int which) {
  143. dialog.cancel();
  144. }
  145. });
  146. // 弹出提示
  147. alertDialog.show();
  148. }
  149. @Override
  150. public void onLocationChanged(Location location) {
  151. }
  152. @Override
  153. public void onProviderDisabled(String provider) {
  154. }
  155. @Override
  156. public void onProviderEnabled(String provider) {
  157. }
  158. @Override
  159. public void onStatusChanged(String provider, int status, Bundle extras) {
  160. }
  161. @Override
  162. public IBinder onBind(Intent arg0) {
  163. return null;
  164. }
  165. }

下面是 res/layout/activity_main.xml 文件的内容:

  1. <?xml version = "1.0" encoding = "utf-8"?>
  2. <LinearLayout xmlns:android = "http://schemas.android.com/apk/res/android"
  3. android:layout_width = "fill_parent"
  4. android:layout_height = "fill_parent"
  5. android:orientation = "vertical" >
  6. <Button
  7. android:id = "@+id/button"
  8. android:layout_width = "fill_parent"
  9. android:layout_height = "wrap_content"
  10. android:text = "getlocation"/>
  11. </LinearLayout>

下面是 res/values/strings.xml 文件,定义了两个常量:

  1. <?xml version = "1.0" encoding = "utf-8"?>
  2. <resources>
  3. <string name = "app_name">myapplication</string>
  4. </resources>

下面是默认的 AndroidManifest.xml 文件:

  1. <?xml version = "1.0" encoding = "utf-8"?>
  2. <manifest xmlns:android = "http://schemas.android.com/apk/res/android"
  3. package = "com.example.demo.myapplication">
  4. <uses-permission android:name = "android.permission.ACCESS_FINE_LOCATION" />
  5. <uses-permission android:name = "android.permission.INTERNET" />
  6. <application
  7. android:allowBackup = "true"
  8. android:icon = "@mipmap/ic_launcher"
  9. android:label = "@string/app_name"
  10. android:supportsRtl = "true"
  11. android:theme = "@style/AppTheme">
  12. <activity android:name = ".MainActivity">
  13. <intent-filter>
  14. <action android:name = "android.intent.action.MAIN" />
  15. <category android:name = "android.intent.category.LAUNCHER" />
  16. </intent-filter>
  17. </activity>
  18. </application>
  19. </manifest>

让我们尝试运行 My Application 应用程序。假设您已经将实际的 Android 移动设备与计算机连接。要从 Android Studio 运行应用程序,请打开项目的 activity 文件之一,然后单击工具栏上的运行 Eclipse Eclipse Run Icon 图标。在启动应用程序之前,Android studio 安装程序将显示以下窗口,以选择要运行 Android 应用程序的选项。

现在要查看位置,请选择 Get Location 按钮,该按钮将显示如下位置信息: