Skip to content

v0.2.48..v0.2.49 changeset convert.asciidoc

Garret Voltz edited this page Oct 2, 2019 · 1 revision
diff --git a/docs/commands/convert.asciidoc b/docs/commands/convert.asciidoc
index bf64905..3f2184c 100644
--- a/docs/commands/convert.asciidoc
+++ b/docs/commands/convert.asciidoc
@@ -7,10 +7,11 @@ The +convert+ command converts map data from one input format to another.  Optio
 conversion.  The process may be memory bound depending upon the input or output formats selected.  See the Hootenanny User Guide Supported
 Data Formats section for more information.
 
-* +input(s)+       - Input path(s) to convert from; Multiple inputs are supported unless converting to an OGR format, and path wildcards may 
-                     be used for inputs within the same directory. For OGR inputs, layer names may also optionally be specified.  Use a single 
-                     space to separate each input and a ';' between inputs and layer (<filename>;<layer name>).
-* +output+         - Output path to convert to (e.g. .osm file, etc.).
+* +input(s)+       - Input path(s) to convert from; may be any supported input format; Multiple inputs are supported unless converting to 
+                     an OGR format, and path wildcards may be used for inputs within the same directory. For OGR inputs, layer names may 
+                     also optionally be specified.  Use a single space to separate each input and a ';' between inputs and layer 
+                     (<filename>;<layer name>).
+* +output+         - Output path to convert to; may be any supported output format (e.g. .osm file, etc.).
 * +--write-bounds+ - If the `convert.bounding.box` configuration option is specified, optionally outputs a file containing the input bounds.
                      The location of the file is controlled via the `bounds.output.file` configuration option.
 
@@ -168,6 +169,14 @@ Convert all TDS shapefiles stored in the top level of a Zip file:
 hoot convert -D schema.translation.script=TDSv40.js /vsizip//gis-data/test_data.zip/ tds_roads.osm
 --------------------------------------
 
+==== Converting OSM API data to OSM
+
+Retrieve OSM data around Paris, France from an OSM API and save it to an OSM file:
+
+--------------------------------------
+hoot convert -D convert.bounding.box=2.277303,48.851684,2.311635,48.864701 https://osm-api-url/api/0.6/map download.osm
+--------------------------------------
+
 === Notes
 
 * The format for OSM database URLs is: protocol://<user name>:<password>@<host name>:<port>/<database name>
@@ -189,3 +198,7 @@ field separators. If you get errors using absolute paths, check that you have th
 *** If the Zip file is in the current directory, the input will be: /vsizip/./test_data.zip/dir/LAP010.shp
 *** If you do not specify a specific shapefile then it will read in all shapefiles in the given directory
 * To prevent memory bound conversion when converting to OSM XML, you must set the writer.xml.sort.by.id configuration option to false.
+
+=== See Also
+
+* https://github.com/ngageoint/hootenanny/blob/master/docs/user/SupportedDataFormats.asciidoc#applying-changes-1[Supported Input Formats]
Clone this wiki locally