交通openlr接口说明书.pdfVIP

1引

1.1目的

本文档用于描述高德交通OpenLR接口和SDK/路表数据使用。

随着高德交通与、企业合作的不断增加，越来越多接入方希望能够获得高德实时交

通数据作为参考或分析。因此，高德提供了OpenLR发布接口，通过动态位置编码OpenLR

提供实时交通。由于OpenLR需要匹配才能使用，高德同时提供了SDK和路表数

据。结合SDK和路表，接入方可以将高德实时交通匹配到任意地图路网上。

1.2参考资料

号文名/述版本

2背景概述

高德提供的接口发布基于Pb格式OpenLR实时交通数据。接入方将高SDK和路表映

射关系集成到自身系统中，SDK和映射路表作为数据转换模块，其输出数据可以直接被合

作方应用系统使用。其中SDK负责解析高德OpenLR数据，路表映射关系完成自用的路网

匹配。接入方请求实时交通接口数据之前，需先通过用户名进行验证。同时，接入

方（如卡口）的数据可以通过HTTP连接发送至高德。整个SDK和路表的框架如

下：

口入方口

入方

路表link映射

OpenLR规格交通信息

高OpenLR接SDK

OpenLR接入方交通应用系统

接入方交通数据

回传数据确认

接入系统

路表link映射

SDK：

1.OpenLR数据解析：将Gzip压缩的OpenLR格式高德交通数据转换为基于高德

Link的交通数据发布，并提供给接入方进行映射关系匹配

2.处理接入方数据（选用）：接入方交通数据经过SDK编码成pb规格的OpenLR数

据，通过http连接的方式与高德交通通信。

高德路表：接入方可以通过高德提供的路表建立高德Link和自己地图上的道路的映射

关系，从而在自己地图上展示以高德Link发布的交通信息。

3OpenLR发布协议

接入方在请求高德实时交通之前，需要进行登录鉴权，鉴权通过后可以获得请求实时交

通的权限。

3.1交互时序图

交通信息接入方获取数据的步骤如下图所示：

接入方OpenLR服务接

登录Logon

Loop数据请求GetData

City1

……

Loop数据请求GetData

CityN

接入端发起登录logon请求，在服务端确认客户端为合法用户后，客户端即可开始请求

基于OpenLR位置编码的实时交通数据。每次请求数据时都需要上传时间戳信息，在非第

一次请求数据时，服务端根据上传的批次时间，判断是否有更新数据下发。若有，下发

更新后的全量数据；若无，则不返回数据。所有返回的数据均进行gzip压缩处理。

另，本协议仅提供单城市数据的请求接口，若需同时获取多个城市的数据，可通过多线

程方式获取。

3.2登录接口

3.2.1求

支持HTTPGET方式。

URL：

se