osm-map-merger 2025.1

Tool for handling (negative) IDs and merging different OSM maps (e.g. Lanelet2 maps). Very helpful if you have modeled several maps separately and now want to merge them into a single map.

OSM Map Merger

IMPORTANT NOTE This repository is part of the Behavior-Semantic Scenery Description (BSSD) framework. Check out our BSSD documentation and overview repository in your git of choice:

This tool can be used to handle one or more maps in OSM-format such as Lanelet2 maps including the BSSD extension.

Features:

• Assign positive IDs to all elements and add a "version" attribute if missing. This is necessary after modification or creation of OSM-maps (e.g. with JOSM) without synchronizing with the OSM database.
• Remap single negative IDs without changing the positive IDs.
• Merge multiple OSM input files into a single OSM output file. This works also for a mixture of positive and negative IDs.
• Elements with "action"="delete" will be ignored.

Use the --help command for more information about the usage.

Requirements

• Python 3.8 or higher
• osmium >=3.2.0
• lxml,
• beautifulsoup4,
• click

Installation

Using pip

pip install osm-map-merger

This will install the latest version of the OSM Map Merger available in PyPI to your environment.

Manual Installation

Clone the source code to a directory of your choice (path/to/osm-map-merger-src/).

If you are using virtual environments, make sure to activate the correct environment to install the library into e.g:

source /<path-to-my-project>/.venv/bin/activate

Install the library:

pip install -e path/to/osm-map-merger-src/

Usage

To see a list of available commands use:

osm-map-merger --help