OSM V0.4/Protocol Feature Proposals/Get contributors

Purpose

The client shall be able to retrieve details of every user who contributed to an area of map.

Why is this feature important?

• To fulfil the Attribution requirements of our creative commons license.

Proposed Feature

Below the client requests details of who contributed to a certain area of map. Assume that 80n mapped the area and SteveC added some points of interest. The server reports a list of 2 contributors.

Get Contributors

If the OSM server receives the GET_request message containing:

Method	OSM_Protocol_Command	OSM_Command_Parameters
GET_request	/Contributors	?bbox=bllon,bllat,trlon,trlat

upon successful command execution, the OSM server shall respond with a GET_response message containing:

Method	get_response_body
GET_Response	<contributor_list> <contributor> <id>1</id> <display_name>SteveC</display_name> </contributor> <contributor> <id>2</id> <display_name>80n</display_name> </contributor> <contributor_list/>

Applicable Status Codes of the GET_response message are:

Status Code	Description
OK	The requested command could be successfully executed.
Bad Request	An unknown command had been received.