Safe2pee API - Gender neutral bathrooms, bathroom proximity search

safe2pee api (JSON output) v1.0 updated 6/13/09. All queries to retreive data do not require an api key, if you want to add listings you can email us for one and use it in your apps! info at safe2pee dot org USAGE TERMS: Not for profit, please credit safe2pee. If you will be querying at a super high volume let us know so we can figure something out! All data has been supplied by users, we cannot confirm the validity of supplied information.

citylist.php (e.g. city=lansing&state=mi)

returns listing of bathrooms by city/state, province

city - city name
state - two letter state or province code

sample output

{ "status":"success", "city":"kansas city", "state":"mo", "tally":"2", "bathrooms": [ { "bid":"MTQ4MyBTMlA=", "name": "Hall\'s", "lat":"39.041428", "long":"-94.589769", "street":"211 Nichols Rd.", "city":"Kansas City", "state":"MO", "postal":"64112-1524", "gendered":"1", "accessible":"0", "availability":"1", "directions":"Basement level.", "comment":"The most finely appointed department store toilets I have ever seen." }, { "bid":"MTQ2OCBTMlA=", "name": "Commerce Arcade", "lat":"39.102183", "long":"-94.582075", "street":"1000 Walnut", "city":"Kansas City", "state":"MO", "postal":"64106-2107", "gendered":"0", "accessible":"0", "availability":"1", "directions":"2nd floor to the left of the escalator.", "comment":"Open business hours." } ] }

proxlist.php (location=castro+at+market+san+francisco%2Cca&distance=2&access=1)

find bathrooms nearby

location - a cross street + city, lat,long --- anything it automatically parses and geocodes
distance (1-30) mile radius
access (1) show only accessible
gn (1) show only gender neutral
av (1) free, you don't have to buy something (some times unknown)

sample output

{ "status":"success", "location":"37.762640,-122.435159", "radius":"1", "tally":"45", "bathrooms": [ { "bid":"MTIgUzJQ", "name": "Mission Creek Cafe", "lat":"37.757358", "long":"-122.421330", "dist":"0.839", "street":"968 Valencia Street", "city":"San Francisco", "state":"CA", "postal":"94110-2322", "gendered":"0", "accessible":"0", "availability":"0", "directions":"Head straight back. behind a divider.", "comment":"no key" }, { "bid":"MTYgUzJQ", "name": "Coffee To The People", "lat":"37.770064", "long":"-122.445174", "dist":"0.75", "street":"1206 Masonic St", "city":"San Francisco", "state":"CA", "postal":"94117-2917", "gendered":"0", "accessible":"1", "availability":"0", "directions":"towards the rear of the coffee shop.", "comment":"usually clean" } ] }

commentlist.php (bid=ODI3IFMyUA==)

display comments of a particular listing

bid - bathroom id, found in output for previous commands

sample output

{ "status":"success", "bid":"ODI3IFMyUA==", "tally":"10", "comments":[ { "name": "JIFFI STOP", "date":"2007-04-23 00:00:00", "comment":"Michigan Dept of Transanitation JIFFI website: http://www.xanga.com/JIFFI_STOP" } , { "name": "anon", "date":"2007-04-27 00:00:00", "comment":"I don't buy it. I think this is a joke." } ] }

queries that require a key

addlisting.php (key=SAMPLE&name=YourPlace&street=24th+and+Valencia&city=San+Francisco&state=CA&lat=37.7521&long=-122.4208&access=1&type=0&avail=3&comment=good food&directions=in back )

add a listing (api key required). at the moment all values must be derived from the client app. in the future this function will be able to reverse geocode automatically.

key - what we have provided you
street - street address
city - city name
state - two letter abbreviation
lat - latitude
long - longitude
access - 1 = accessible / 0 not/unknown
type - 0=genderfree, 1=gendered,singlestall or safe
avail - how easily available
- 0 Not set, applicable or unsure
  1 you can stroll right in
  2 pretend to know what you're doing/shopping
  3 sneak in if it's busy, otherwise buy something
  4 free access if the right person is working
  5 free access if you flirt with employees
  6 you should probably/must buy something
  7 $$$ Pay toilet $$$ (i.e. street toilets in many places)
  8 RESTRICTED ID required (student, government,etc)
  9 free, but building charges for entry
comment = comment about place (pass as blank if nothing)
directions = directions to bathroom (pass as blank if nothing)

Sample output

{ "status":"success","message":"added!" } { "status":"failed", "message":"invalid key" }

addcomment.php (key=SAMPLE&bid=ODI3IFMyUA==&comment=hi there&name=me)

bid - bathroom id
comment - your comment
name (optional) - your name

{ "status":"success","message":"added!" } { "status":"failed", "message":"invalid key" } { "status":"failed", "message":"database issue" }

--------

state/province code array