Flag Search

Request Method / URL: GET http://www.flagr.com/api/flags/

Note: if you wish to search an area, the minimum and maximum must be expressed for both longitude and latitude. Otherwise no restriction on location is made.

Sample XML Response: <?xml version="1.0" encoding="utf-8"?> <flags total="19"> <flag href="http://www.flagr.com/api/flags/82"> <title>Mario's Pizza</title> <description>Get the spinach slice. </description> <user>BobThebuilder</user> <source>online</source> <created_at>2006-05-04T11:17:01-04:00</created_at> <location> <longitude>-114.521484375</longitude> <latitude>34.2345123623699</latitude> <street>21 Main Street</street> <city>San Francisco</city> <state>CA</state> <country>US</country> </location> </flag> ... </flags>

Flag Retrieval

Request Method / URL: GET http://www.flagr.com/api/flags/<flag_id> Sample XML Response: <?xml version="1.0" encoding="utf-8"?> <flag href="http://www.flagr.com/api/flags/82"> <title>Mario's Pizza</title> <description>Get the spinach slice. </description> <user>BobThebuilder</user> <source>online</source> <created_at>2006-05-04T11:17:01-04:00</created_at> <location> <longitude>-114.521484375</longitude> <latitude>34.2345123623699</latitude> <street>21 Main Street</street> <city>San Francisco</city> <state>CA</state> <country>US</country> </location> <photo href="http://www.flagr.com/photos/BobTheBuilder/18"/> <photo href="http://www.flagr.com/photos/BobTheBuilder/20"/> <comment> <user>comment</user> <message>Testing</message> </comment> </flag>

Flag Creation

Adding a flag is little more complicated than the other operations. HTTP basic authentication is used to authenticate the session. Simply use your Flagr username and password and you should be all set.

Additionally, either an address or both a longitude and a latitude are required to create a flag. If the address can not be geocoded or the longitude and latitude are not valid, an xml response will be returned alerting you to the fact. Your flag will not be created until the problem is corrected.

Note: Please use https to add flags as it ensures that the user's password is protected.

Parameters:

• latitude - float (≥ -180 and ≤ 180) - the latitude of the new flag.
• longitude - float (≥ -180 and ≤ 180) - the longitude of the new flag
• address - string - a string representing the address of the new flag.

• title - string (optional) - the title of the new flag.
• description - string (optional) - the description of the new flag.
• tags - string (optional) - a string of space seperated tags for the new flag.
• photo_url - string (optional) - the url of an image to attach to the flag. The image must be smaller than 2 MB.