Export HOTOSM tool

[ramyaragupathy]

Referencing #7, HOTOSM's export tool is another option to download OpenStreetMap data. While playing around with the interface, looks like the tool can deal with any rectangular/custom polygon boundaries. Using this ticket to document learnings.

• YAML
• From Network
• Creating Export

[ramyaragupathy]

YAML

• It is a data serialisation language like JSON. Emphasis is on readability
• Written in plain text with certain syntax formatting
• Different from markdown. Full form: YAML Ain't Markup Language
• .yml & .yaml extensions
• Space indentation defines scopes
• date & time in ISO 8601 standard yyyy-mm-ddThh:mm:ss
• Data represented as k-v pairs
• There also lists, comments, type conversions, anchoring specific keys & anchoring k-v pairs.
• Resources
  • Ultimate Guide
  • Cheat Sheet
  • YAML-JSON

Eg:

buildings: 
  select: 
    - name
    - building
  types: 
    - polygons
  where: "building IS NOT NULL"
hospitals: 
  select: 
    - name
    - amenity
  where: "amenity = hospital"
waterways: 
  select: 
    - name
    - waterway
  types: 
    - lines
    - polygons
  where: "natural IN ('waterway')"

This is equivalent to:

{buildings:{select:[name, building], types:[polygons], where:"building IS NOT NULL"},
hospitals:{select:[name, amenity], where:"amenity=hospital"},
waterways:{select:[name, watrway], types:[lines, polygons], where:"natural IN ('waterway')"}

[ramyaragupathy]

From Network

On clicking Create Export, request payload is created & this is sent to the path /api/jobs

Example payload:

{
    "published": false,
    "feature_selection": "planet_osm_point:\n  types:\n    - points\n  select:\n    - 'access:roof'\n    - 'addr:housenumber'\n    - 'addr:street'\n    - building\n    - 'building:material'\n    - name\n    - 'roof:material'\n  where:\n    - building IS NOT NULL\nplanet_osm_polygon:\n  types:\n    - polygons\n  select:\n    - 'access:roof'\n    - 'addr:housenumber'\n    - 'addr:street'\n    - building\n    - 'building:material'\n    - name\n    - 'roof:material'\n  where:\n    - building IS NOT NULL\n",
    "export_formats": ["shp"],
    "aoi": {
        "description": "India, Tamil Nadu, Cuddalore",
        "geomType": "Polygon",
        "title": "Neyveli"
    },
    "the_geom": {
        "type": "Polygon",
        "coordinates": [
            [
                [79.49, 11.599999999999994],
                [79.49, 11.620000000000005],
                [79.51, 11.620000000000005],
                [79.51, 11.599999999999994],
                [79.49, 11.599999999999994]
            ]
        ]
    },
    "name": "Test"
}