SuperMap Data Requests

All API responses below are ETag-aware: they publish the ETag HTTP response header and look for it in the If-Match request header. If a given request specifies a valid ETag, the API responds with a 304 Not Modified status code and an empty body.

Provided Endpoints

List Tags
List Collections
List Points
List Suppliers
One Collection
One Point
One Supplier

List Tags

Parameters

format: html (default), xml, php (serialized PHP)
count: Optional number of tags to return, default: 100
offset: Optional starting offset in list of tags, default: 0
tags: Optional list of tags to search as comma-delimited list. Results will include points that match any tags.
only_tags: Optional true/false flag for rollup of tags with point counts, 1, default: 0
combinations: Optional true/false flag for inclusion of second level of nested coincident tags, 1, default: 0. Ignored when only_tags is false.

Examples

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<tags total="3" count="1" offset="1">
  <link rel="prev" href="http://data.map.london2012.com/tags.php?format=xml&count=1&offset=0"/>
  <link rel="next" href="http://data.map.london2012.com/tags.php?format=xml&count=1&offset=2"/>
  <tag point_id="5943">test</tag>
</tags>

With only_tags:

<?xml version="1.0" encoding="utf-8"?>
<tags total="1" count="2" offset="0"> 
    <tag points="2">hello</tag> 
    <tag points="2">world</tag> 
</tags>

With only_tags and combinations:

<?xml version="1.0" encoding="utf-8"?>
<tags count="2" offset="0">
  <tag>
    hello
    <tags>
      <tag points="2">world</tag>
      <tag points="1">hola</tag>
      <tag points="1">mundo</tag>
    </tags>
  </tag>
  <tag>
    hola
    <tags>
      <tag points="1">hello</tag>
      <tag points="1">mundo</tag>
      <tag points="1">world</tag>
    </tags>
  </tag>
</tags>

List Collections

Parameters

user: Optional username to limit retrieved collections.
format: html (default), xml, php (serialized PHP)
count: Optional number of collections to return, default: 100
offset: Optional starting offset in list of collections, default: 0
include_point: Optional true/false flag for inclusion of first point for each collection, 1, default: 0
include_internal: Optional true/false flag for inclusion of extra content detail for included points, 1, default: 0

Examples

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<collections>
    <link rel="prev" href="http://data.map.london2012.com/collections.php?format=xml&count=2&offset=0"/>
    <link rel="next" href="http://data.map.london2012.com/collections.php?format=xml&count=2&offset=4"/>
    <collection id="86">
        <link href="http://data.map.london2012.com/collections.php?id=86"/>
        <title>Accessible Transport </title>
        <published timestamp="1212142416">2008-05-30 10:13:36</published>
        <body><![CDATA[The Accessible Transport Strategy was launched by London 2012 at the Transport Museum.]]></body>
    </collection>
    <collection id="85">
        <link href="http://data.map.london2012.com/collections.php?id=85"/>
        <title>Testing Collection</title>
        <published timestamp="1211923356">2008-05-27 21:22:36</published>
        <body><![CDATA[blah blah blah]]></body>
    </collection>
</collections>

List Points

Parameters

user: Optional username to limit retrieved points.
format: html (default), xml, php (serialized PHP), atom
count: Optional number of points to return, default: 100
offset: Optional starting offset in list of points, default: 0
match: Optional free-search text.
tag: Optional tag to match.
tags: Optional comma-delimited list of tags to match. Returns points that match any one of the tags values. Note that passing both tag and tags results in an intersection of the two results.
min_date: Optional inclusive starting date in "YYYY-MM-DD HH:MM:SS" format.
max_date: Optional exclusive ending date in "YYYY-MM-DD HH:MM:SS" format.
include_internal: Optional true/false flag for inclusion of first point for each collection, 1, default: 0
category: Optional category filter for points pulled from London2012.com website. Multiple, comma-separated category names are acceptable. Possible categories include blog, news, photo, video, webcam, venue, event, or other.
nuts: Optional NUTS code filter. Partially matched to beginning of string, e.g. "UKI210" returns points in "UKI210405".
bbox: Optional geographic bounding box filter. Comma-separted floating point values for latitude, longitude in west, south, east, north order. E.g. Greater Manchester area correspond to -2.38,53.38,-2.08,53.56, for 2.38°W, 53.38°N to 2.08°W, 53.56°N.

Examples

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<points total="497" count="2" offset="0">
    <link rel="prev" href="http://data.map.london2012.com/points.php?format=xml&count=2&offset=0"/>
    <link rel="next" href="http://data.map.london2012.com/points.php?format=xml&count=2&offset=4"/>
    <point id="585" position="1">
        <link href="http://example.london2012.com/points.php?id=585"/>
        <title>VISA London 2012 party</title>
        <location lat="0" lon="0"></location>
        <body><![CDATA[On 24 August 2008 we celebrate the moment that the Olympic Flag is handed over to London. An event is being held in The Mall to welcome the world to London in 2012. It will be broadcast live on BBC One and Radio 2.]]></body>
        <image>
            <thumb src="http://example.london2012.com/images/4887499d17d62.jpg" width="100" height="66"/>
            <medium src="http://example.london2012.com/images/4887499c045ab.jpg" width="320" height="213"/>
            <full src="http://example.london2012.com/images/4887499997758.jpg" width="504" height="336"/>
        </image>
    </point>
    <point id="352" position="2">
        <link href="http://example.london2012.com/points.php?id=352"/>
        <title>London 2012 invites the UK to Handover celebrations</title>
        <location lat="51.504886" lon="-0.134067"></location>
        <body><![CDATA[London 2012 has announced UK-wide plans for celebrating the moment the Olympic Flag is handed from Beijing to London at the Olympic Games Closing Ceremony on 24 August. They include a free concert on The Mall that will be relayed to big screens in other towns and cities.]]></body>
    </point>
</points>

List Suppliers

Parameters

format: html (default), xml
count: Optional number of suppliers to return, default: 100
offset: Optional starting offset in list of suppliers, default: 0
match: Optional free-search text.
nuts: Optional NUTS code filter. Partially matched to beginning of string, e.g. "UKI210" returns suppliers in "UKI210405".
bbox: Optional geographic bounding box filter. Comma-separted floating supplier values for latitude, longitude in west, south, east, north order. E.g. Greater Manchester area correspond to -2.38,53.38,-2.08,53.56, for 2.38°W, 53.38°N to 2.08°W, 53.56°N.

Examples

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<suppliers total="3" count="2" offset="0">
    <supplier id="18">
        <link href="http://example.london2012.com/suppliers.php?id=18"/>
        <name>Adlington Welding Supplies Ltd</name>
        <location level="UK" lat="53.662008" lon="-2.628097"/>
        <postcode source="postcode" outcode="PR7" incode="1QD" nuts="UKD4302028" nuts1="UKD" nuts2="UKD4" nuts3="UKD43" lau1="UKD4302" lau2="UKD4302028"/>
        <external path="get-involved/business-network/supplierlistings/adlington-welding-supplies-ltd.php" href="http://www.london2012.com/get-involved/business-network/supplierlistings/adlington-welding-supplies-ltd.php"/>
        <contractor>Olympic Stadium</contractor>
        <service>Welding Supplies</service>
        <constituency>Chorley</constituency>
        <region>North West</region>
        <body><![CDATA[Olympic Stadium
Welding Supplies
Chorley
North West]]></body>
    </supplier>
    <supplier id="9">
        <link href="http://example.london2012.com/suppliers.php?id=9"/>
        <name>ESAB ltd</name>
        <location level="UK" lat="51.684361" lon="-0.023798"/>
        <postcode source="postcode" outcode="EN8" incode="7TF" nuts="UKH2301025" nuts1="UKH" nuts2="UKH2" nuts3="UKH23" lau1="UKH2301" lau2="UKH2301025"/>
        <external path="get-involved/business-network/supplierlistings/esab-ltd.php" href="http://www.london2012.com/get-involved/business-network/supplierlistings/esab-ltd.php"/>
        <contractor>Olympic Stadium</contractor>
        <service>Welding Supplies</service>
        <constituency>Broxbourne</constituency>
        <region>East of England</region>
        <body><![CDATA[Olympic Stadium
Welding Supplies
Broxbourne
East of England]]></body>
    </supplier>
</suppliers>

One Collection

Parameters

id: Required numeric ID of collection
format: html (default), xml, php (serialized PHP)
include_internal: Optional true/false flag for inclusion of extra content detail for included points, 1, default: 0

Examples

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<collection id="73">
    <link href="http://data.map.london2012.com/collections.php?id=73"/>
    <title>Construction College</title>
    <published timestamp="1210772085">2008-05-14 13:34:45</published>
    <body><![CDATA[New jobs and improved skills - training and working on the Olympic Park site. London 2012 is committed to creating a positive employment and economic legacy for and the UK after the Games.]]></body>
    <preview>
        <medium src="http://road.tiles.map.london2012.com/map.php?width=220&height=140&markers[]=51.540026,-0.010471&markers[]=51.554224,-0.014247&markers[]=51.554438,-0.014762" width="220" height="140"/>
    </preview>
    <points>
        <point id="299" position="1">
            <link href="http://data.map.london2012.com/points.php?id=299"/>
            <title>Construction workforce</title>
            <location lat="51.540068" lon="-0.010477"></location>
            <body><![CDATA[The Olympic Park construction workforce is expected to peak at around 10,000. Combined with the Olympic Village and the Stratford City development, construction demand could reach around 20,000 between summer 2009 and 2011.]]></body>
            <image>
                <thumb src="http://example.london2012.com/482aee7e752ec.jpg" width="100" height="70"/>
                <medium src="http://example.london2012.com/482b7e5f64e5d.jpg" width="320" height="225"/>
                <full src="http://example.london2012.com/482aee7e2bf96.jpg" width="1669" height="1174"/>
            </image>
        </point>
        <point id="298" position="2">
            <link href="http://data.map.london2012.com/points.php?id=298"/>
            <title>Plant training centre</title>
            <location lat="51.554243" lon="-0.014263"></location>
            <body><![CDATA[A construction plant training centre opened on the Olympic Park site in February 2008. 
            
            Minister for the Olympics, Tessa Jowell and Olympic Delivery Authority Chairman, John Armitt pictured with Construction College staff and trainees.]]></body>
            <image>
                <thumb src="http://example.london2012.com/482aee411c60b.jpg" width="100" height="66"/>
                <medium src="http://example.london2012.com/482b7e5deb611.jpg" width="320" height="213"/>
                <full src="http://example.london2012.com/482aee40caa15.jpg" width="1400" height="934"/>
            </image>
        </point>
    </points>
</collection>

One Point

Parameters

id: Required numeric ID of point
format: html (default), xml, php (serialized PHP)
include_internal: Optional true/false flag for inclusion of extra content detail for returned points, 1, default: 0

Examples

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<point id="299" position="1">
    <link href="http://data.map.london2012.com/points.php?id=299"/>
    <title>Construction workforce</title>
    <location lat="51.540068" lon="-0.010477"></location>
    <body><![CDATA[The Olympic Park construction workforce is expected to peak at around 10,000. Combined with the Olympic Village and the Stratford City development, construction demand could reach around 20,000 between summer 2009 and 2011.]]></body>
    <image>
        <thumb src="http://example.london2012.com/482aee7e752ec.jpg" width="100" height="70"/>
        <medium src="http://example.london2012.com/482b7e5f64e5d.jpg" width="320" height="225"/>
        <full src="http://example.london2012.com/482aee7e2bf96.jpg" width="1669" height="1174"/>
    </image>
</point>

One Supplier

Parameters

id: Required numeric ID of supplier
format: html (default), xml

Examples

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<supplier id="1">
    <link href="http://example.london2012.com/suppliers.php?id=1"/>
    <name>Access Technologies Ltd</name>
    <location level="UK" lat="52.666095" lon="-2.368233"/>
    <postcode source="postcode" outcode="TF11" incode="8DR" nuts="UKG2201034" nuts1="UKG" nuts2="UKG2" nuts3="UKG22" lau1="UKG2201" lau2="UKG2201034"/>
    <external path="get-involved/business-network/supplierlistings/access-technologies-ltd.php" href="http://www.london2012.com/get-involved/business-network/supplierlistings/access-technologies-ltd.php"/>
    <contractor>Olympic Stadium</contractor>
    <service>Steelworks</service>
    <constituency>The Wrekin</constituency>
    <region>West Midlands</region>
    <body><![CDATA[Olympic Stadium
Steelworks
The Wrekin
West Midlands]]></body>
</supplier>