Importing Data from OSM


"OpenStreetMap is a project aimed squarely at creating and providing free geographic data such as street maps to anyone who wants them." --

OSM is an XML-based format to describe vector data used in a cartographic map. It defines three basic types to describe all the elements of such a map: By default, Ways and Closed Ways are converted into graph segments. However, if a Closed Way contains one of the tags amenity, area, boundary, building, geological, historic, landuse, leisure, natural, place, shop, sport, tourism, it's converted into a shape. Note the respective symbols, and , displayed on the left side of the ways.

Import Settings

The import dialog consists of several options, as shown below. As usual, presets can be saved and applied.

The osm import dialog with a checked highway layer for graph import

The osm import dialog with a checked area layer for shape import


Press Browse to open a dialog to select a .osm file to import.

Element Listing

Lists the layers and OSM ways contained in the selected OSM file. Select the element you want to import.

OSM files may contain a large number of layers, of which the "highway" layer is usually the most interesting to create street networks in the CityEngine.

You may select multiple OSM layers per import session. Then, all ways which are converted into graph segments will be merged into one graph layer. If you would like to generate several graph layers out of one OSM file, please repeat the process accordingly.

Select / deselect all

Selects / deselects all layers.

Graph Settings

The following settings are only of interest when importing graph networks.

Map OSM tags to street widths

If enabled, street and sidewalk widths are mapped from tags contained in the osm file. See below.

Run Generate Bridges Tool after Import

If enabled, the Generate Bridges Tool is executed on a following wizard page.

Run Simplify Graph Tool after Import

If enabled, the Simplify Graph Tool is executed on a following wizard page.

Run Graph Cleanup Tool after Import

Depending on the OSM data it may be necessary to cleanup the graph segments after import. If enabled, the graph cleanup tool is executed on a following wizard page.

Create Street/Intersection Shapes from Graph

If enabled, the shape creation parameter of the graph nodes and segments will be enabled and street shapes are created.

Create Block/Lot Shapes from Graph

If enabled, the shape creation parameter of potentially created street blocks will be enabled and shapes are created.

OSM Tag Mapping

If Map OSM tags to street widths is checked, the created layer will contain the following layer attribute code:

The osm tag mapping function code.

By default, an example function code maps common osm tags to street and sidewalk widths. The function code is copied into the newly created street layer, and the street and sidewalk width parameters of the imported street segments are correctly mapped.

The correctly mapped street parameters of a selected street segment in the inspector.

The function code can be edited after import in the inspector when selecting the street layer.

Advanced users can edit the default mapping code by changing the cga code in the file osm.ceattr, located in /ce.lib/rules/.

Copyright ©2008-2018 Esri R&D Center Zurich. All rights reserved.