skyway 0.7.1

A command-line OpenStreetMap file converter
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# Usage

Here is an example of how to use skyway.
For more information, you can run `skyway --help`.

```sh
skyway --from pbf --input input-file.pbf --to json --output output-file.json
```
If you do not specify an input or output file, skyway will default to standard in and standard out, respectively.
This enables you to stream data into and out of skyway, like this:
```sh
cat input-file.pbf | skyway --from pbf --to json > output-file.json
```

## Supported Formats

Here is a table showing the formats skyway supports reading and writing.
The shortname is used to indicate the format when running skyway, e.g. `skyway --from xml ...`.
When paired together, "speedy" readers and writers will generally run faster by passing data between threads.

**Key:**<br>
❌ – Not Supported<br>
✅ – Supported<br>
⚡ – Speedy!<br>

| Format | Shortname | Reader | Writer |
| -------|-----------|--------|--------|
| [o5m](https://wiki.openstreetmap.org/wiki/O5m) | `o5m` | ❌ | ✅ |
| [OPL](https://wiki.openstreetmap.org/wiki/OPL_format) | `opl` | ⚡ | ⚡ |
| [OSM JSON](https://wiki.openstreetmap.org/wiki/OSM_JSON) | `json` | ✅ | ⚡ |
| [Overpass JSON](https://wiki.openstreetmap.org/wiki/OSM_JSON#Overpass_API) | † | ✅ | ⚡ |
| [OSM XML](https://wiki.openstreetmap.org/wiki/OSM_XML) | `xml` | ✅ | ⚡ |
| [PBF](https://wiki.openstreetmap.org/wiki/PBF_Format) | `pbf` | ⚡ | ❌ |

<sup>†</sup>*Use the shortname `json` to read Overpass JSON, it uses the same parser as OSM JSON. Use `overpass` for writing.*