Items
Get all items from a place
Http request with GET method:
http://iwannagothere.com/api/places/{geoname_id}/items
Parameters:
- key: User API key
- geoname_id: Geoname id of the place
- limit: Limit number of items. Default to 10
Example response:
<items type="array">
<item>
<address>Calle de Caños del Peral, 3, 28013, Madrid, Spain</address>
<category-id type="integer">3</category-id>
<coolness type="integer">0</coolness>
<created-at type="datetime">2009-05-20T08:45:10+02:00</created-at>
<delta type="boolean">false</delta>
<description>Great Mexican restaurant […]</description>
<highlighted-date type="datetime" nil="true"></highlighted-date>
<id type="integer">2645</id>
<keywords>madrid, spain, eating-drinking, abundant portions […]</keywords>
<lat>40.4185796</lat>
<long>-3.7089972</long>
<map-id type="integer">2444</map-id>
<nicetitle>entre-suspiro-y-suspiro</nicetitle>
<place-id type="integer">5</place-id>
<popularity type="float">5.0</popularity>
<published type="boolean">true</published>
<reviewed type="boolean">false</reviewed>
<summercontest09 type="boolean">false</summercontest09>
<title>Entre Suspiro y Suspiro</title>
<updated-at type="datetime">2009-07-20T07:07:00+02:00</updated-at>
<url></url>
<user-id type="integer">781</user-id>
<long_guid>http://iwannagothere.com/travel-guides/valencia/[…]</long_guid>
</item>
<item>
<address>Calle de Santa Isabel, 3, 28012, Madrid, Spain</address>
<category-id type="integer">3</category-id>
<coolness type="integer">0</coolness>
<created-at type="datetime">2009-03-11T17:04:12+01:00</created-at>
<delta type="boolean">false</delta>
<description>A nice and quite still cafetería at Cine Doré […]</description>
<highlighted-date type="datetime" nil="true"></highlighted-date>
<id type="integer">1899</id>
<keywords>madrid, spain, eating-drinking, cafetería at doré […]</keywords>
<lat>40.4117527</lat>
<long>-3.6992441</long>
<map-id type="integer">1776</map-id>
<nicetitle>cafeteria-at-dore-cinema</nicetitle>
<place-id type="integer">5</place-id>
<popularity type="float">5.0</popularity>
<published type="boolean">true</published>
<reviewed type="boolean">false</reviewed>
<summercontest09 type="boolean">false</summercontest09>
<title>Cafetería at Doré Cinema</title>
<updated-at type="datetime">2009-07-19T07:00:16+02:00</updated-at>
<url>http://www.mcu.es/cine/MC/FE/CineDore/Instalaciones.html</url>
<user-id type="integer">626</user-id>
<long_guid>http://iwannagothere.com/travel-guides/valencia/[…]</long_guid>
</item>
</items>
Error codes:
- 401: API Key not valid
- 404: Place not found
Get item information from id
Http request with GET method:
http://iwannagothere.com/api/items/{item_id}
Parameters:
- key: User API key
- item_id: Item id
Example response:
<item>
<address nil="true"></address>
<category-id type="integer">1</category-id>
<coolness type="integer" nil="true"></coolness>
<created-at type="datetime">2009-04-18T10:11:05+02:00</created-at>
<delta type="boolean">true</delta>
<description>Lorem ipsum dolor sit amet, consectetur […]</description>
<highlighted-date type="datetime" nil="true"></highlighted-date>
<id type="integer">3</id>
<keywords>madrid, spain, highlights, a nice place 3, </keywords>
<lat nil="true"></lat>
<long nil="true"></long>
<map-id type="integer">32</map-id>
<nicetitle>a-nice-place-3</nicetitle>
<place-id type="integer">2</place-id>
<popularity type="float" nil="true"></popularity>
<published type="boolean">true</published>
<reviewed type="boolean">false</reviewed>
<summercontest09 type="boolean">false</summercontest09>
<title>A nice place 3</title>
<updated-at type="datetime">2009-07-13T18:48:33+02:00</updated-at>
<url>http://example.com</url>
<user-id type="integer">1</user-id>
<long_guid>http://iwannagothere.com/travel-guides/valencia/[…]</long_guid>
</item>
Error codes:
- 401: API Key not valid
- 404: Item not found
Get photos of a item
Http request with GET method:
http://iwannagothere.com/api/items/{item_id}/get_photos
Parameters:
- key: User API key
- item_id: Item id
- size: Size of the photos (default 'square')
- limit: Limit number of photos. Default to 10
Available sizes:
- thumb: '120x120'
- square: '75x75'
- small: '100x100'
- home: '252x132'
- square_mini: '48x48'
- big: '500x500'
Example response:
<pictures>
<picture>
<content_type>image/jpg</content_type>
<width>500</width>
<height>375</height>
<url>http://a3.iwannagothere.com/userfiles/pictures/[…].jpg</url>
</picture>
<picture>
<content_type>image/jpg</content_type>
<width>500</width>
<height>375</height>
<url>http://a3.iwannagothere.com/userfiles/pictures/[…].jpg</url>
</picture>
<picture>
<content_type>image/jpg</content_type>
<width>800</width>
<height>533</height>
lt;url>http://a3.iwannagothere.com/userfiles/pictures/[…].jpg</url>
</picture>
<picture>
<content_type>image/jpeg</content_type>
<width>640</width>
<height>480</height>
<url>http://a3.iwannagothere.com/userfiles/pictures/[…].jpeg</url>
</picture>
</pictures>
Error codes:
- 401: API Key not valid
- 404: Item not found