This Web Service provides a list of FAST Geographic or Event Subject Headings that are near a given coordinate, ranked by distance from the requested point.
Try the Google Map Mashup MapFAST that uses this service.
The APIs expect all requests to be UTF-8 encoded. Responses are also UTF-8 encoded.
REST is the simplest format to use and the only request format currently supported. REST requests consist of URLs that can be invoked either via HTTP POST or GET methods, either programatically or via a WEB browser. For example:
This location is Sydney, Australia, and the three closest headings are returned in this example. From a Web browser, a text file with JSON output is returned.
geo=latitude,longitude; latitude -90 to +90, longitude -180 to +180; decimal format.
radius=nnnn; meters- search radius, allowed between 1000 and 200000m
crs=wgs84; specifies the coordinate reference system is the World Geodetic System 84 Standard - currently only system implemented
sortby=distance; specifies the coordinate reference system is the World Geodetic System 84 Standard - only system implemented
max-results=nn; specifies the coordinate reference system is the World Geodetic System 84 Standard - only system implemented
mq=feature; specifies the coordinate reference system is the World Geodetic System 84 Standard - only system implemented
box=swlatitude,swlongitude,nelatitude,nelongitude,; alternate to geo & radius, constructs a latitude logitude box. Same format as geo=. The size is adjusted at search time to approximate the limits shown in radius.
REST/JSON is the only response format currently supported. Since no results are possible from many searches, no failure is indicated in the return.
The JSON content follows the KML standard for geographic data.
The JSON response is in a series of name/value pairs
name = FAST Authority Records
Status = ( code= 200 ; request = geocode )
Placemark = [Array of placement results]
The placemark contents are:
id = FAST Record Number
name = FAST Heading
point = ( coordinates = longitude:latitude )
ExtendedData = array of additional information in name/value pairs, including
name = NormalizedName; value = normalized FAST Authority heading suitable for adding to an Open WorldCat query
name = feature; value = a code indication the type of place represented by the heading, such as populated place (abbreviated as ppl), mountain, or event (Note 1)
name = FCode; value = single letter collecting feature types.(Note 2)
Note 1: The feature codes are are a subset of the Geonames Geographic Feature Codes, which are used in LCSH to indicate the type of geographic location. Event has been added here.
Note 2: These single letter codes collapse the feature codes into common types. These are:
The OCLC Developer Network supports the use of OCLC Web Services—a set of tools and APIs that expose data and services for WorldCat and our member libraries and partner institutions or companies. learn more »
© 2010 OCLC Domestic and international trademarks and/or service marks of OCLC Online Computer Library Center, Inc. and its affiliates