Posts GeoJSON Api returns Posts in GeoJSON format. The API accepts the same params as the standard Posts API, but is read-only and only accepts GET requests.

GET posts

Listing all posts

METHOD: GET
ENDPOINT: /api/v2/posts/geojson
AUTHENTICATED: No

Query Parameters

Name	Type	Description
q	Optional	Only Posts containing this search string will be returned, matched against post title and content
type	Optional	Only posts of this type will be returned: report, revision, comment or alert
locale	Optional	Only posts with matching locale will be returned
slug	Optional	Only posts with a matching slug will be returned
form_id	Optional	Only posts with this form_id will be returned
user_id	Optional	Only posts created by this user_id will be returned
created_before	Optional	Returned posts will have a created date smaller than this date
created_after	Optional	Returned posts will have a created date greater than this date
updated_before	Optional	Returned posts will have an updated date smaller than this date
updated_after	Optional	Returned posts will have an updated date greater than this date
bbox	Optional	Returned posts will have a point attribute within the specified bounding box. bbox expects lat lon values as follows: west,north,east,south
geometry_attribute	Optional	Returned GeoJSON will only include geometries for the specified attribute
order	Optional	Returned posts will be sorted in this order: ASC or DESC. Default: DESC
order_by	Optional	Returned posts will be sorted by this field. Default: created
limit	Optional	Limit number of results returned. Default: 50. Max: 500
offset	Optional	Posts returned will be offset by this number of results

Example Request

GET https://ushv3.dev/api/v2/posts/geojson

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [{
                "type": "Point",
                "coordinates": [12.123, 21.213]
            }, {
                "type": "MultiPolygon",
                "coordinates": [
                    [
                        [
                            [40, 40],
                            [20, 45],
                            [45, 30],
                            [40, 40]
                        ]
                    ],
                    [
                        [
                            [20, 35],
                            [45, 20],
                            [30, 5],
                            [10, 10],
                            [10, 30],
                            [20, 35]
                        ]
                    ],
                    [
                        [
                            [30, 20],
                            [20, 25],
                            [20, 15],
                            [30, 20]
                        ]
                    ]
                ]
            }]
        },
        "properties": {
            "title": "Test post",
            "description": "Testing post",
            "id": "1",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/1"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [{
                "type": "Point",
                "coordinates": [1, 1]
            }, {
                "type": "Point",
                "coordinates": [1.2, 0.5]
            }]
        },
        "properties": {
            "title": "OAuth test post",
            "description": "Testing oauth posts api access",
            "id": "95",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/95"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [1, 1]
        },
        "properties": {
            "title": "search by attribute",
            "description": "Some description",
            "id": "97",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/97"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [10.123, 26.213]
        },
        "properties": {
            "title": "another report",
            "description": "Some description",
            "id": "98",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/98"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [11.123, 24.213]
        },
        "properties": {
            "title": "Should be returned when Searching",
            "description": "Some description",
            "id": "99",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/99"
        }
    }]
}

Bounding Box Search Example

GET https://ushv3.dev/api/v2/posts/geojson?bbox=-2,-2,2,2

{
    "type": "FeatureCollection",
    "bbox": [-2, -2, 2, 2],
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [{
                "type": "Point",
                "coordinates": [1, 1]
            }, {
                "type": "Point",
                "coordinates": [1.2, 0.5]
            }]
        },
        "properties": {
            "title": "OAuth test post",
            "description": "Testing oauth posts api access",
            "id": "95",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/95"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [1, 1]
        },
        "properties": {
            "title": "search by attribute",
            "description": "Some description",
            "id": "97",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/97"
        }
    }]
}

Specific 'geometry_attribute' Example

GET https://ushv3.dev/api/v2/posts/geojson?geometry_attribute=second_point

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [1.2, 0.5]
        },
        "properties": {
            "title": "OAuth test post",
            "description": "Testing oauth posts api access",
            "id": "95",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/95"
        }
    }]
}

GET posts/:id

Get a single post

METHOD: GET
ENDPOINT: /api/v2/posts/:id/geojson
AUTHENTICATED: Yes

Query Parameters

Name	Type	Description
id	Required	The numerical id of the post being retrieved.

Example Request

GET http://ushv3.dev/api/v2/posts/1/geojson

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [{
                "type": "Point",
                "coordinates": [12.123, 21.213]
            }, {
                "type": "MultiPolygon",
                "coordinates": [
                    [
                        [
                            [40, 40],
                            [20, 45],
                            [45, 30],
                            [40, 40]
                        ]
                    ],
                    [
                        [
                            [20, 35],
                            [45, 20],
                            [30, 5],
                            [10, 10],
                            [10, 30],
                            [20, 35]
                        ]
                    ],
                    [
                        [
                            [30, 20],
                            [20, 25],
                            [20, 15],
                            [30, 20]
                        ]
                    ]
                ]
            }]
        },
        "properties": {
            "title": "Test post",
            "description": "Testing post",
            "id": "1",
            "url": "http:\/\/ushv3.dev\/api\/v2\/posts\/1"
        }
    }]
}

GET posts/geojson/:z/:x/:y

Get tiled geojson response

METHOD: GET
ENDPOINT: /api/v2/posts/geojson/:z/:x/:y
AUTHENTICATED: No

Query Parameters

Name	Type	Description
z	Required	Zoom level
x	Required	Tile x offset
y	Required	Tile y offset
q	Optional	Only Posts containing this search string will be returned, matched against post title and content
type	Optional	Only posts of this type will be returned: report, revision, comment or alert
locale	Optional	Only posts with matching locale will be returned
slug	Optional	Only posts with a matching slug will be returned
form_id	Optional	Only posts with this form_id will be returned
user_id	Optional	Only posts created by this user_id will be returned
created_before	Optional	Returned posts will have a created date smaller than this date
created_after	Optional	Returned posts will have a created date greater than this date
updated_before	Optional	Returned posts will have an updated date smaller than this date
updated_after	Optional	Returned posts will have an updated date greater than this date
bbox	Optional	Returned posts will have a point attribute within the specified bounding box. bbox expects lat lon values as follows: west,north,east,south
geometry_attribute	Optional	Returned GeoJSON will only include geometries for the specified attribute
order	Optional	Returned posts will be sorted in this order: ASC or DESC. Default: DESC
order_by	Optional	Returned posts will be sorted by this field. Default: created
limit	Optional	Limit number of results returned. Default: 50. Max: 500
offset	Optional	Posts returned will be offset by this number of results

Example Request

GET https://ushv3.dev/api/v2/posts/geojson/1/1/0

{
    "type": "FeatureCollection",
    "bbox": [0, 85.051128779807, 180, 0],
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [{
                "type": "Point",
                "coordinates": [12.123, 21.213]
            }, {
                "type": "MultiPolygon",
                "coordinates": [
                    [
                        [
                            [40, 40],
                            [20, 45],
                            [45, 30],
                            [40, 40]
                        ]
                    ],
                    [
                        [
                            [20, 35],
                            [45, 20],
                            [30, 5],
                            [10, 10],
                            [10, 30],
                            [20, 35]
                        ]
                    ],
                    [
                        [
                            [30, 20],
                            [20, 25],
                            [20, 15],
                            [30, 20]
                        ]
                    ]
                ]
            }]
        },
        "properties": {
            "title": "Test post",
            "description": "Testing post",
            "id": "1",
            "url": "http:\/\/ushv3.dev\/deployment\/httpdocs\/api\/v2\/posts\/1"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [11.123, 24.213]
        },
        "properties": {
            "title": "Should be returned when Searching",
            "description": "Some description",
            "id": "99",
            "url": "http:\/\/ushv3.dev\/deployment\/httpdocs\/api\/v2\/posts\/99"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [10.123, 26.213]
        },
        "properties": {
            "title": "another report",
            "description": "Some description",
            "id": "98",
            "url": "http:\/\/ushv3.dev\/deployment\/httpdocs\/api\/v2\/posts\/98"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [{
                "type": "Point",
                "coordinates": [1, 1]
            }, {
                "type": "Point",
                "coordinates": [1.2, 0.5]
            }]
        },
        "properties": {
            "title": "OAuth test post",
            "description": "Testing oauth posts api access",
            "id": "95",
            "url": "http:\/\/ushv3.dev\/deployment\/httpdocs\/api\/v2\/posts\/95"
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [1, 1]
        },
        "properties": {
            "title": "search by attribute",
            "description": "Some description",
            "id": "97",
            "url": "http:\/\/ushv3.dev\/deployment\/httpdocs\/api\/v2\/posts\/97"
        }
    }]
}