Map Feedback API Developer's Guide

Feedback Submission Request Body

The request body feedback request data structure contains the general information about the feedback request.

Table 1. Request Body Elements
Element	Required	Data Type	Description
`type`	Yes	String	Must be either `Point`, `Line`, or `Area`. Note: This value varies for the different categories of feedback submissions. For more information, see the relevant section in the Feedback Request Properties. A `Point` is a single WGS-84 compliant geocoordinate set indicating one point on the globe. A `Line` is a set of WGS-84 compliant geocoordinates that defines a line with a start and end point.
`coordinates`	Yes	Geo coordinate (Point), Geo coordinate[] (Line), Geo coordinate [] (Area)	Longitude WGS-84 degrees between -180 and 180, latitude WGS-84 degrees between -90 and 90, and an optional altitude. The Geo Coordinate itself an array of these two values: [ Lng,Lat]
`properties`	Yes	Feedback Request Properties	Set of information that defines the feedback submitted

Geo Coordinate Point Example

The coordinate for a point would be described with these properties:


"coordinates":[-122.44628,37.77017]

Geo Coordinate Line Example

The coordinates for a line are described as an array with more than one points with these properties:


"coordinates": [
  [-87.63667,41.87951],
  [-87.6367,41.88007]
  ]

Geo Coordinate Area Example

The coordinates for an area are described as an array of multi-arrays with coordinate lists that represent multi-polygon structures. Each structure can describe a polygon area and can optionally be followed by an area that defines a shape that should be excluded from the initial polygon, allowing for the creation of complex shapes. A good example is a lake with an island, where the lake is the first polygon and the second polygon defines the island.


"type":"Area",
"coordinates":"coordinates": [
  [
  [ [ 121.35131, 24.94922 ],
    [ 121.35156, 24.94878 ],
    [ 121.35258, 24.94925 ],
    [ 121.35249, 24.94948 ],
    [ 121.35131, 24.94922 ] ]
  ]
]