mapFAST

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. 

URL and Supported Request

Operation Resource URL HTTP METHOD
Search http://experimental.worldcat.org/mapfast/services?geo={latitude},{longitude};crs=wgs84&mq=&sortby=distance&max-results={maxResults} GET or POST

HTTP Accept Types

Parameters

Parameter Required Description Expected/Sample Value
geo Yes latitude -90 to +90, longitude -180 to +180; decimal format. {latitude},{logitude}
radius Yes meters- search radius, allowed between 1000 and 200000m {integer}
crs Yes specifies the coordinate reference system is the World Geodetic System 84 Standard - currently only system implemented wgs84
sortby Yes specifies the coordinate reference system is the World Geodetic System 84 Standard - only system implemented distance
max-results Yes specifies the coordinate reference system is the World Geodetic System 84 Standard - only system implemented

{integer}
mq Yes specifies the coordinate reference system is the World Geodetic System 84 Standard - only system implemented feature
box No 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. {swlatitude},{swlongitude},{nelatitude},{nelongitude}
callback No This makes the request JSONP, where a javascript function call is returned around the JSON data. The ? is required, and an random function name myJavascriptCallbackFunction

Response Fields

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 and the response is in a series of name/value pairs.

Placemark Response Fields

Name Description
id FAST Record Number
name FAST heading
description A description of the Placemark (if available)
ExtendedData An array of key value pairs
point/coordinates Coordinate data for the heading
ExtendedData An array of additional information in name/value pairs for additional data about the FAST heading.

Extended Data

The extended data uses specific key/value pairings.

Key Value Fixed Values
NormalizedName Normalized FAST Authority heading suitable for adding to an Open WorldCat query NA
Feature A code indicating the type of place represented by the heading, such as populated place (abbreviated as ppl), mountain, or event. These are a subset of the Geonames Geographic Feature Codes, which are used in LCSH to indicate the type of geographic location NA
FCode Single letter collecting feature types

One of

  • P
  • A
  • H
  • E
  • T
  • U

Extended Data FCodes

Code Description
P Populated Place
A Regions or Governmental Districts
H Lakes, Rivers, Streams
E Event
T Other
U Undefined

Example URL

To return the three closest heading to Sydney, Australia:

GET http://experimental.worldcat.org/mapfast/services?geo=-33.863,151.208;crs=wgs84&mq=&sortby=distance&max-results=3

Notes

The API expects all requests to be UTF-8 encoded. More information about UTF-8

Try the Google Map Mashup MapFAST that uses this service.

A sample "how to "search and jQuery javascript processing code are provided for use with this API.