Feeds

You can subscribe to these feeds or use them to plot data on a map, e.g. with the Cloudmade Webmaps Lite API or the Google Maps API.

Sourcecode

Download an archive of all the source code that drives this site.

Points API

If you're using the Guardian API and want to know what we know about article locations, feel free to make a call to points.php to ask us.

Parameters

article
Guardian article id.
articles
Optional comma-separated list of Guardian article ids.
woe
Optional comma-separated list of Yahoo Where-on-Earth (WOE) ids (from Yahoo GeoPlanet, as used by Flickr, Upcoming, FireEagle, etc.)
woes
Optional comma-separated list of Yahoo Where-on-Earth (WOE) ids
format
html (default), json, js (jsonp, for use with a callback), rss (with georss), php (serialized PHP)
count
Optional number of collections to return, default: 10
offset
Optional starting offset in list of collections, default: 0

Examples

Responses

JS with Callback

            
addExistingPlaces(
  [
    {
      "article_id": 338373510,
      "woe_id": 2457170,
      "latitude": "36.167",
      "longitude": "-86.778",
      "place_id": "SiVf._mbBZnlkED4",
      "place_path": "\/United+States\/Tennessee\/Nashville",
      "place_type": "locality",
      "place_name": "Nashville, Tennessee, United States",
      "created": "2009-03-04 12:24:01",
      "article": {
        "id": 338373510,
        "title": "Liveblogging the Obama-McCain town hall debate",
        "published": "2008-10-08",
        "url": "http:\/\/www.guardian.co.uk\/world\/oliverburkemanblog\/2008\/oct\/07\/uselections2008.barackobama1"
      }
    }
  ]
)