flickr.photos.geo.setLocation.xml

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<method name="flickr.photos.geo.setLocation" needslogin="1" needssigning="1" requiredperms="2">
	<description>Sets the geo data (latitude and longitude and, optionally, the accuracy level) for a photo.

Before users may assign location data to a photo they must define who, by default, may view that information. Users can edit this preference at &lt;a href=&quot;http://www.flickr.com/account/geo/privacy/&quot;&gt;http://www.flickr.com/account/geo/privacy/&lt;/a&gt;. If a user has not set this preference, the API method will return an error.</description>
</method>
<arguments>
	<argument name="api_key" optional="0">Your API application key. &lt;a href=&quot;/services/api/misc.api_keys.html&quot;&gt;See here&lt;/a&gt; for more details.</argument>
	<argument name="photo_id" optional="0">The id of the photo to set location data for.</argument>
	<argument name="lat" optional="0">The latitude whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated.</argument>
	<argument name="lon" optional="0">The longitude whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated.</argument>
	<argument name="accuracy" optional="1">Recorded accuracy level of the location information. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. Defaults to 16 if not specified.</argument>
	<argument name="context" optional="1">Context is a numeric value representing the photo's geotagginess beyond latitude and longitude. For example, you may wish to indicate that a photo was taken &quot;indoors&quot; or &quot;outdoors&quot;. &lt;br /&gt;&lt;br /&gt;
The current list of context IDs is :&lt;br /&gt;&lt;br/&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;0&lt;/strong&gt;, not defined.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;1&lt;/strong&gt;, indoors.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;2&lt;/strong&gt;, outdoors.&lt;/li&gt;
&lt;/ul&gt;&lt;br /&gt;
The default context for geotagged photos is 0, or &quot;not defined&quot;
</argument>
	<argument name="bookmark_id" optional="1">Associate a geo bookmark with this photo.</argument>
</arguments>
<errors>
	<error code="1" message="Not a valid date.">The date argument passed was incorrect.</error>
	<error code="96" message="Invalid signature">The passed signature was invalid.</error>
	<error code="97" message="Missing signature">The call required signing but no signature was sent.</error>
	<error code="98" message="Login failed / Invalid auth token">The login details or auth token passed were invalid.</error>
	<error code="99" message="User not logged in / Insufficient permissions">The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.</error>
	<error code="100" message="Invalid API Key">The API key passed was not valid or has expired.</error>
	<error code="105" message="Service currently unavailable">The requested service is temporarily unavailable.</error>
	<error code="111" message="Format &quot;xxx&quot; not found">The requested response format was not found.</error>
	<error code="112" message="Method &quot;xxx&quot; not found">The requested method was not found.</error>
	<error code="114" message="Invalid SOAP envelope">The SOAP envelope send in the request could not be parsed.</error>
	<error code="115" message="Invalid XML-RPC Method Call">The XML-RPC request document could not be parsed.</error>
	<error code="116" message="Bad URL found">One or more arguments contained a URL that has been used for abuse on Flickr.</error>
</errors>
</rsp>