指定路线以导入 HERE 高清实时地图数据并构建场景
此示例展示了如何指定路线,使用 CSV 文件导入 HERE HD Live Map 数据,并使用 HERE HD Live Map 在 RoadRunner 中构建场景 1 服务。此示例需要 RoadRunner Scene Builder 许可证。
前提条件
您必须拥有 HERE 市场帐户。有关创建帐户的信息,请参阅获取 HERE 帐户。
您的 HERE Marketplace 帐户必须包含一个工程,其中包含您要在其中构建场景的区域所需的目录。目录存储特定地理区域的地图数据。目前,HERE 高清实时地图服务提供北美和西欧地区的目录。有关创建工程和链接目录的更多信息,请参阅管理 HERE 工程。
您必须将应用程序注册到您的 HERE 帐户,并将包含所需目录的工程指定为默认工程。欲了解更多信息,请参阅管理 HERE 应用。
为已注册的应用程序生成 Access Key ID 和 Access Key Secret 凭证。这些凭证使您能够将 RoadRunner 连接到您的 HERE HD Live Map 工程。有关如何创建这些凭据的更多信息,请参阅获取应用程序凭据。
使用 CSV 或 KML 文件指定路线
使用包含路点作为纬度和经度坐标的 CSV 或 KML 文件指定路线。您可以使用 CSV 或 KML 文件导入特定于路线的 HERE 高清实时地图数据。
CSV 文件必须包含起点和终点路点。该文件必须将每个路点指定为跨两列的纬度和经度坐标。此表显示 CSV 文件中的值的示例。
| 纬度 | 经度 |
|---|---|
| 51.4466245 | 7.0164133 |
| 51.4465135 | 7.0166801 |
| 51.4465396 | 7.0168027 |
| 51.4466536 | 7.0171364 |
| 51.4468237 | 7.0175373 |
| 51.4469181 | 7.0177346 |
KML 文件必须包含起点和终点路点。该文件必须将每个路点指定为一对以逗号分隔的经度和纬度坐标。此代码片段显示了 KML 文件的示例。您可以使用单个 KML 文件指定多条路线的坐标。
<kml>
<Document>
<Placement>
<LineString>
<coordinates>
7.0164133,51.4466245
7.0166801,51.4465135
7.0168027,51.4465396
7.0171364,51.4466536
7.0175373,51.4468237
7.0177346,51.4469181
</coordinates>
</LineString>
</Placement>
</Document>
</kml>导入特定于路线的数据
点击工具栏上的 Scene Builder Tool 按钮,打开场景构建器工具。
![]()
然后,点击场景编辑画布左侧工具栏上的“Import Data For Area”按钮。这将打开 HERE HD Import Settings 对话框。
![]()
在对话框的 HERE HD Live Map Marketplace Credentials 选项卡上,输入您的 HERE HD Live Map 访问凭据 Access Key ID 和 Access Key Secret。
在 Settings 选项卡上,选择 Import Route 并指定这些选项。

File Path - 指定包含纬度和经度路点的 CSV 或 KML 文件的完整路径。或者,选择 File Path 框旁边带有省略号的按钮并导航到您的文件。
Include Object Distance - 指定从您的路线到包括附近道路和物体的距离。如果您将此参数指定为
0.00米,则 RoadRunner 仅导入与您的 CSV 或 KML 文件中指定的路线相关的道路。
此图显示了使用 CSV 文件中指定的路线和指定为 15.00 米的 Include Object Distance 参数导入 HERE HD Live Map 数据的示例。

构建导入的路线和场景
导入路线后,您还可以将附近的道路和沿创建的路线的对象包括在内来构建它们。您可以通过访问所创建路线的属性来控制此包含。选择路线以在 Attributes 窗格中查看其可用属性。
Route
Include Object Distance - 通过在此参数中手动指定距离或以交互方式移动滑块来指定从您的路线到包括附近道路和物体的距离。此参数的默认值与您在 HERE HD 导入设置对话框的设置选项卡上指定的 Include Object Distance 的值相同。如果您将此参数指定为
0.00米,则 RoadRunner 仅构建与您的路线相关的道路。注意
此参数的值必须小于或等于您在 HERE HD 导入设置对话框的设置选项卡上指定的 Include Object Distance 的值。
Highlight Included Objects - 指定是否在场景编辑画布中突出显示路线沿线的道路和物体。这些亮点基于 Include Object Distance 参数中指定的距离。要禁用突出显示,请清除此选项。默认情况下,RoadRunner 高清地图会突出显示附近的道路和物体。
点击场景编辑画布左侧工具栏上的 Build Scene 按钮。
![]()
使用场景构建工具构建场景需要 RoadRunner Scene Builder 许可证。
在“Scene Builder”对话框中,您可以查看和修改以下选项:
Fit Cross Sections - 默认情况下,场景构建器工具会导入横截面信息,例如超高(倾斜)和拱顶。要导入平面横截面,请清除此选项。有关横截面的更多信息,请参阅横截面工具。
Auto Detect Asphalt Surfaces - 默认情况下,场景构建器工具会检测沥青表面并将沥青纹理应用于其。要将草纹理应用到所有表面,请清除此选项。有关表面和纹理的更多信息,请参阅 RoadRunner 中的表面工作原理。
Clear Scene of Existing Data - 默认情况下,当您使用场景构建器工具构建场景时,它会从场景中移除已建好的道路。要保留场景中的现有道路,请清除此选项。
Auto Correct Unrealistic Road Elevation - 默认情况下,场景构建器工具会尝试自动纠正导入道路的不切实际的高程。该工具基于邻近道路的高程数据进行高程修正,这些数据是从 HERE 高清实时地图数据中高可信度导入的。要手动纠正导入的 HERE 高清实时地图数据中不切实际的道路高程,请清除此选项。
Combine Transition Lanes - 默认情况下,Scene Builder Tool 会组合导入的高清地图中的过渡车道来构建单条道路。过渡车道是从一条道路衍生出的多条车道,用于根据道路状况的变化引导车辆从一条车道移至另一条车道。例如,该图显示了 RoadRunner 高清地图中从单条道路分支出的过渡车道。

选择 Combine Transition Lanes 可以减少重叠道路的创建以及构建场景中的交叉路口数量。清除此选项可保留构建场景中相邻过渡车道之间的连通性信息。
Use Lane Groups - 默认情况下,场景构建器工具使用车道组来构建道路。当您使用车道组时,该工具通过仅组合属于同一车道组的车道来构建不同的道路。该工具使用车道组的几何形状来生成道路曲线。如果车道组的几何形状不可用,则该工具将使用该车道组的车道边界的几何形状来生成相应的道路曲线。
清除此选项可忽略车道组数据,这使该工具能够将更多车道组合在一起来构建道路。该工具将交叉口之间的所有车道合并为一条道路。与使用车道组相比,这使您能够建造更少数量的更长道路。当您忽略车道组时,该工具不会使用车道组的几何形状来生成道路曲线。相反,该工具使用车道边界的几何形状来生成道路曲线。
Curvature Blend - 场景构建工具使用直线和圆弧构建道路。Curvature Blend 确定用于从直线过渡到圆弧的圆弧部分。您可以在 [0, 1] 范围内指定此值来控制沿曲率建造的道路的平滑度。
Enable Overlap Groups - 默认情况下,场景构建器工具不会在道路重叠处创建自动交叉口。为了创建交叉口,该工具使用导入的高清地图数据中指定的显式交叉口信息。要在几何重叠处创建自动交叉口,请清除此选项。有关重叠组的更多信息,请参阅 防止在道路之间创建自动交叉口。
Overlap Group Name - 当您选择 Enable Overlap Groups 选项时,该工具默认将 Overlap Group Name 选项设置为
SceneBuild。当您在现有场景上构建高清地图数据时,可以使用 Overlap Group Name 选项来控制自动交叉口创建的行为。例如,如果现有场景中的道路的 Overlap Group 选项值TransferImport,并且您不想在它们与高清地图数据指定的道路之间的几何重叠处创建自动交叉口,则必须将 Overlap Group Name 选项设置为TransferImport。否则,该工具会在现有场景的道路与导入的高清地图数据指定的道路之间的几何重叠处创建自动交叉口。要使用此选项,您必须选择 Enable Overlap Groups 选项。Preserve Junction Lanes - 使用 Preserve Junction Lanes 选项保留导入地图中所有交叉口车道。当您选择此选项时,该工具不会考虑地图中的道路重叠,而是在构建 RoadRunner 场景时使用从导入的地图中交叉口定义。该工具在 RoadRunner 场景中构建交叉口,保留导入地图中的原始交叉口车道。选择此选项可以防止工具在构建的场景中创建多个断开的交叉口。要使用此选项,您必须选择 Enable Overlap Groups 选项。
Preserve Junction Lanes 选项对交叉口创建的影响
使用场景构建器工具将带有交叉口的 RRHD 地图导入 RoadRunner 画布 RoadRunner 使用场景构建工具构建场景,无需 Preserve Junction Lanes RoadRunner 场景使用场景构建工具和 Preserve Junction Lanes 构建 


Preserve Junction Shape - 使用 Preserve Junction Shape 选项可保留导入地图中存在的交叉点形状。选择此选项时,工具将构建 RoadRunner 场景,同时采用导入地图中的连接多边形定义,以在构建的场景中保留原始交叉口几何形状。如果交叉口定义中未包含多边形,则该工具不会保留交叉口的形状。此外,若交叉口多边形定义过于复杂且不切实际,或交叉口多边形超出交叉口车道范围,该工具可能无法精确保留交叉口的实际形状。要使用此选项,您必须同时选择 Enable Overlap Groups 和 Preserve Junction Lanes 选项。
Preserve Junction Shape 选项对交叉口创建的影响
使用场景构建器工具将带有交叉口的 RRHD 地图导入 RoadRunner 画布 RoadRunner 使用场景构建工具创建的场景,不含 Preserve Junction Shape RoadRunner 使用场景构建工具构建的场景,包含 Preserve Junction Shape 


Auto Detect Bridges - 默认情况下,当道路具有不同的高程时,场景构建器工具会在道路交叉路口处创建桥梁。该工具可将交叉路口两侧的桥梁延长 20 米。您可以通过改变 Bridge Span Inflation 值来改变扩展量。要防止该工具创建桥接,请清除此选项。欲了解更多信息,请参阅道路构造工具。
Build Info - 显示所有导入数据以及场景中选定道路子集中的链接长度和链接数量。
您可以在“Scene Builder”对话框中的以下选项中指定要根据导入的数据构建什么内容:
All Data - 构建所有导入的数据。
Selected Data and Selected Routes - 构建选定数据和选定路线。
要选择场景对象,请点击每个所需的对象。您还可以在场景编辑画布中点击并拖动,以在要选择的对象周围绘制一个框。
将框拖向画布的左上角,以仅选择完全包含在框中的对象。
向任何其他方向(向左下角、右上角或右下角)拖动该框以选择至少部分位于该框内的任何对象。
场景构建器工具保留先前的选择,将新选定的对象附加到先前选定的对象组中。要从选择中移除对象,请按住 Ctrl 并点击要移除的对象,或者在场景编辑画布中点击并拖动以在它们周围绘制一个框。要取消选择所有当前选定的对象,请按 Ctrl+D。
要开始创建路线,请沿着车道的行进方向右键点击场景编辑画布中的车道。有关创建路线的更多信息,请参阅 使用高清地图数据创建路线并构建场景。
您还可以按住 Shift 并点击其他路线,将其添加到选择中。
All Routes - 建造与您创建的路线相关的所有道路和物体。有关创建路线的更多信息,请参阅 使用高清地图数据创建路线并构建场景。
您还可以删除选定的数据以避免构建它。
对于此示例,通过选择 All Data 并点击 Build 来构建整个场景。

验证结果
场景构建工具根据 HERE HD 实时地图数据构建场景,并在对话框中显示有关结果的信息。有关常见导入问题故障排除的信息,请参阅 解决导入和构建问题。要关闭对话框,请选择 Close。
通过选择其他工具离开 RoadRunner HD Map。然后,探索您构建的场景。例如,导航至相交道路并检查立交桥。

使用其他 RoadRunner 功能继续探索和编辑场景。然后,通过选择 File、Export 并选择支持的文件格式来导出场景。有关更多详细信息,请参阅导出场景。
另请参阅
主题
1 You need to enter into a separate agreement with HERE in order to gain access to the HDLM services and to get the required credentials (access_key_id and access_key_secret) for using the HERE Service.