Baeeo APIs

by Costa Apostolakis
 Dec 21, 2008
The Baeeo API's provide the ability for developers to create there own applications utilizing Baeeo's cell tower database and/or Baeeo web applications.  To get started, first select the API that's right for you. Pick from the following options, as the offer different functionality and ease of use.

Mapping API
 The Baeeo Map API provides the ability to place a Google Map which includes your current location in your own web page.
 


The users phone id (u) can be found by selecting the edit link of the phone in the my account section.
Example HTTP query:
http://baeeo.com/mymap?u=7374
 
Parameter Value Description
u string (required) Users Phone ID.
h string (optional) Map Height.
w string (optional) Map Width.

Example HTTP query with map sizing
http://baeeo.com/mymap?u=7374&h=300&w=400

* This API requires that the checkbox must be selected "Allow others to see my location" under the my account section.

 

My Location API
The My Location API provides specific details on the last location of a phone or PDA.  The user ID and password is required when submitting a query, response is in XML format.

Example HTTP Query:


http://baeeo.com/API/mylocation?u=7374&p=123456a
 

Example XML response:


 
<?xml version="1.0" ?>
- <ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:baeeo:myloc" xsi:schemaLocation="urn:baeeo:myloc http://baeeo.com/API/mylocation.xsd">
- <Result status="confirmed">
  <UserID>7374</UserID>
  <Latitude>38.321117</Latitude>
  <Longitude>-77.774343</Longitude>
  <Datetime>12/20/2008 7:19:27 AM MST</Datetime>
  <City>Locust Grove</City>
  <State>VA</State>
  <Zip>22508</Zip>
  <County>Orange</County>
  <Country>US</Country>
  <CellID>1921</CellID>
  <Mnc>410</Mnc>
  <Mcc>310</Mcc>
  <Lac>10010</Lac>
  </Result>
  </ResultSet>
<!-- baeeo.com :: 12/20/2008 4:36:15 PM MST UTC/GMT -7 hours  -->

 

All queries begin with: http://baeeo.com/API/mylocation?

Followed by the 2 fields: u=XXXXXX&p=XXXXXX

Request Parameters:

Parameter Value Description
u string (required) Users ID.
p string (required) Users password.
output string: xml The format for the output.


Response Fields:

Field Description
Result status Contains the general response.
  • confirm: the user account was identified and last location returned.
  • error: no data: the user account was identified but no location data was found.
  • error: account: the user id and or password is not valid.
UserID Users phone ID (u).
Latitude The latitude of the last cell tower.
Longitude The longitude of the last cell tower.
Datetime The date and time of the last location submitted
City The city of the last location submitted
State The state of the last location submitted
Zip The zip code of the last location submitted
County The county of the last location submitted
Country The country of the last location submitted
CellID The last cellid submitted
Mnc The last mnc submitted
Mcc The last mcc submitted.
Lac The last lac submitted


Updating API
The Updating API was created to provide the ability for developers to send a simple query from a mobile phone or PDA that includes cell tower information (cellid, lac, mnc, mcc)  and the Baeeo user credentials to the Baeeo server where the cell tower information is geocoded and stored on the users account.

Example HTTP query:


http:///baeeo.com/log/?c=33553:310:410:10010&u=7374&p=123456a
 

Example XML response:


 
  <?xml version="1.0" ?>
- <ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:baeeo:log" xsi:schemaLocation="urn:baeeo:log http://baeeo.com/log/Response.xsd">
- <Result status="confirm">
  <UserID>7374</UserID>
  <Latitude>40.052649</Latitude>
  <Longitude>-74.170117</Longitude>
  <City>Lakewood</City>
  <State>NJ</State>
  <Zip>08701</Zip>
  <County>Ocean</County>
  <Country>US</Country>
  <CellID>38122</CellID>
  <Mnc>410</Mnc>
  <Mcc>310</Mcc>
  <Lac>3949</Lac>
  </Result>
  </ResultSet>
<!-- baeeo.com :1: 12/28/2008 7:36:28 PM MST UTC/GMT -7 hours  -->

 

All queries begin with: http://baeeo.com/log?

Followed by the 3 fields: c=XXXXXX:XXXXXX:XXXXXX:XXXXXX&u=XXXXXX&p=XXXXXX

Request Parameters:

Parameter Value Description
u string (required) Users ID.
p string (required) Users password.
c string (required) This field contains cell tower details including: cellid, mcc, mnc, lac and are required to be in the following order: cellid:mcc:mnc:lac
output string: xml The format for the output.


Response Fields:

Field Description
Result status Contains the general response.
  • confirm: the user account was successfully updated with tower data and latitude and longitude coordinates.
  • error: tower data  the tower data submitted incorrectly or is missing fields.
  • error: account the user id and or password is not valid.
  • error: tower unknown the tower was not found in the database.
  • error: same tower data  the cell tower data is the same data as the last record submitted
UserID Users phone ID (u).
Latitude The latitude of the cell tower.
Longitude The longitude of the cell tower.
City The city of the location submitted
State The state of the location submitted
Zip The zip code of the location submitted
County The county of the location submitted
Country The country of the location submitted
CellID The cellid submitted
Mnc The mnc submitted
Mcc The mcc submitted.
Lac The lac submitted