腾讯位置服务GPS轨迹录制-安卓篇

前言

在地图的使用中，尤其在导航场景下，进行GPS轨迹录制是十分必要并且有用的，本文会对于安卓系统下的轨迹录制部分做一个分享。

系统架构

对于一个GPSRecordSystem（GPS轨迹录制系统）主要分成3个部分：开始录制，录制GPS定位，结束录制并存储，如上图右方所示。在实际应用中，以导航系统为例：（1）在开始导航时（start navi）,进行录制工作的相关配置；（2）收到安卓系统的onLocationChanged的callback进行GPSLocation的记录；（3）结束导航（stop navi）时，停止记录并存入文件。

相关代码展示

用到的相关变量

	private LocationManager mLocationManager;   // 系统locationManager
	private LocationListener mLocationListener; // 系统locationListener
	
	private boolean mIsRecording = false;       // 是否正在录制 

	private List<String> mGpsList;              // 记录gps的list
	private String mRecordFileName;             // gps文件名称

• 开始录制

开始录制一般是在整个系统工作之初，比如在导航场景下，当“开始导航”时，可以开始进行“startRecordLocation” 的配置

	public void startRecordLocation(Context context, String fileName) {
		// 已经在录制中不进行录制
		if (mIsRecording) {
			return;
		}
		Toast.makeText(context, "start record location...", Toast.LENGTH_SHORT).show();
		
		// 初始化locationManager和locationListener
		mLocationManager = (LocationManager) context.getSystemService(Context.LOCATION_SERVICE);
		mLocationListener = new MyLocationListener();
		try {
			// 添加listener
			mLocationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 0, 0, mLocationListener);
		} catch (SecurityException e) {
			Toast.makeText(context, "start record location error!!!", Toast.LENGTH_SHORT).show();
            Log.e(TAG, "startRecordLocation Exception", e);
			e.printStackTrace();
		}

// 记录文件名称，笔者这里使用“realLocationRecord + routeID”形式进行记录
		mRecordFileName = fileName;
		if (!mRecordFileName.endsWith(".gps")) {
			mRecordFileName += ".gps";
		}

		mIsRecording = true;
	}

• 录制中记录轨迹 记录location一般是在获取安卓系统onLocationChanged回调时调用“recordGPSLocation”

	public void recordGPSLocation(Location location) {
		if (mIsRecording && location != null) {
		// 记录location to list
			mGpsList.add(locationToString(location));
		}
	}

locationToString工具方法

驱动导航工作的GPS轨迹点一般要包含以下几个要素，经度，纬度，精度，角度，速度，时间，海拔高度，所以在此记录下，为后期轨迹回放做准备。

	private String locationToString(Location location) {
		StringBuilder sb = new StringBuilder();
		
		long time = System.currentTimeMillis();
		String timeStr = gpsDataFormatter.format(new Date(time));

		sb.append(location.getLatitude());
		sb.append(",");
		sb.append(location.getLongitude());
		sb.append(",");
		sb.append(location.getAccuracy());
		sb.append(",");
		sb.append(location.getBearing());
		sb.append(",");
		sb.append(location.getSpeed());
		sb.append(",");
		sb.append(timeStr);
		sb.append(",");
		sb.append(df.format((double) time / 1000.0));
		// sb.append(df.format(System.currentTimeMillis()/1000.0));
		// sb.append(df.format(location.getTime()/1000.0));
		sb.append(",");
		sb.append(location.getAltitude());
		sb.append("\n");
		return sb.toString();
	}

• 结束录制并保存gps文件

结束录制一般作用在整个系统的结尾，例如在导航场景下，“结束导航”时停止录制调用“stopRecordLocation”

	public void stopRecordLocation(Context context) {
        Toast.makeText(context, "stop record location, save to file...", Toast.LENGTH_SHORT).show();
        
        // 移除listener
		mLocationManager.removeUpdates(mLocationListener);
		String storagePath = StorageUtil.getStoragePath(context); // 存储的路径
		String filePath = storagePath + mRecordFileName;

		saveGPS(filePath);
		mIsRecording = false;
	}

GPS轨迹存储工具方法

	private void saveGPS(String path) {
		OutputStreamWriter writer = null;
		try {
			File outFile = new File(path);
			File parent = outFile.getParentFile();
			if (parent != null && !parent.exists()) {
				parent.mkdirs();
			}
			OutputStream out = new FileOutputStream(outFile);
			writer = new OutputStreamWriter(out);
			for (String line : mGpsList) {
				writer.write(line);
			}
		} catch (Exception e) {
			Log.e(TAG, "saveGPS Exception", e);
			e.printStackTrace();
		} finally {
			if (writer != null) {
				try {
					writer.flush();
				} catch (IOException e) {
					e.printStackTrace();
					Log.e(TAG, "Failed to flush output stream", e);
				}
				try {
					writer.close();
				} catch (IOException e) {
					e.printStackTrace();
					Log.e(TAG, "Failed to close output stream", e);
				}
			}
		}
	}
	

StorageUtil的getStoragePath工具方法

// 存储在跟路径下/TencentMapSDK/navigation
    private static final String NAVIGATION_PATH = "/tencentmapsdk/navigation";

// getStoragePath工具方法
    public static String getStoragePath(Context context) {
        if (context == null) {
            return null;
        }
        String strFolder;
        boolean hasSdcard;
        try {
            hasSdcard = Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED);
        } catch (Exception e) {
            Log.e(TAG, "getStoragePath Exception", e);
            e.printStackTrace();
            hasSdcard = false;
        }
        if (!hasSdcard) {
            strFolder = context.getFilesDir().getPath() + NAVIGATION_PATH;
            File file = new File(strFolder);
            if (!file.exists()) {
                file.mkdirs();
            }
        } else {
            strFolder = Environment.getExternalStorageDirectory().getPath() + NAVIGATION_PATH;
            File file = new File(strFolder);
            if (!file.exists()) { // 目录不存在，创建目录
                if (!file.mkdirs()) {
                    strFolder = context.getFilesDir().getPath() + NAVIGATION_PATH;
                    file = new File(strFolder);
                    if (!file.exists()) {
                        file.mkdirs();
                    }
                }
            } else { // 目录存在，创建文件测试是否有权限
                try {
                    String newFile = strFolder + "/.test";
                    File tmpFile = new File(newFile);
                    if (tmpFile.createNewFile()) {
                        tmpFile.delete();
                    }
                } catch (IOException e) {
                    e.printStackTrace();
                    Log.e(TAG, "getStoragePath Exception", e);
                    strFolder = context.getFilesDir().getPath() + NAVIGATION_PATH;
                    file = new File(strFolder);
                    if (!file.exists()) {
                        file.mkdirs();
                    }
                }
            }
        }
        return strFolder;
    }

结果展示

最终存储在了手机目录下的navigation目录

后续工作

后续可以对于录制的gps文件讲解在导航场景下进行轨迹回放的分享