错误
如果发生错误,系统将返回标准格式的错误响应正文,并将 HTTP 状态代码设置为错误状态。
响应包含一个具有单个 error
对象(具有以下键)的对象:
code
:这与响应的 HTTP 状态相同。message
:错误的简短说明。status
:指示错误性质的状态代码。
例如,发送无效的 placeId
参数将返回以下错误:
{ "error": { "code": 400, "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"", "status": "INVALID_ARGUMENT" } }
可能的错误包括:
代码 | 状态 | 消息 | 问题排查 |
---|---|---|---|
400 | INVALID_ARGUMENT |
您提供的密钥无效。 | 您的 API 密钥无效或未包含在请求中。请确保您已添加了完整的密钥,并且已为此密钥启用了 API。 |
400 | INVALID_ARGUMENT |
“\"path\" 参数包含无效值:☃” | 您的请求包含无效参数。导致此错误的最可能原因包括:
如果为已不存在的道路或并非道路的地点传递 |
403 | PERMISSION_DENIED |
未注册的请求已被阻止。请使用 Google Developers Console 注册。 | 由于以下一种或多种原因,请求遭拒:
为了使用 Google Maps Platform 产品,必须为帐号启用结算功能,并且所有请求都必须包含有效的 API 密钥。如需解决此问题,请按以下步骤操作: |
404 | NOT_FOUND |
此服务要求使用 HTTPS。 | 确保将请求发送到 https://roads.googleapis.com/ ,而不是 http://roads.googleapis.com/ 。 |
429 | RESOURCE_EXHAUSTED |
由于达到项目请求限制,请求受到限制。 | 您已超出在 Google Cloud Platform Console 中配置的请求限制。此限制通常设置为每天请求数、每 100 秒请求数和每位用户每 100 秒请求数。此限制应配置为防止单个或一小部分用户耗尽您的每日配额,同时仍允许所有用户合理访问。如需配置这些限制,请参阅设置 API 用量上限。 |
指数退避算法
当请求失败时,您应确保使用指数退避算法重试请求。例如,如果请求失败一次,一秒后重试;如果再次失败,则两秒后重试;然后是四秒后重试;依此类推。这可确保中断的请求或大规模故障不会因很短时间内许多客户端试图重试请求而给 Google 的服务器造成冲击。
问题排查常见问题解答
植入问题
- 我应该以何种频率对我的车辆位置信息进行采样?
- 建议每隔 1-10 秒,以获得高质量的道路拍摄结果。
- 每次查询发送的积分数量是否有限制?
- 可以。一个查询最多可以有 100 个积分。
- 我应该使用什么级别的精度来存储已贴靠的纬度/经度对?
- 为确保在所有缩放级别下,贴靠路径沿着道路始终经过,即使在最大缩放级别下,您也应以 7 位小数的精度存储贴靠的纬度/经度对。
- 我能否使用编码多段线显示吸附路径?
- 编码多段线只能精确到小数点后 5 位,因此会产生大约 2 米的误差。因此,如果您想让贴靠路径沿着高缩放级别的道路跟随道路,编码多段线就不适用。
常见问题
- 有些点未贴靠,或者贴靠路径之间存在间隙。如何更正此问题?
- 放大时,为什么绘制的路径呈锯齿状或略微偏离道路?
-
- 在显示拍摄的纬度/经度对之前,您是否会截断它们的精度?如果存储的贴靠纬度/经度对的精度低于 7 个小数点,则会导致在地图上显示贴靠路径时出现精度错误。
- 您是否使用了编码多段线?编码多段线会将纬度/经度对截断到 5 位小数,这会带来几米的误差,从而导致在高缩放级别下,线条呈锯齿状或略微偏离道路。
如果不属于上述任何一种情况,则地图图块可能在近期进行了更新,导致它们与用于贴靠的道路索引不同步。如果只有少数查询受到影响,这可能就是原因。Google 地图会定期更新,因此这种情况偶尔会发生;如果您经常查看地图上的旧路径(例如几周前截取的路径),则会更频繁地发生这种情况。为了实现最佳可视化,您应该先重新捕捉旧路径,然后再将其显示在地图上,从而最大限度地减少地图图块与用于贴靠的道路索引之间的不一致。
- 哪些原因可能导致 X 号公路的限速显示不正确?
- 速度限制有多个来源,在准确性和覆盖范围方面不尽相同。
如果您发现某种模式,例如特定道路类型的限速或特定区域的限速始终有误,请按照以下步骤告知我们:
- 在桌面设备上打开 Google 地图,或者打开 Android 版 Google 地图应用。
- 打开左侧菜单。
- 选择发送反馈。注意:系统可能会提示您登录。
- 选择修改地图。
- 选择您要修改的路段。
- 选择下一步。
- 在“其他”字段中,指明该道路的限速有误。
- 选择提交。
- 为什么我截取的路径会切角,而不是沿着道路前进?
-
为解决此问题,请检查以下内容:
- 确保将
interpolate
参数设置为true
。 - 检查原始数据点的采样间隔时间是否足够接近(每 1-10 秒)。
- 确保将
- 对于没有限速变化的道路,为什么在沿实际道路的吸附路径中返回了大量路段?
- 当
interpolate
参数设置为true
时,“沿实际道路”查询会返回一条沿着道路转角、弯曲和环岛的多段线。如果道路弯曲,即使限速未发生变化,系统会返回多个路段,以便绘制紧贴道路几何图形的多段线。