This method allows any user to submit a new venue if they successfully authenticate. The venue_name, latitude and longitude fields must not all match an existing venue. Upon submission, the venue will have a 'pending' status until it has been approved by an admin user.
The latitude and longitude fields are required, but some users may not know this information. In this case, they can use the get_coords method to determine the necessary latitude and longitude by submitting the postcode of the venue.
The resulting venue_id code takes the form http://ives.info/xx/yyyyy, where xx is the two-letter country code and yyyyy is a unique five-character string in which each character is either a number between 0 and 9 or a letter of the alphabet excluding the five vowels and the letter Y.
This method does not currently verify that the data has gone into the database. If needed, you can verify the update yourself by using get_pending.
At the present time, only 'gb' is accepted as a valid country.
The id output field is only shown if the submitting user is an admin user.
| Required Arguments | |
|---|---|
| user_email | For authentication |
| user_password | For authentication |
| venue_name | Name of venue |
| country_code | Country in uppercase ISO 3166-1 Alpha-2 format |
| latitude | Latitude |
| longitude | Longitude |
| Optional Arguments | |
|---|---|
| alt_names | Alternative names for venue |
| previous_names | Previous names of venue |
| address | Address |
| town | Town |
| region | County, state or region |
| postal_code | Postcode/Zipcode |
http://api.ives.info/rest/venues/new?user_email=user@domain.com&user_password=fak3passw0rd &venue_name=Electric%20Ballroom&latitude=51.5397&longitude=-0.143 &address1=184%20Camden%20High%20Street&town=London&country_code=gb&postal_code=NW1%208QP
Errors will be returned in the form of an error document.
Sample XML Output<?xml version="1.0" encoding="UTF-8"?> <response status="ok"> <id>http://ives.info/gb/4d5rr</id> <message>New venue is pending approval</message> </response>