This guide offers an introduction to how you can get started importing real world map data through CityBLD. A video overview is available as well, but more detail is covered here.
Video link: https://www.youtube.com/watch?v=19mn3Q18bC8
<aside> 💡 Real World Data Import is an active area of development. Features and output quality will change as we continue implementing them. CityBLD’s OSM import is currently built on the Street Map plugin: https://github.com/ue4plugins/StreetMap
</aside>


Visit OpenStreetMap.org, find the approximate location you want to export, hit the top-level Export button, hit “Manually select a different area”, size the area you want, then hit Export button in the Export tab. This will download a map.osm file. Rename it to something descriptive as the file name will be used later for import. For this guide we will use MyMap.osm for simplicity.


Drag-n-drop your OSM file into the Content Browser in Unreal.

Drag the asset into your level to spawn a StreetMapActor. This actor acts as a preview of the data. Adjust the scale of this actor as needed so it matches the scale of your world. Typically a scale value of 0.5 will be fairly accurate to the real world, but this may vary slightly with different .osm assets.

With the StreetMapActor selected, in the Details tab for the actor you can modify certain properties and rebuild the preview as desired.

<aside> 💡 NOTE: OSM data often treats elements such as alleys, parking lots, or footpaths as roads. Generally you’ll want to remove all roads with the tag highway=service from the OSM data before you import it to Unreal so that CityBLD doesn’t try to generate roads where there are none.
</aside>