No version for distro humble. Known supported distros are highlighted in the buttons above.
No version for distro jazzy. Known supported distros are highlighted in the buttons above.
No version for distro rolling. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 1.0.0
License Apache License 2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/autowarefoundation/autoware_core.git
VCS Type git
VCS Version main
Last Updated 2025-04-04
Dev Status UNMAINTAINED
CI status No Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

autoware_map_projection_loader package as a ROS 2 node

Additional Links

No additional links.

Maintainers

  • Yamato Ando
  • Masahiro Sakamoto
  • Kento Yabuuchi
  • NGUYEN Viet Anh
  • Taiki Yamada
  • Shintaro Sakoda
  • Ryu Yamamoto

Authors

No additional authors.

autoware_map_projection_loader

Feature

autoware_map_projection_loader is responsible for publishing map_projector_info that defines in which kind of coordinate Autoware is operating. This is necessary information especially when you want to convert from global (geoid) to local coordinate or the other way around.

  • If map_projector_info_path DOES exist, this node loads it and publishes the map projection information accordingly.
  • If map_projector_info_path does NOT exist, the node assumes that you are using the MGRS projection type, and loads the lanelet2 map instead to extract the MGRS grid.
    • DEPRECATED WARNING: This interface that uses the lanelet2 map is not recommended. Please prepare the YAML file instead.

Map projector info file specification

You need to provide a YAML file, namely map_projector_info.yaml under the map_path directory. For pointcloud_map_metadata.yaml, please refer to the Readme of autoware_map_loader.

sample-map-rosbag
├── lanelet2_map.osm
├── pointcloud_map.pcd
├── map_projector_info.yaml
└── pointcloud_map_metadata.yaml

There are three types of transformations from latitude and longitude to XYZ coordinate system as shown in the figure below. Please refer to the following details for the necessary parameters for each projector type.

node_diagram

Using local coordinate

# map_projector_info.yaml
projector_type: Local

Limitation

The functionality that requires latitude and longitude will become unavailable.

The currently identified unavailable functionalities are:

  • GNSS localization
  • Sending the self-position in latitude and longitude using ADAPI

Using MGRS

If you want to use MGRS, please specify the MGRS grid as well.

# map_projector_info.yaml
projector_type: MGRS
vertical_datum: WGS84
mgrs_grid: 54SUE

Limitation

It cannot be used with maps that span across two or more MGRS grids. Please use it only when it falls within the scope of a single MGRS grid.

Using LocalCartesianUTM

If you want to use local cartesian UTM, please specify the map origin as well.

# map_projector_info.yaml
projector_type: LocalCartesianUTM
vertical_datum: WGS84
map_origin:
  latitude: 35.6762 # [deg]
  longitude: 139.6503 # [deg]
  altitude: 0.0 # [m]

Using LocalCartesian

If you want to use local cartesian WGS84, please specify the map origin as well.

Currently LocalCartesian can only be used in lanelet2_map_loader, packages like gnss_poser doesn’t support it right now.

# map_projector_info.yaml
projector_type: LocalCartesian
vertical_datum: WGS84
map_origin:
  latitude: 35.6762 # [deg]
  longitude: 139.6503 # [deg]
  altitude: 0.0 # [m]

Using TransverseMercator

If you want to use Transverse Mercator projection, please specify the map origin as well.

# map_projector_info.yaml
projector_type: TransverseMercator
vertical_datum: WGS84
map_origin:
  latitude: 35.6762 # [deg]
  longitude: 139.6503 # [deg]
  altitude: 0.0 # [m]

Published Topics

  • ~/map_projector_info (autoware_map_msgs/MapProjectorInfo) : This topic shows the definition of map projector information

Parameters

Note that these parameters are assumed to be passed from launch arguments, and it is not recommended to directly write them in map_projection_loader.param.yaml.

{{ json_to_markdown(“map/autoware_map_projection_loader/schema/map_projection_loader.schema.json”) }}

CHANGELOG

Changelog for package autoware_map_projection_loader

1.0.0 (2025-03-31)

  • chore: update version in package.xml
  • feat: move autoware_map_projection_loader package from Autoware Universe (#125)
  • Contributors: Ryohsuke Mitsudome

Wiki Tutorials

This package does not provide any links to tutorials in it's rosindex metadata. You can check on the ROS Wiki Tutorials page for the package.

Launch files

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged autoware_map_projection_loader at Robotics Stack Exchange

No version for distro noetic. Known supported distros are highlighted in the buttons above.
No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.
No version for distro galactic. Known supported distros are highlighted in the buttons above.
No version for distro foxy. Known supported distros are highlighted in the buttons above.
No version for distro iron. Known supported distros are highlighted in the buttons above.
No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.
No version for distro melodic. Known supported distros are highlighted in the buttons above.