From e54244f9652bd63769882fac6a892cb1a8c482b6 Mon Sep 17 00:00:00 2001 From: Drew Dara-Abrams Date: Wed, 3 Jul 2019 14:45:57 -0700 Subject: [PATCH] v0.4.9 (with support for extracting polygons from OSM) --- README.md | 27 ++++++++++++--------------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 25c2913..eafd73c 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,7 @@ # Interline PlanetUtils - + @@ -25,9 +22,9 @@ * [elevation_tile_merge](#elevation_tile_merge) * [valhalla_tilepack_list](#valhalla_tilepack_list) * [valhalla_tilepack_download](#valhalla_tilepack_download) -- [Specifying bounding boxes](#specifying-bounding-boxes) +- [Specifying extract extents](#specifying-extract-extents) * [Bounding box file: CSV format](#bounding-box-file-csv-format) - * [Bounding box file: GeoJSON format](#bounding-box-file-geojson-format) + * [Bounding box/polygon file: GeoJSON format](#bounding-boxpolygon-file-geojson-format) - [Switching toolchains](#switching-toolchains) - [Support](#support) @@ -59,7 +56,7 @@ PlanetUtils is a "high level" library that makes use of [Osmosis](https://wiki.o Make sure you have [Docker](https://www.docker.com/community-edition) installed. Then: ```sh -docker pull interline/planetutils:release-v0.4.8 +docker pull interline/planetutils:release-v0.4.9 ``` Any of the example commands below can be executed with `docker run`. It may be helpful to mount a local directory inside the container for persistence and to access output files. @@ -67,7 +64,7 @@ Any of the example commands below can be executed with `docker run`. It may be h - Example of using `docker run` with the `data` directory mounted as `/data`: ```sh -docker run --rm -v ${PWD}/data:/data -t interline/planetutils:release-v0.4.8 +docker run --rm -v ${PWD}/data:/data -t interline/planetutils:release-v0.4.9 ``` ### Using Homebrew on Mac OS @@ -124,7 +121,7 @@ osm_planet_update -h ### osm_planet_extract -Cut up an OSM planet file into one or more extracts, defined by bounding boxes. Each bounding box is assigned a name. (This is like a mini version of Mapzen Metro Extracts!) +Cut up an OSM planet file into one or more extracts, defined by bounding boxes or polygons. Each extract is assigned a name. (This is like a mini version of Mapzen Metro Extracts!) To create a single extract: @@ -132,7 +129,7 @@ To create a single extract: osm_planet_extract --outpath=data/osm_extracts --bbox=-122.737,37.449,-122.011,37.955 --name=san-francisco planet-latest.osm.pbf ``` -To specify more than one bounding box of tiles to download, list the bounding boxes in a [CSV file or GeoJSON file](#bounding-box). For example: +To specify more than one bounding box of tiles to download, list the extents in a [CSV file or GeoJSON file](#bounding-box). For example: ```sh osm_planet_extract --outpath=data/osm_extracts --csv=data/bboxes.csv planet-latest.osm.pbf @@ -268,10 +265,10 @@ For complete help on command-line arguments: valhalla_tilepack_download -h ``` -## Specifying bounding boxes +## Specifying extract extents -When extracting multiple bounding boxes from an OSM planet, or when downloading multiple bounding boxes of elevation tiles, you can specify your bounding boxes in a single file, either CSV or GeoJSON format. +When extracting multiple bounding boxes or polygons from an OSM planet, or when downloading multiple bounding boxes of elevation tiles, you can specify your extents in a single file, either CSV or GeoJSON format. ### Bounding box file: CSV format @@ -289,15 +286,15 @@ dar-es-salaam,38.894,-7.120,39.661,-6.502 To determine a bounding box, try the tool at http://bboxfinder.com/ -### Bounding box file: GeoJSON format +### Bounding box/polygon file: GeoJSON format -Alternatively, you can specify the bounding boxes as features in a GeoJSON file, using the `--geojson` argument. +Alternatively, you can specify the bounding boxes or polygons as features in a GeoJSON file, using the `--geojson` argument. ```sh osm_planet_extract --geojson=examples/test.geojson examples/san-francisco-downtown.osm.pbf ``` -To draw bounding box polygons in GeoJSON, try the tool at http://geojson.io/. Currently, the bounding box for each feature is used. Future releases may support polygon clipping. +To draw extents in GeoJSON, try the tool at http://geojson.io/ ## Switching toolchains