ZoneTag Location Services : Cell Location

Welcome, guest Sign In

My Projects
APIs & Web Services
- Address Book
- APT
- BBAuth
- BOSS
- delicious
- Fire Eagle™
- Flickr
- Hadoop
- GeoPlanet™
- HotJobs
- Mail
- Maps
- Music
- MyBlogLog
- OAuth
- OpenID
- Pipes
- Search
- Search Marketing
- SearchMonkey
- Social
- Shopping
- YAP
- YQL
- Finance
- Traffic
- Weather
- More RSS Feeds
- Search
- Mobile
- Konfabulator
- r3
- YUI Home
- Widgets
- Utilities
- CSS
Resources
- ASTRA Library
- Design Pattern Library
- YUI Library
- Exceptional Performance
- Security Best Practices
Community
- Flickr Support Group
- Maps Developer Community
- YUI Discussion Group
- More…
- Browse Gallery
- List Your App
- Become a Partner
Support
- FAQs
- Contact Us
- Groups & Forums
- YDN Blog
- YDN Theater

YDN Yahoo! ZoneTag

ZoneTag Location Services: Cell Location

The cell location web service allows you to access the ZoneTag Location Services and get the best known location for a given GSM cell tower ID.

Request URL

http://zonetag.research.yahooapis.com/services/rest/V1/cellLookup.php

Request parameters

See information on constructing REST queries

Parameter	Value	Description
apptoken	string (required)	The application token. You can get your app token here.
cellid	Integer - up to 7 digits (required)	The cellid of the cellular tower
lac	Integer - up to 7 digits (required)	The Location Area Code (LAC) of the cellular tower
mnc	Integer - up to 3 digits (required)	The Mobile Network Code (MNC) of the cellular tower
mcc	Integer - up to 3 digits (required)	The Mobile Country Code (MCC) of the cellular tower
results	integer: default 3, max 10	The number of results to return.
compressed	0 (default) or 1	Setting to 1 will result in a compressed XML version with no redundant location tags.
cellhistory	mnc:lac:cellid@timeoffset	Collection of individual cell ids that gives the users location history.
timeoffset	Integer	Time offset in seconds from the moment the last reading was recorded (only used as part of the cellhistory parameter
latitude	float: -90 to 90	The latitude of the starting location.
longitude	float: -180 to 180	The longitude of the starting location. If both latitude and longitude are specified, they will take priority over all other location data. If only one of latitude or longitude is specified, both will be ignored.

Sample Request URL

http://zonetag.research.yahooapis.com/services/rest/V1/cellLookup.php?apptoken=ZoneTagDemoToken&cellid=48627380&lac=201&mnc=15&mcc=234

Response fields

Field	Description
Location	Contains each location response
Country	Country of the celltower. May contain the following attributes : source: Source of the given information. cell: Cell from which the location information was derived. Possible values are current, nearby and history.
State	State of the celltower (not available for all locations). May contain the following attributes : source: Source of the given information. cell: Cell from which the location information was derived. Possible values are current, nearby and history.
City	City of the celltower. May contain the following attributes : source: Source of the given information. cell: Cell from which the location information was derived. Possible values are current, nearby and history.
Zipcode	Postal code of the cell tower. May contain the following attributes : source: Source of the given information. cell: Cell from which the location information was derived. Possible values are current, adjacent and history.
Name	Name of the parent element. this is only used in compressed format results.

Sample response

The following is a sample response for the query for the cellid 4995-6045-380-310:

<rsp stat="ok"> <Location> <Country cell="current" source="user">USA</Country> </Location> <Location> <Country cell="current" source="contacts">USA</Country> <State cell="current" source="contacts">California</State> <City cell="current" source="contacts">Berkeley</City> <Zipcode cell="current" source="contacts">94710</Zipcode> </Location> <Location> <Country cell="current" source="contacts">USA</Country> <State cell="current" source="contacts">California</State> <City cell="current" source="contacts">Berkeley</City> <Zipcode cell="current" source="contacts">94704</Zipcode> </Location> </rsp>

The following is the response in compressed format for the query for the cellid 4995-6045-380-310:

<?xml version="1.0" encoding="utf-8" ?> <rsp stat="ok"> <Location> <Country cell="current" source="user"> <Name>USA</Name> <State cell="nearby" source="contacts"> <Name>California</Name> <City cell="nearby" source="contacts"> <Name>Oakland</Name> <Zipcode cell="nearby" source="contacts"> <Name>94605</Name> </Zipcode> </City> </State> </Country> </Location> </rsp>

Errors

Error code	Description
1	Invalid apptoken.
2	Invalid usertoken.
3	Application rate-limit exceeded.
4	User rate-limit exceeded.
10	Invalid location values.
11	Invalid cellid.
12	Invalid lac.
13	Invalid mnc.
14	Invalid mcc.
15	Invalid latitude.
16	Invalid longitude.

Sample Error Message

The following is a sample error message:

<rsp stat="fail"> <err code="1" msg="Invalid apptoken"/> </rsp>

Rate Limits

We are only a prototype, small and tiny. So be nice and observe polite etiquette in your requests rates.

Terms of Use

ZoneTag web services are offered to you for non-commercial use, and are governed by the Yahoo! APIs Terms of Use and the ZoneTag web services Terms of Use.