Directory Locations

Represents the collection of location descriptions maintained by the directory

Service URI

http://api.talis.com/1/dir/locations

GET

Returns an extended RDF description of the specified locations ordered by the location URIs. This differs from the Directory Resources service by returning an extended RDF description of the specified resources, including descriptions of related resources. Refer to the directory data model documentation for an explanation of the RDF used by the directory.

Required Parameters

• api_key – the user’s API key

Optional Parameters

• uri – describe location with this URI
• search – describe locations whose titles and descriptions contain these search terms
• group – a space delimited list of group URIs. The list of descriptions will be restricted to those locations that are members of this group.
• xsl – the URL of an XSL stylesheet to apply to the output

Typical HTTP Responses

• 200 – the request was successful, the descriptions are returned in the response
• 403 – the request failed because the api_key was invalid
• 500 – the request failed due to an internal server error

Sample Output

<?xml version="1.0"?>
<rdf:RDF
    xmlns:ad="http://schemas.talis.com/2005/address/schema#"
    xmlns:dctype="http://purl.org/dc/dcmitype/"
    xmlns:foaf="http://xmlns.com/foaf/0.1/"
    xmlns:dct="http://purl.org/dc/terms/"
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:dir="http://schemas.talis.com/2005/dir/schema#"
    xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#"
    xmlns:dc="http://purl.org/dc/elements/1.1/"
    xmlns:lib="http://schemas.talis.com/2005/library/schema#">

  <lib:Library rdf:about="http://directory.talis.com/res/dddconv-papid127718#self">
    <ad:regionName>British Columbia</ad:regionName>
    <ad:localityName>Prince George</ad:localityName>
    <ad:countryName>Canada</ad:countryName>
    <dc:title>Geoffrey R. Weller Library - University of Northern British Columbia</dc:title>
  </lib:Library>

  <lib:Library rdf:about="http://directory.talis.com/res/dddconv-papid130879#self">
    <ad:localityName>London</ad:localityName>
    <ad:countryName>England</ad:countryName>
    <dc:title>British Library</dc:title>
  </lib:Library>

  <lib:Library rdf:about="http://directory.talis.com/res/l20060313-id100832#self">
    <foaf:homepage rdf:resource="http://www.bl.uk"/>
    <ad:tel>+44 171 412 7000</ad:tel>
    <ad:postalCode>NW1 2DB</ad:postalCode>
    <geo:lat>51.529108</geo:lat>
    <dir:etag>2754ea96-624b-407c-ab5c-4960ebf79e5f</dir:etag>
    <geo:long>-0.127008</geo:long>
    <dc:title>British Library</dc:title>
    <ad:countryName>United Kingdom</ad:countryName>
    <ad:streetAddress>96 Euston Road, St. Pancras</ad:streetAddress>
    <ad:localityName>London</ad:localityName>
  </lib:Library>

  <lib:Library rdf:about="http://directory.talis.com/res/pap060331-223#self">
    <foaf:mbox rdf:resource="mailto:AnthropologyLibrary@thebritishmuseum.ac.uk"/>
    <foaf:homepage rdf:resource="http://www.thebritishmuseum.ac.uk/ethno/ethclosureslib.html"/>
    <ad:tel>020 7323 8031</ad:tel>
    <ad:streetAddress>Centre for Anthropology, British Museum, Bloomsbury</ad:streetAddress>
    <ad:postalCode>WC1B 3DG</ad:postalCode>
    <ad:localityName>London</ad:localityName>
    <ad:countryName>England</ad:countryName>
    <dc:title>British Museum Ethnography Library</dc:title>
  </lib:Library>

  <lib:Library rdf:about="http://directory.talis.com/res/dddconv-papid564467#self">
    <dc:title>British Geological Survey Library</dc:title>
  </lib:Library>

  <lib:Library rdf:about="http://directory.talis.com/res/dddconv-papid663454#self">
    <dc:title>British Library</dc:title>
  </lib:Library>

  <lib:Library rdf:about="http://directory.talis.com/res/r1146836030081#self">
    <ad:postalCode>LS23 7BQ</ad:postalCode>
    <ad:streetAddress>Boston Spa</ad:streetAddress>
    <dc:title>British Library at Boston Spa</dc:title>
    <dir:etag>809d8e76-efc6-4b8e-9124-0f382cb95980</dir:etag>
    <ad:localityName>Wetherby</ad:localityName>
    <ad:regionName>West Yorkshire</ad:regionName>
    <ad:countryName>England</ad:countryName>
    <geo:lat>53.918696</geo:lat>
    <geo:long>-1.322823</geo:long>
  </lib:Library>
</rdf:RDF>