Skip to main content Link Search Menu Expand Document (external link)


A Formatter converts features to a different format, such as GeoJSON or Well-Known Text. A Formatter’s output can be customized, then turned into a string or saved to a file.


These properties customize the Formatter’s output.


Default: False

If set to True, outputs Mercator-projected coordinates instead of WGS-84 (degrees longitude/latitude).


Default: 7

The number of digits after the decimal point for coordinate values (A value of 7 equates to a resolution of about 1 cm).


Default: False

If set to True, adds tabs and spacing to make the output easier to read.


Writes the output to a file. If filename has no extension, a default is used.'london-streets')  # Creates london-streets.geojson


GeoJSON is a widely used format for representing geographic features. For each Feature, the Formatter writes its ID, geometry and properties (its OSM tags).

    "type": "FeatureCollection",
    "generator": "geodesk-py/0.1.0",
    "features": [
            "type": "Feature",
            "id": "W6001627",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    [-117.280372, 32.8393748], [-117.2803909, 32.8396239],
                    [-117.2803957, 32.839872], ... ]
            "properties": {
                "highway": "secondary",
                "name": "Prospect Street",

Line-based variant 0.2

As an alternative to classic GeoJSON, each Feature is written on a separate line:

{ "type": "Feature", "id": "W6001627", "geometry": { "type": "LineString", ... }}
{ "type": "Feature", "id": "N596184365", "geometry": { "type": "Point", ... }}

Well-Known Text

Well-Know Text (WKT) represents the geometric shapes of features (without IDs or tags).

    LINESTRING(-117.280372 32.8393748, -117.2803909 32.8396239, ...),