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.
If you're building something cool with the cell location web services, please let us know or just swing on by the mailing list and shoot the breeze with other developers/users. Do it all in the zonetag-dev discussion group.
http://zonetag.research.yahooapis.com/services/rest/V1/cellsubmit.php
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. |
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.
The following is a sample response for a cellid submission:
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. |
The following is a sample error message:
We are only a prototype, small and tiny. So be nice and observe polite etiquette in your requests rates.
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.
Copyright © 2008 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Copyright Policy - Job Openings