The Space service is dedicated to handle location related queries or calculations. Currently the following features are supported:

• calculate distance between two locations;
• tell whether one location contains or is within another;
• list all sub/super space of a particular space;
• pinpoint a position in a big coordinate system to a particular room;
• retrieve all spaces within a range to a particular position;
• select a particular type of rooms within a range like "Conference", "Office", "Lounge" etc.

1. distance
   ali1, ali2, distance
   
2. contain
   ali1,ali2,contain
   
3. subspace
   super, sub
   
4. pinpoint
   ali, space
   
5. range
   ali,range,space
6. room
   name,ali,type

• Calculate distance between two locations:
  select distance from distance where ali1="ali://cmu/wean-hall/floor3/3700-corridor/3709" AND ali2="ali://cmu/wean-hall/floor3/3700-corridor/3718"
• Tell whether one location contains another:
  select contain from contain where ali1="ali://cmu/wean-hall/floor3" AND ali2="ali://cmu/wean-hall/floor3/3700-corridor/3718"
• List all sub spaces of a particular space:
  select sub from subspace where super="ali://cmu/wean-hall/floor3"
• List all super spaces of a particular space:
  select super from subspace where sub="ali://cmu/wean-hall/floor3"
• Pinpoint a coordinate position to a particular room:
  select space from pinpoint where ali="ali://cmu/wean-hall/floor3#(80,65,1)"
  select space from pinpoint where ali="ali://cmu/wean-hall/#(75,75,20)"
• Retrieve all spaces within range of a particular position:
  select space from range where ali="ali://cmu/wean-hall/floor3#(69,69,1)" AND range=10
• Select a particular type of room in a range:
  select ali from room where type="Conference" AND ali within "ali://cmu/wean-hall/floor8"

• Find the location of an access point:
  select ali from aplocation where name="weh-4400.wp.net.cmu.edu"

1. mbpsTotal
   Total cell traffic in mbps.
2. mbpsIn
   Traffic incoming from wireless stations in mbps.
3. mbpsOut
   Traffic outgoing to wireless stations in mbps.

• General attribute retrieval
  Any combination of the above attributes may be retrieved for a single AP.
  Example: select * where name="weh-7500.wp.net.cmu.edu"

• Access point list
  Returns a list of access points tracked by this service.
  Example: select name

1. apName
   The name of the AP for a given cell.
2. deviceID
   The MAC of the device attached to the given AP.
3. deviceIP
   The IP of the device attached to the given AP (not always obtainable)
4. relation
   Provides meta-attributes on the relationship between devices and APs. The value of this attribute is always null.
   

• List AP devices
  Displays all devices in a given cell.
  Example: select * where apName="weh-7500.wp.net.cmu.edu"

• Locate device
  Finds the last known (not necessarily the current) location of a device. (Looking at the sample time of the relation attribute can tell you when this location was last updated.)
  Example: select * where deviceID="00:11:22:33:44:55"

• Actively check for current access point, device association
  Performs a live check to see if a given device is in a given cell. The query call will not return until the check has been performed
  Example: select * where apName="weh-7500.wp.net.cmu.edu" and deviceID="00:11:22:33:44:55"

1. location
   The location of mobile user, in ALI format.
2. user
   userid of the interested user, should be the same as that used in the client application of people location service, normally it is the same as andrew id

• Locate mobile user
  Example: select location where user="jiangch"

1. id
   Andrew id of the user to be located
2. location
   location of the user in location source-specific format
3. ali
   location of the user in ALI format
4. service
   name of the source generating the location information

• Locate user
  Example: select ali where id = "uh"

1. name
   name of the printer
2. location (Optional) (NOTE: this attribute appears in selected attributes)
   location of the printer
3. distance (Optional)
   distance from the printer to given user's location
4. location (note, this attributes appears in query condition)
   given user's location
5. radius (Optional)
   range of nearby printers to given user's location

• Locate printers in the same floor as the the user
  Example: select name where location="ali://cmu/wean-hall/floor3#(87,89,1)"
• Locate printers in the same floor and within a range of 15 meters to the user's location
  Example: select name where location="ali://cmu/wean-hall/floor3#(87,89,1)" AND radius = 15
  
• Locate printers along with their locations and distance to user's locations, given user's location and the range of printers.
  Example: select name,location,distance where location="ali://cmu/wean-hall/floor3#(87,89,1)" AND radius=15

find devices of particular type (and within a particular spaces )

1. name
   name of the devices
2. ali
   location of device, in the format of ALI
3. type
   type of device, currently support, "Projector", "Printer"

• Locate projectors:
  select name,ali where type="Projector" AND ali within "ali://cmu/wean-hall/floor4"

Working like lpq; given a printer's name it determines the queue size

1. name
   name of printer
2. queue
   total number of printer job (-1or null if unavailable)
3. bytes
   total bytes to print (-1or null if unavailable)

• get the number of print jobs of "opal" printer
  example:select queue where name="opal"

Given a user's location, determine the closest, fastest, public printer.

1. ali
   location of user
2. name
   name of printer
3. queue
   total number of printer jobs
4. bytes
   total bytes to printer (-1 or null if unavailable)
5. distance
   distance to printer

• get the nearby printers' name, number of printer jobs and distance to user's specified location
  example:select name,queue,distance where ali="ali://cmu/wean-hall/floor3#(87,89,1)"