获取数据
有多种方法可以获取收集到的位置数据。下面介绍了两种方法,用于获取用于 Roads API 的沿实际道路功能的数据。
GPX
GPX 是一种基于 Open XML 的格式,用于共享 GPS 设备捕获的路线、轨迹和航点。此示例使用 XmlPull 解析器,这是一种适用于 Java 服务器和移动环境的轻量级 XML 解析器。
/** * Parses the waypoint (wpt tags) data into native objects from a GPX stream. */ private List<LatLng> loadGpxData(XmlPullParser parser, InputStream gpxIn) throws XmlPullParserException, IOException { // We use a List<> as we need subList for paging later List<LatLng> latLngs = new ArrayList<>(); parser.setInput(gpxIn, null); parser.nextTag(); while (parser.next() != XmlPullParser.END_DOCUMENT) { if (parser.getEventType() != XmlPullParser.START_TAG) { continue; } if (parser.getName().equals("wpt")) { // Save the discovered latitude/longitude attributes in each <wpt>. latLngs.add(new LatLng( Double.valueOf(parser.getAttributeValue(null, "lat")), Double.valueOf(parser.getAttributeValue(null, "lon")))); } // Otherwise, skip irrelevant data } return latLngs; }
以下是一些加载到地图上的原始 GPX 数据。
Android 位置信息服务
从 Android 设备捕获 GPS 数据的最佳方法因您的用例而异。请查看有关接收位置信息更新的 Android 培训课程,以及 GitHub 上的 Google Play 位置信息示例。
处理长路径
由于道路紧贴功能会根据完整路径(而不是单个点)推断位置,因此您在处理长路径(即超过 100 点/请求限制的路径)时需要格外小心。
为了将各个请求视为一条长路径,您应该添加一些重叠,以便将上一个请求的最终点作为后续请求的第一个点包含在内。要包含的点数量取决于数据的准确度。对于准确率较低的请求,您应该添加更多数据点。
此示例使用适用于 Google 地图服务的 Java 客户端发送分页请求,然后将数据(包括插值点)重新联接到返回的列表中。
/** * Snaps the points to their most likely position on roads using the Roads API. */ private List<SnappedPoint> snapToRoads(GeoApiContext context) throws Exception { List<SnappedPoint> snappedPoints = new ArrayList<>(); int offset = 0; while (offset < mCapturedLocations.size()) { // Calculate which points to include in this request. We can't exceed the API's // maximum and we want to ensure some overlap so the API can infer a good location for // the first few points in each request. if (offset > 0) { offset -= PAGINATION_OVERLAP; // Rewind to include some previous points. } int lowerBound = offset; int upperBound = Math.min(offset + PAGE_SIZE_LIMIT, mCapturedLocations.size()); // Get the data we need for this page. LatLng[] page = mCapturedLocations .subList(lowerBound, upperBound) .toArray(new LatLng[upperBound - lowerBound]); // Perform the request. Because we have interpolate=true, we will get extra data points // between our originally requested path. To ensure we can concatenate these points, we // only start adding once we've hit the first new point (that is, skip the overlap). SnappedPoint[] points = RoadsApi.snapToRoads(context, true, page).await(); boolean passedOverlap = false; for (SnappedPoint point : points) { if (offset == 0 || point.originalIndex >= PAGINATION_OVERLAP - 1) { passedOverlap = true; } if (passedOverlap) { snappedPoints.add(point); } } offset = upperBound; } return snappedPoints; }
下面是运行道路吸附请求后由以上生成的数据。红线是原始数据,蓝线是贴靠数据。
配额高效利用
snap to Roads 请求的响应包含一个地点 ID 列表,这些 ID 与您提供的点相对应,如果设置了 interpolate=true
,则还可能包含其他点。
为高效利用速度限制请求允许的配额,您应仅在请求中查询唯一的地点 ID。此示例使用适用于 Google 地图服务的 Java 客户端从地点 ID 列表中查询速度限制。
/** * Retrieves speed limits for the previously-snapped points. This method is efficient in terms * of quota usage as it will only query for unique places. * * Note: Speed limit data is only available for requests using an API key enabled for a * Google Maps APIs Premium Plan license. */ private Map<String, SpeedLimit> getSpeedLimits(GeoApiContext context, List<SnappedPoint> points) throws Exception { Map<String, SpeedLimit> placeSpeeds = new HashMap<>(); // Pro tip: Save on quota by filtering to unique place IDs. for (SnappedPoint point : points) { placeSpeeds.put(point.placeId, null); } String[] uniquePlaceIds = placeSpeeds.keySet().toArray(new String[placeSpeeds.keySet().size()]); // Loop through the places, one page (API request) at a time. for (int i = 0; i < uniquePlaceIds.length; i += PAGE_SIZE_LIMIT) { String[] page = Arrays.copyOfRange(uniquePlaceIds, i, Math.min(i + PAGE_SIZE_LIMIT, uniquePlaceIds.length)); // Execute! SpeedLimit[] placeLimits = RoadsApi.speedLimits(context, page).await(); for (SpeedLimit sl : placeLimits) { placeSpeeds.put(sl.placeId, sl); } } return placeSpeeds; }
以下是由以上示例生成的数据,在每个唯一地点 ID 处都标记了速度限制。
与其他 API 交互
在贴靠道路响应中返回地点 ID 的好处之一是,您可以跨多个 Google Maps Platform API 使用地点 ID。此示例使用适用于 Google 地图服务的 Java 客户端,对根据上述道路吸附请求返回的地点进行地理编码。
/** * Geocodes a snapped point using the place ID. */ private GeocodingResult geocodeSnappedPoint(GeoApiContext context, SnappedPoint point) throws Exception { GeocodingResult[] results = GeocodingApi.newRequest(context) .place(point.placeId) .await(); if (results.length > 0) { return results[0]; } return null; }
在该示例中,使用 Geocoding API 中的地址对限速标记进行了注释。
示例代码
注意事项
为便于说明,本文支持的代码作为单个 Android 应用提供。在实践中,您不应在 Android 应用中分发服务器端 API 密钥,因为这样做将无法保障密钥安全,防范第三方未经授权的访问。为保障密钥的安全,您应改为将面向 API 的代码部署为服务器端代理,并让 Android 应用通过该代理发送请求,从而确保请求获得授权。
下载
从 GitHub 下载代码。