MediaWiki API result
This is the HTML representation of the JSON format. HTML is good for debugging, but is unsuitable for application use.
Specify the format parameter to change the output format. To see the non-HTML representation of the JSON format, set format=json.
See the complete documentation, or the API help for more information.
{
"batchcomplete": "",
"continue": {
"gapcontinue": "The_Database_API_reference_discovery",
"continue": "gapcontinue||"
},
"warnings": {
"main": {
"*": "Subscribe to the mediawiki-api-announce mailing list at <https://lists.wikimedia.org/postorius/lists/mediawiki-api-announce.lists.wikimedia.org/> for notice of API deprecations and breaking changes."
},
"revisions": {
"*": "Because \"rvslots\" was not specified, a legacy format has been used for the output. This format is deprecated, and in the future the new format will always be used."
}
},
"query": {
"pages": {
"19": {
"pageid": 19,
"ns": 0,
"title": "Terms and conditions, Copyright, Fair Use, etc.",
"revisions": [
{
"contentformat": "text/x-wiki",
"contentmodel": "wikitext",
"*": "Our implementation of the map is provided to support the work of the University and its associated institutions. You are welcome to use it and its associated services (the [[Map Annotation | interactive]] and [[Map Annotation | programmatic]] annotation tools, the [[The Embedding API | embedding]], [[The Tile API | tile]], and [[The Database API | database]] APIs) and any derived or printed copies, for this purpose in any way that that is compatible with [http://www.admin.cam.ac.uk/univ/mission.html the mission of the University] to contribute to society through the pursuit of education, learning, and research at the highest international levels of excellence. If you are not clear if you proposed use is consistent with this then please ask (contact [mailto:service-desk@ucs.cam.ac.uk service-desk@ucs.cam.ac.uk]).\n\nThere are however some things that you must or must not do and they are covered below.\n\n==Fair Use==\n\nWe provide the on-line map and its associated services (annotation tools, embedding, tile, and database APIs) for others to use and in the hope that they will be useful. However placing an excessive load on the map infrastructure will degrade performance for all map users. Please try to keep the load you place on the map infrastructure to a minimum, for example by reducing the number of tiles that you load in one go or by appropriately caching results rather than always repeating requests. If you believe that you have an application that will cause, or is causing, problems to our infrastructure then please contact us at [mailto:service-desk@ucs.cam.ac.uk service-desk@ucs.cam.ac.uk] to discuss your needs.\n\n==The annotation service==\n\nPermission is granted to use the various aspects of the annotation service in accordance with the published instructions and specifications. The annotation service is open to various forms of abuse and everyone is expected to exercise care when using it. Using it to bring the University or any other organisation into disrepute, to publicise otherwise confidential information, or to compromise the privacy of individuals is expressly prohibited. In the event of misuse, individual annotations may be suppressed and some or all of the annotation features may be withdrawn.\n\n==Using the tiles and map images==\n\nThe images and resulting tiles that make up the map are generated from information provided by [http://www.openstreetmap.org/ OpenStreetMap]. The [http://www.openstreetmap.org/copyright OpenStreetMap licence] (ODbL1.0) allows for this data to be reused in this way, but requires that OpenStreetMap is credited and that it is made clear that the maps are available under OSM's licence terms. See [http://www.openstreetmap.org/copyright the OSM copyright page] for guidance on how to achieve this. The default map, on it's own page or when included in an <iframe>, includes a suitable OpenStreetMap credit. This issue mainly applies to anyone using the Tile API or printable versions of the map.\n\nMap tiles and print maps are also copyright © University of Cambridge. If you use our tiles or map images then as well as crediting OpenStreetMap please also credit the University of Cambridge and University Information Services for providing them. This is in your interest, because it will help to ensure that resources continue to be available to support the map system. \n\nWe suggest \"Base map data copyright © OpenStreetMap contributors. Map tiles from the University of Cambridge Official Map, provided and managed by University Information Services\". Where appropriate, please link 'University of Cambridge Official Map' to https://map.cam.ac.uk/ and 'University Information Services' to http://www.uis.cam.ac.uk/. Replace 'Map tiles' with 'Map images' for print maps.\n\n==Using the Database API==\n\nThe contents of the institution index database are copyright \u00a9 2012 University of Cambridge. Permission is granted for reasonable use of this data via the published APIs as described above. Please credit this use \"University data copyright University of Cambridge, used with permission. Data provided and managed by the University Computing Service\". Where possible, please link 'University of Cambridge' to http://www.cam.ac.uk/ and 'University Computing Service' to http://www.ucs.cam.ac.uk/.\n\nThe contents of the map database are copyright \u00a9 OpenStreetMap contributors and licensed under the ODbL v1.0 license. See [http://www.openstreetmap.org/copyright OpenStreetMap] for more details."
}
]
},
"10": {
"pageid": 10,
"ns": 0,
"title": "The Database API",
"revisions": [
{
"contentformat": "text/x-wiki",
"contentmodel": "wikitext",
"*": "Please read [[Terms and conditions, Copyright, Fair Use, etc.]] if you are going to use this API.\n\nThis page describes version 6 of the API, made live on February 20, 2013.\n\nVersion 5 ([[The_Database_API_v5|old documentation]]) has been withdrawn. You can see a [[The_Database_API_v6_changes|summary of changes from version 5]].\n\nThere is an experimental [[Python Database API interface]] if you want to work with this API from Python.\n\n==Introduction==\n\nThe same information as provided by the [[The Map URL API]] is provided in machine readable form using URLs like this:\n\n <nowiki>https://map.cam.ac.uk/v6.json?</nowiki>q=''search''[&partial=yes]\n <nowiki>https://map.cam.ac.uk/v6.json?</nowiki>bb=''boundingbox''\n <nowiki>https://map.cam.ac.uk/v6.json?</nowiki>ref=''ref''\n <nowiki>https://map.cam.ac.uk/v6.json?</nowiki>inst=''inst''\n\nwith the same interpretation as in [[The Map URL API]] (note that one=list is not relevant in the q= and bb= variants, and the simple <em>name </em>variant is not available to the API - just use <strong><nowiki>http://map.cam.ac.uk/v6.json?</nowiki>q=<em>name</em></strong>).\n<p>\n\tAn additional option <strong>?limit=<em>limit</em></strong> is also available on the ?q and ?bb forms which limits the number of results returned to the number given. For example</p>\n\n <nowiki>https://map.cam.ac.uk/v6.json?</nowiki>q=saint&limit=15\n\nValues of query parameters, such as <strong>?q=</strong> are limited to 2,000 characters. For <strong>?inst=</strong> and <strong>?ref=</strong> queries, a maximum of 25 may be requested at once (separating the requested codes with '|').\n\n<p>Also, there is another query type available to the database API not available when using a consumer URL. <strong>?alpha=<em>letter</em></strong> will provide an alphabetically ordered listing of the entire institution database for that letter. This is used as the basis for the directory page and other alphabetic listings. Please cache the results of this search so that it does not place an unwarranted load on the database. You can also filter by type, for example:</p>\n\n <nowiki>https://map.cam.ac.uk/v6.json?</nowiki>alpha=s&filter=college\n\n<p>The version 6 API also supports discovery and navigation around the reference hierarchy. See [[The Database API reference discovery]] for more details. In addition, the [https://map.cam.ac.uk/refbrowser/ interactive browser] (also linked from the 'More...' menu) can be useful when exploring the data available and when identifying the various codes used.</p>\n\n<p>\n\tThe 'v6' is a version number, allowing for potential backward compatibility if we change the spec at some point in the future. Only v6 is useful for now. v5 was deprecated in January 2013 and backward compatibility was not provided.</p>\n<p>\n\tThe 'json' part indicates the results are provided in JSON format. We may produce other formats in future, in which case URLs such as <strong><nowiki>https://map.cam.ac.uk/v6.xml?</nowiki>...</strong> would be introduced, but for the time being, only JSON is supported.</p>\n<p>\n\tThe result is a JSON array:</p>\n<p style=\"margin-left: 40px; \">\n\t[ { "type": <em>type0</em>, ... }, { "type": <em>type1</em>, ...<em> </em>}, ... ]</p>\n<p>\n\twhere each object in the array is an entity matching the request. If there are <strong>no results</strong>, an empty array is produced. If there is <strong>only one result</strong>, it is still provided as an array (of one object), not as just the object. Note also that requests by inst and ref may occasionally also yield more than one result. </p>\n<p>\n\tThe content of the rest of each object depends on:</p>\n<ul>\n\t<li>\n\t\t<em>type</em></li>\n\t<li>\n\t\twhat information is available for each result</li>\n\t<li>\n\t\twhether the request was a search (q=... or <em>name</em>) or direct look up (ref or inst URLs)</li>\n</ul>\n<p>\n\t<i>type</i> is one of:</p>\n<p style=\"margin-left: 40px; \">\n\t<strong>error<br />\n\tinstitution<br />\n\tsite<br />\n\tcollege</strong><br />\n\t<strong>building<br />\n\tentrance</strong><br />\n\t<strong>nonuniversity</strong><br />\n <strong>virtualsite</strong><br />\n\t<strong>street</strong><br />\n\t<strong>more</strong></p>\n\n==Error reports==\n\n<p>\n\tIf <em>type</em> is <strong>error</strong>, then the http request will also return an appropriate status code, typically 400 indicating the request is malformed (wrong combination of query parameters, for example) or 404 (api version or format not implemented for example). The consumer should also be prepared to handle other HTTP errors generated by the server which will not provide JSON data (500 for example). Apart from these, all correctly formed requests will generate status 200. Note that this includes requests with no results (which produce an empty array).</p>\n<p>\n\tNote also that if you mis-spell 'v6.json' (for example, say you incorrectly use a capital V), then the URL may be interpreted as the end-user form M:/<em>name</em> so you would get a stream of HTML!</p>\n\n<p>v5.json, the now deprecated API, will always produce an error like this (actually an HTTP 410 error).</p>\n\n==Entity structure==\n<p>\n\tContents of JSON objects representing entities found are as follows, by type.</p>\n\n<p>In general, each request includes information about things linked to each result: the buildings for an institution, the entrances to a site and so on. This referencing only applies one level deep: those parts are excerpted: they do not themselves contain further entities to which they refer. If you need these, you would have to request the content by ref or inst from the parent. The fields omitted in the second level are indicated with an asterisk in the tables that follow.\n\n===error===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<strong>error</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tcode</td>\n\t\t\t<td>\n\t\t\t\tthe HTTP status code</td>\n\t\t\t<td>\n\t\t\t\tint</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\terror</td>\n\t\t\t<td>\n\t\t\t\ttext describing the error</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n</table>\n\n===more===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<strong>more</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\tWhen the number of results is limited by <strong>?limit=<em>limit</em></strong>, the last element in the array of results may indicate \"more\", that there are more results that could be found but the limit was reached. Because certain results are redacted in some circumstances, note that the number of elements in the array may be fewer than limit+1 even if the limit is reached. \"more\" is not included if all the available results are returned. There isn't any way to page through the results: the search needs to be made more specific.</td>\n\t\t</tr>\n</table>\n\n===institution===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<strong>institution</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tinst</td>\n\t\t\t<td>\n\t\t\t\tthe institution code of the entity</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\trole</td>\n\t\t\t<td>\n\t\t\t\tkind of institution</td>\n\t\t\t<td>\n\t\t\t\tstring, one of:<br />\n\t\t\t\tcollege<br />\n\t\t\t\tacademic<br />\n\t\t\t\tadmin<br />\n\t\t\t\tnonacademic<br />\n\t\t\t\tmrc<br />\n\t\t\t\tlibrary<br />\n\t\t\t\tmuseum<br />\n\t\t\t\tcafe<br />\n\t\t\t\tlecture</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tprefix</td>\n\t\t\t<td>\n\t\t\t\tthe name prefix</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tfor example, 'Department of', 'Centre for'</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tname</td>\n\t\t\t<td>\n\t\t\t\tthe substantive part of the institution name</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tfor example, 'Geography'. This is the field to sort on for alphabetically ordered institutions</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tsuffix</td>\n\t\t\t<td>\n\t\t\t\tthe name suffix</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\toften an acronym or former name, which would often be presented in parentheses. For example, when name is 'Advanced Photonics and Electronics', prefix is 'Centre for ' and suffix would be 'CAPE'. The whole might be presented as 'Advanced Photonics and Electronics (CAPE), Centre for' or 'Centre for Advanced Photonics and Electronics (CAPE)'</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tparent*</td>\n\t\t\t<td>\n\t\t\t\twhen the entity is subsidiary to another, this is the institution code of the parent institution</td>\n\t\t\t<td>\n\t\t\t\tentity</td>\n\t\t\t<td>\n\t\t\t\tfor example the faculty of a department</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\toptions</td>\n\t\t\t<td>\n\t\t\t\tarbitrary space separated tokens indicating arbitrary options</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tsd</td>\n\t\t\t<td>\n\t\t\t\tthe subdomain of the entity</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\te.g. "lucy-cav"</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tinfo</td>\n\t\t\t<td>\n\t\t\t\tcontact information (etc)</td>\n\t\t\t<td>\n\t\t\t\tarray of objects (see below)</td>\n\t\t\t<td>\n\t\t\t\t<p>\n\t\t\t\t\tfor example:</p>\n\t\t\t\t<p>\n \"info\": [<br/>\n { \"type\": \"founded\", \"founded\": \"1505\" },<br/>\n { \"type\": \"address\", \"address\": [<br/>\n { \"type\": \"street\", \"street\": \"St Andrew's Street\" },<br/>\n { \"type\": \"place\", \"place\": \"Cambridge\" },<br/>\n { \"type\": \"postcode\", \"postcode\": \"CB2 3BU\" },<br/>\n {\"type\": \"location\", \"location\": {<br/>\n \"type\": \"college\", \"ref\": \"CHRISTS\", \"name\": \"Christ's College\",<br/>\n \"lat\": 52.206145, \"lon\": 0.122944, \"primitive\": \"w\", \"id\": 147488000<br/>\n }<br/>\n },<br/>\n ...<br/>\n ]</p>\n\t\t\t\t\n\t\t\t\t\t<p>Note that all this contact information relates to the entity concerned. Subordinate entities will have their own contact information if relevant.</p>\n\t\t\t</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tsortasvia</td>\n\t\t\t<td>\n\t\t\t\twhen result matched via an AKA field (see below) or from a role, the index of the info element which it matched against</td>\n\t\t\t<td>\n\t\t\t\tinteger</td>\n\t\t\t<td>\n\t\t\t<td></td>\n\t\t</tr>\n</table>\n\n===virtualsite===\n\n'virtualsite' entities are '''''only''''' returned as part of [[The Database API reference discovery]] process in response to a search with 'ref=*' or 'ref=''SITE''/*'. These are just like sites and subsites except that they have no location information associated with them. They exist only so that the complete set of prefix letters (including those for buildings not on any real site) is available as a starting point for reference discovery (see the documentation for details). Looking up their ref verbatim will yield no result.\n \n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n <tr>\n <td>type</td>\n <td><strong>virtualsite</strong></td>\n <td></td>\n <td></td>\n </tr>\n\n <tr>\n <td>ref</td>\n <td>the reference of the entity</td>\n <td>string</td>\n <td>e.g. \"K\", \"EXT/BEAUFORT\"<br />\n See [[The Database API reference discovery]] for a discussion of reference formats</td>\n </tr>\n\n <tr>\n <td>name</td>\n <td>the name of the entity (assuming it has one)</td>\n <td>string</td>\n <td>\"north city\"</td>\n </tr>\n <tr>\n <td>nonuniversity</td>\n <td>key only present if the virtual site is not part of the university estate but where we want to refer to it in the map</td>\n <td>boolean</td>\n <td>always '''true''' if present. Currently the only virtual non-university site has reference 'EXT', along with some virtual sub-sites of 'EXT'</td>\n </tr>\n</table>\n\n===Fields common to all geographical objects===\n\nThe remainder are all geographical objects and share the following common fields:\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tref</td>\n\t\t\t<td>\n\t\t\t\tthe reference of the entity</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\te.g. "H/FORVIE"<br />\nSee [[The Database API reference discovery]] for a discussion of reference formats,\n</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tname</td>\n\t\t\t<td>\n\t\t\t\tthe name of the entity (assuming it has one)</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\te.g. "Forvie Site", "Austin Building"</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tlat</td>\n\t\t\t<td>\n\t\t\t\tthe latitude of a representative position of the entity</td>\n\t\t\t<td>\n\t\t\t\tfloat</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tlon</td>\n\t\t\t<td>\n\t\t\t\tthe longitude of a representative position of the entity</td>\n\t\t\t<td>\n\t\t\t\tfloat</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tprimitive</td>\n\t\t\t<td>\n\t\t\t\twhether the building was derived from an OSM way ("w") or node ("n")</td>\n\t\t\t<td>\n\t\t\t\tstring (either "w" or "n")</td>\n\t\t\t<td>\n\t\t\t\tprimitive and id can be used together to form a link to the OSM browser, as in http://osm.org/browse/way/1234567</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tid</td>\n\t\t\t<td>\n\t\t\t\tthe OSM id of the node or way from which the entity was derived</td>\n\t\t\t<td>\n\t\t\t\tint</td>\n\t\t\t<td>\n\t\t\t\tsites, colleges and buildings are usually areas (ways) in OSM, though there are a few \"buildings\" which represent an office in larger, possibly non-university premises, represented just as a node. Complex buildings, e.g. one containing 'holes', are represented as OSM 'multipologon relations'. In these cases the referenced way will be the one corresponding to the outside of the building - the holes can be accessed via the relation containing this way and OSM tags relating to the building will be associated with the outer way or the relation (but not both).<br/> </td>\n\t\t</tr>\n</table>\n\n===site===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<strong>site</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tnonuniversity</td>\n\t\t\t<td>\n\t\t\t\t<strong>true</strong></td>\n\t\t\t<td>\n\t\t\t\tboolean</td>\n\t\t\t<td>\n\t\t\t\tpresent to distinguish non-university sites from university sites (currently the only non-virtual, non-university site is 'H', the Cambridge Biomedical Campus)</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tparent*</td>\n\t\t\t<td>\n\t\t\t\twhen the site is a sub-site, this is the main site</td>\n\t\t\t<td>\n\t\t\t\tsite object</td>\n\t\t\t<td>\n\t\t\t\tfor example object for "Cambridge Biomedical Campus" when name is "Forvie Site"</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tentrances*</td>\n\t\t\t<td>\n\t\t\t\tto the site</td>\n\t\t\t<td>\n\t\t\t\tarray of entrance objects</td>\n\t\t\t<td>\n\t\t\t\tsee below</td>\n\t\t</tr>\n</table>\n\n===college===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<strong>college</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\tThis is the geographical entity for a college site or sub-site, not the institutional information which is an inst. This is very similar to <strong>site</strong>.</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tparent*</td>\n\t\t\t<td>\n\t\t\t\twhen the college item is a subsidiary site, the main site</td>\n\t\t\t<td>\n\t\t\t\tcollege object</td>\n\t\t\t<td>\n\t\t\t\te.g. object for "Magdalene College" when site is ref MAGD/CRIPPS</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tentrances*</td>\n\t\t\t<td>\n\t\t\t\tas for site</td>\n\t\t\t<td>\n\t\t\t\tarray of entrance objects</td>\n\t\t\t<td>\n\t\t\t\tsee below</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tinstitution*</td>\n\t\t\t<td>\n\t\t\t\tthe institution information associated with this college area</td>\n\t\t\t<td>\n\t\t\t\tinstitution object</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n</table>\n\n===building===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<strong>building</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tparent*</td>\n\t\t\t<td>\n\t\t\t\tsite/college in which the building is situated</td>\n\t\t\t<td>\n\t\t\t\tsite/college object</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tentrances*</td>\n\t\t\t<td>\n\t\t\t\tentrances of the building</td>\n\t\t\t<td>\n\t\t\t\tarray of entrance objects</td>\n\t\t\t<td>\n\t\t\t\tsee below</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\toccupants*</td>\n\t\t\t<td>\n\t\t\t\toccupants of the building</td>\n\t\t\t<td>\n\t\t\t\tarray of institution objects</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n</table>\n\n===entrance===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<strong>entrance</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\tentrances apply to sites and colleges as well as buildings. Note, entrances are always derived from OSM node entities.</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tparents*</td>\n\t\t\t<td>\n\t\t\t\tbuildings and/or sites/colleges to which this entrance gives access</td>\n\t\t\t<td>\n\t\t\t\tarray of building/site/college objects</td>\n\t\t\t<td>\n\t\t\t\tnote that a few entrances give access to university properties on either side; also occasionally an entrance to a building isn't actually part of the building footprint.</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\toccupants*</td>\n\t\t\t<td>\n\t\t\t\t the institutions that gain access by this entrance</td>\n\t\t\t<td>\n\t\t\t\tarray of institution objects</td>\n\t\t\t<td>\n\t\t\t\tOK, you don't exactly "occupy" an entrance, but consistent with buildings</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tdirection</td>\n\t\t\t<td>\n\t\t\t\tthe direction of a normal to the parent building/site/college at an entrance, in degrees between -180 and 180 measured anticlockwise from the east (positive x axis) pointing away from the building</td>\n\t\t\t<td>\n\t\t\t\tfloat</td>\n\t\t\t<td>\n\t\t\t\tthe direction can be used to orient an overlaid arrow pointing to the entrance.</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tuser</td>\n\t\t\t<td>\n\t\t\t\tsome or all of the letters "fbvg"</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tstanding for "foot", "bicycle", "vehicle" and "goods" respectively, indicating the class or classes of users which can use the entrance.</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tdoor</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\tboolean</td>\n\t\t\t<td>\n\t\t\t\twhether this entrance is the door to a building (true) or a gate to a site (false)</td>\n\t\t</tr>\n</table>\n\n===nonuniversity===\n\nNon-university objects are only provided no reference is available. Where they have a University reference they are included in the general scheme of sites and buildings, with the '''nonuniversity''' element set to '''true'''.\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<b>nonuniversity</b></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\trole</td>\n\t\t\t<td>\n\t\t\t\twhat kind of thing this is</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\te.g. "hotel"</td>\n\t\t</tr>\n</table>\n\n===street===\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\t<strong>notes</strong></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\t<b>street</b></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t\t<td>\n\t\t\t\tno additional fields other than the common ones</td>\n\t\t</tr>\n</table>\n\n==Contact information==\n\nContact information for institutions and colleges is grouped into an array of items each of which may be repeated and qualified as necessary. For example, multiple phone numbers with descriptions of what each is for. Note that these all relate to the entity concerned. Subordinate entities will have their own contact information if relevant, so addresses, phone numbers etc. for child institutions should not be given as alternate addresses within the same info array.\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tperson</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tprimary contact named individual, for example "Prof. John Doe".</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tdescription</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tA brief description of the function of the institution</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttitle</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tprimary contact title, for example "The Bursar", where useful for more personal addressing.</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\taddress</td>\n\t\t\t<td>\n\t\t\t\tarray of objects (see below)</td>\n\t\t\t<td>\n\t\t\t\t<p>\n\t\t\t\t\tpostal address (assumed to be the primary address if not described otherwise by the role attribute - see below).</p>\n\t\t\t</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tphone</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tin the international form +44 1223 33nnnn</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tfax</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tditto</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\temail</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\turl</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tcomplete, including the http://</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tfounded</td>\n\t\t\t<td>\n\t\t\t\tint</td>\n\t\t\t<td>\n\t\t\t\t(colleges only) year of foundation</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tlogo</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\turl of image which is used to brand the institution</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttwitter</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\ttwitter handle including the @, e.g. @camgeog</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tfacebook</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tAKA</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tanother name or search term by which the institution is known. Unlike other info fields, the value of this info item is (usually) added to the search index.\n\n\t\t\t\t<p>This may be used in different ways according to the accompanying options. An \"xm\" option excludes the entry from the paper map (this might be a very old name, for example, which you want search results to hit, but not include in an up-to-date static map). \"xw\" excludes it from the web site searches and presentation, but includes it in the paper map and other alphabetic listings. \"xd\" excludes it from presentation (the user doesn't see it), but includes it in the index.</p>\n\n\t\t\t\t<p>Additionally when a ?q returns a result via a match on an AKA, the top level structure contains 'viaaka', the index of the info element which it matched against. This is so that you can tell the user if you want to why their search matched when it doesn't appear to match the main entry name.</p></td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tsubsection</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tindicates that all the entries that follow up to a subsection-end entry or another subsection entry or the end of the info array are grouped together. This would typically be used where an institution lists contact details for a well-defined part or function of the institution - for example, the phone, fax and email for the Box Office part of the ADC Theatre. A consumer would typically render the subsection string as a subheading of some kind and possibly indent its contents or separate them out in some suitable way. (note: this supersedes the version 5 method of grouping, where repeated roles indicated subsections, which was rather clumsy and prevented the individual elements having their own roles).</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tsubsection-end</td>\n\t\t\t<td>\n\t\t\t\tstring (unused)</td>\n\t\t\t<td>\n\t\t\t\texplicitly terminates a group of subsection elements.</td>\n\t\t</tr>\n</table>\n\n===Contact information qualifiers===\n\n\tEach of these objects contains a type to identify the key, and may also contain other qualifying information, as follows:\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\ttype</td>\n\t\t\t<td>\n\t\t\t\tone of the keys listed in the previous table</td>\n\t\t\t<td>\n\t\t\t\t</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\trole</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tdescription of what the contact information will be used for. If omitted, assumed to be the primary contact information of this type. For URLs this would typically be used for the link text rather than displaying the URL itself. For others it would serve as a caption. </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\toptions</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tarbitrary space separated string of options (meanings client dependent)</td>\n\t\t</tr>\n</table>\n\n===Addresses===\n\nAddresses are further subdivided so that they can be presented linearly, in "label" form or as a VCARD etc, by combining the elements with suitable punctuation and markup, and also cross-linked where appropriate - for example the <strong>street</strong> element could be linked with the URL <strong><nowiki>http://www.cam.ac.uk/</nowiki><em>streetname</em></strong> to jump to the map for the street name. These should be used in order when presenting an address.\n\nAddresses may also be associated with geographical locations (sites, colleges and buildings) and their entrances. This supersedes the amorphous list of locations and entrances provided in version 5. An address may be\n<ul>\n<li>just a postal address for correspondence, in which no location or entrances will be included in the address data</li>\n<li>a postal address with a corresponding location on the ground (possibly with entrances)</li>\n<li>just a location (and possibly its entrances), where the intention is to show the location on a map, but to direct post to a central address in a second address element, or occasionally that a postal address is not available for the location.</li>\n</ul>\n\nEach element contains a <strong>type</strong> field whose value is one of the keys in the following table, and then a key/value pair according to the type, as follows:\n\n<table class=\"wikitable\">\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\t<strong>key</strong></td>\n\t\t\t<td>\n\t\t\t\t<strong>value</strong></td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tmaildrop</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tfor parts of an address such as a room number or a PO Box number</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tbuilding</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tname of building</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tnumber</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tlocation on a street, e.g. "42a"</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tsite</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\te.g. "Lords Bridge", "New Museums Site"</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tstreet</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\te.g. "Downing Place"</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tstreet2</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\toccasionally a second street is part of the address</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tsmallplace</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\twhere place is a local village</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tplace</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\tusually "Cambridge"</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tcounty</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\trarely needed</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tpostcode</td>\n\t\t\t<td>\n\t\t\t\tstring</td>\n\t\t\t<td>\n\t\t\t\t </td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tlocation</td>\n\t\t\t<td>\n\t\t\t\tlocation object</td>\n\t\t\t<td>\n\t\t\t\tsee [[#Fields_common_to_all_geographical_objects|above]]. This is an excerpted geographical location object. There will only be at most one location object per address.</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>\n\t\t\t\tentrance</td>\n\t\t\t<td>\n\t\t\t\tentrance object</td>\n\t\t\t<td>\n\t\t\t\tsee [[#entrance|above]]. This is an excerpted geographical entrance object. There may be multiple entrance elements per address, but there will never be an entrance object in an address if there is no location object preceding it for the same address. Conversely, location elements do not have any entrance elements preceding them.</td>\n\t\t</tr>\n</table>\n\n\tSome examples:\n<ul>\n\t<li>\n\t\tHamilton Kerr Institute:<br />\n\t\t[ {"type": "street", "street": "Mill Lane"},<br/> {"type": "smallplace", "smallplace": "Whittlesford"},<br/> {"type": "place", "place": "Cambridge"},<br/> {"type": "postcode", "postcode": "CB22 4NE"} ]</li>\n\t<li>\n\t\tDivision of Anaesthesia<br />\n[<br/>\n { \"type\": \"maildrop\", \"maildrop\": \"Box 93\" },<br/>\n { \"type\": \"maildrop\", \"maildrop\": \"Level 4\" },<br/>\n { \"type\": \"site\", \"site\": \"Addenbrooke's Hospital\" },<br/>\n { \"type\": \"street\", \"street\": \"Hills Road\" },<br/>\n { \"type\": \"place\", \"place\": \"Cambridge\" },<br/>\n { \"type\": \"postcode\", \"postcode\": \"CB2 2QQ\" },<br/>\n { \"type\": \"location\", \"location\": {<br/>\n \"type\": \"building\", \"ref\": \"H132\",<br/>\n \"lat\": 52.17525, \"lon\": 0.141464, \"id\": 1643255315 }<br/>\n },<br/>\n { \"type\": \"entrance\", \"entrance\": {<br/>\n \"type\": \"entrance\", \"ref\": \"H131-A\",<br/>\n \"name\": \"Addenbrooke's Hospital Main Entrance\",<br/>\n \"lat\": 52.175206, \"lon\": 0.140538,<br/>\n \"direction\": 104, \"user\": \"f\", \"primitive\": \"n\", \"id\": 1643254795, <br/>\n\t \"entrance\": \"main\", \"door\": true }<br/>\n },<br/>\n {<br/>\n \"type\": \"entrance\", \"entrance\": {<br/>\n \"type\": \"entrance\",\"ref\": \"H-A\",<br/>\n \"lat\": 52.176241, \"lon\": 0.144354,<br/>\n \"direction\": 15, \"user\": \"fbv\", \"primitive\": \"n\", \"id\": 664530277,<br/>\n\t \"entrance\": \"main\", \"door\": false<br/>\n }<br/>\n },<br/>\n\t ...<br/>\n]</li>\n</ul>\n\nHere is a complete example record (for the Department of Anglo-Saxon, Norse and Celtic). Remember that all result records will be presented in an array, even if there is only one of them.\n\n {<br/>\n \"type\": \"institution\",<br/>\n \"inst\": \"asnc\",<br/>\n \"prefix\": \"Department of\",<br/>\n \"name\": \"Anglo-Saxon, Norse and Celtic\",<br/>\n \"sd\": \"asnc\",<br/>\n \"role\": \"academic\",<br/>\n \"info\": [<br/>\n { \"type\": \"address\",<br/>\n \"address\": [<br/>\n { \"type\": \"number\", \"number\": \"9\" },<br/>\n { \"type\": \"street\", \"street\": \"West Road\" },<br/>\n { \"type\": \"place\", \"place\": \"Cambridge\" },<br/>\n { \"type\": \"postcode\", \"postcode\": \"CB3 9DP\" },<br/>\n { \"type\": \"location\", \"location\": {<br/>\n \"type\": \"building\", \"ref\": \"S040\",<br/>\n \"name\": \"Faculty of English\",<br/>\n \"lat\": 52.20246, \"lon\": 0.108541, \"id\": 26378099 }<br/>\n },<br/>\n { \"type\": \"entrance\", \"entrance\": {<br/>\n \"type\": \"entrance\", \"ref\": \"S040-A\",<br/>\n \"lat\": 52.202422, \"lon\": 0.108616, \"direction\": -169,<br/>\n \"user\": \"f\", \"primitive\": \"n\", \"id\": 1487638771,<br/>\n \"entrance\": \"main\", \"door\": true }<br/>\n },<br/>\n { \"type\": \"entrance\", \"entrance\": {<br/>\n \"type\": \"entrance\", \"ref\": \"S-C\",<br/>\n \"lat\": 52.202752, \"lon\": 0.108839, \"direction\": 94,<br/>\n \"user\": \"fb\", \"primitive\": \"n\", \"id\": 961417125,<br/>\n \"entrance\": \"main\", \"door\": false<br/>\n }<br/>\n },<br/>\n { \"type\": \"entrance\", \"entrance\": {<br/>\n \"type\": \"entrance\", \"ref\": \"S-E\",<br/>\n \"lat\": 52.202702, \"lon\": 0.108056, \"direction\": 94,<br/>\n \"user\": \"fbv\", \"primitive\": \"n\", \"id\": 961417126,<br/>\n \"entrance\": \"main\", \"door\": false }<br/>\n }<br/>\n ]<br/>\n },<br/>\n { \"type\": \"phone\", \"phone\": \"+44 1223 335079\" },<br/>\n { \"type\": \"fax\", \"fax\": \"+44 1223 335092\" },<br/>\n { \"type\": \"email\", \"email\": \"asnc@hermes.cam.ac.uk\" },<br/>\n { \"type\": \"url\", \"url\": \"http:\\/\\/www.asnc.cam.ac.uk\\/\" },<br/>\n { \"type\": \"url\", \"url\": \"http:\\/\\/www.asnc.cam.ac.uk\\/people\\/index.htm\", \"role\": \"Contacts\" }<br/>\n ]<br/>\n }<br/>\n\n==Coordinates==\n\nThere are very few real-world coordinates in the database (it doesn't, for example, include building outlines). But this information is available from the [http://wiki.openstreetmap.org/wiki/API OSM API] by reference to the OSM id in the 'id' field of all geographic entities.\n\nFor building outlines, the OSM API supports:\n\n <nowiki>http://osm.org/api/0.6/way/<ID></nowiki>\n <nowiki>http://osm.org/api/0.6/way/<ID>/full</nowiki>\n <nowiki>http://osm.org/api/0.6/way/<ID>/relations</nowiki>\n\nNote however that a building doesn't have to be just a single closed way, since it can have have holes in the area. These are handled as OSM \"[http://wiki.openstreetmap.org/wiki/Relation:multipolygon multipolygons]\". In essence, there is an outer way plus a number of inner ways \n\nFor example, Churchill West Court (ref CHU016, https://map.cam.ac.uk/v6.json?ref=CHU016&debug=1). The Map API tells you it is a way with id 148247888 and you can plug it into the OSM API thus\n\n http://www.openstreetmap.org/api/0.6/way/148247888/full\n\nreturning\n\n<pre><nowiki>\n<osm version=\"0.6\" generator=\"OpenStreetMap server\">\n<node id=\"1613469175\" lat=\"52.2128314\" lon=\"0.1013427\" version=\"1\" changeset=\"10553242\" user=\"davidearl\" uid=\"3582\" visible=\"true\" timestamp=\"2012-01-31T20:37:02Z\"/>\n<node id=\"1613469065\" lat=\"52.2127198\" lon=\"0.101803\" version=\"1\" changeset=\"10553242\" user=\"davidearl\" uid=\"3582\" visible=\"true\" timestamp=\"2012-01-31T20:36:58Z\"/>\n...\n<nd ref=\"1613469175\"/>\n<nd ref=\"1613469065\"/>\n...\n<tag k=\"amenity\" v=\"university\"/>\n<tag k=\"building\" v=\"yes\"/>\n<tag k=\"name\" v=\"West Court\"/>\n<tag k=\"operator\" v=\"Churchill College (University of Cambridge)\"/>\n<tag k=\"ref\" v=\"CHU016\"/>\n</way>\n</osm>\n</nowiki></pre>\n\nand http://www.openstreetmap.org/api/0.6/way/148247888/relations gets\n\n<pre><nowiki>\n<osm version=\"0.6\" generator=\"OpenStreetMap server\">\n<relation id=\"1999559\" visible=\"true\" timestamp=\"2012-01-31T20:40:32Z\" version=\"1\" changeset=\"10553242\" user=\"davidearl\" uid=\"3582\">\n<member type=\"way\" ref=\"148247888\" role=\"outer\"/>\n<member type=\"way\" ref=\"148248147\" role=\"inner\"/>\n<tag k=\"type\" v=\"multipolygon\"/>\n</relation>\n</osm>\n</nowiki></pre>\n\ntelling you it is a multipolygon outer, and giving the info to traverse to the inner as above."
}
]
}
}
}
}