ZoneTag Location Services : Submit 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: Submit Cell Location

The submit cell location web service allows you to submit a GSM celltower and its location to ZoneTag. This will allow us to give better, more accurate and personalised location results to the users of the ZoneTag Cell Location service.

Request URL

http://zonetag.research.yahooapis.com/services/rest/V1/cellsubmit.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
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.
street	string	Street address of the reading.
city	string	City of the reading.
state	string	Full name of the state of the reading (In the case of US states standard 2 letter abbreviations are allowed)
country	string	Country of the reading.
zipcode	string or integer	Postal code of the location reading. The postal code must match the location format of the country specified.

Sample Submission URL

http://zonetag.research.yahooapis.com/services/rest/V1/cellsubmit.php?apptoken=ZoneTagDemoToken&cellid=37529&lac=6037&mnc=380&mcc=310&city=sunnyvale&state=ca&zipcode=94089&country=usa

Important: Do NOT use the sample apptoken supplied here for your application. All cell IDs submitted using the sample apptoken will be ignored. Please register for your own app key.

Sample response

The following is a sample response for a cellid submission:

<?xml version="1.0" encoding="utf-8" ?> <rsp stat="ok"> <location> <city>Sunnyvale</city> <state>California</state> <country>USA</country> </location> </rsp>

Errors

The error codes returned by the cell submit service are:

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:

<?xml version="1.0" encoding="utf-8" ?> <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.