# TPS JSON API response

Source: [https://docs.qualcomm.com/doc/80-42204-1/topic/19_TPS_JSON_API_response.html](https://docs.qualcomm.com/doc/80-42204-1/topic/19_TPS_JSON_API_response.html)

The Terrestrial Positioning Service (TPS) JSON API response is the response to the [TPS JSON API request](https://docs.qualcomm.com/doc/80-42204-1/topic/4_TPS_JSON_API_request.html). The response
                includes latitude, longitude, and HPE (accuracy) determined from the request
                inputs.

Note: Qualcomm
                Technologies, Inc. (QTI) uses multiple methods and sources for positioning IPs.
                Hence, HPE (accuracy) may not be returned in all responses.

### Syntax

Requests that are successful return an HTTP 200 response status and a response body
                as follows:

    {
        "location": {
            "lat": 42.297002,
            "lng": -71.233323
        },
        "accuracy": 18,
        "nap": 0,
        "ncell": 0,
        "nlac": 0,
        "nsat": 9,
        "nble": 0,
        "source": "gnss",
        "streetAddress": {
            "streetNumber": 64,
            "addressLine": "Farnsworth St",
            "neighborhood": "Beantown",
            "city": "Boston",
            "metro1": "Boston",
            "metro2": "Boston County",
            "postalCode": "02210",
            "county": "Suffolk",
            "region": "North East",
            "stateCode": "MA",
            "stateName": "Massachusetts",
            "countryCode": "US",
            "countryName": "United States"
        }
    }
    Copy to clipboard

### Parameters

| Parameter | Parameter | Parameter | Description |
| --- | --- | --- | --- |
| `location` | `location` | `location` | The position of the device. |
| `accuracy` | `accuracy` | `accuracy` | Estimates HPE of the location, in meters, when<br>                                    `hpeConfidence` is set to 68% (default) or 95% in<br>                                the API request. <br>Note: The default 68%<br>                                    confidence is supported in TPS v2.28 and later.<br>                                    For 95% confidence, set `hpeConfidence` to 95 in<br>                                    the location request. |
| `nap` | `nap` | `nap` | Number of AP scans used to determine location. <br>A value is<br>                                    returned only if `includeBeaconCounts` is set to<br>                                        `true` in the API request. |
| `ncell` | `ncell` | `ncell` | Number of cell scans used to determine location. <br>A value is<br>                                    returned only if `includeBeaconCounts` is set to<br>                                        `true` in the API request. |
| `nlac` | `nlac` | `nlac` | Number of Location Area Codes (LACs) used to determine location.<br>                                    <br>A value is returned only if<br>                                        `includeBeaconCounts` is set to<br>                                        `true` in the API request. |
| `nsat` | `nsat` | `nsat` | Number of satellites in the GPS location used to determine<br>                                    location. In case of cell fallback, this value is greater than<br>                                    0.<br><br><br>                                <br>A value is returned only if `includeBeaconCounts`<br>                                    is set to `true` in the API request. |
| `nble` | `nble` | `nble` | Number of BLE scans used to determine location. <br>A value is<br>                                    returned only if `includeBeaconCounts` is set to<br>                                        `true` in the API request. |
| `source` | `source` | `source` | Beacon type used to determine to location. <br>A value is<br>                                    returned only if `includeLocationSource` is set<br>                                    to `true` in the API request. Values can be:<ul class="ul" id="TPS_JSON_API_response_19__ul_gdy_pr1_5yb"><br>                                        <li class="li"><code class="ph codeph">unknown</code></li><br><br>                                        <li class="li"><code class="ph codeph">cell</code></li><br><br>                                        <li class="li"><code class="ph codeph">wifi</code></li><br><br>                                        <li class="li"><code class="ph codeph">gnss</code></li><br><br>                                        <li class="li"><code class="ph codeph">ble</code></li><br><br>                                        <li class="li"><code class="ph codeph">rfpm</code></li><br><br>                                        <li class="li"><code class="ph codeph">hybrid</code> (scans of multiple beacon types<br>                                            used)</li><br><br>                                    </ul> |
| `streetAddress` | `streetAddress` | `streetAddress` | Street address element. <br>A value is returned only if<br>                                        `streetAddressLookupType` is set to either<br>                                        `full` or `limited` in the API<br>                                    request, and its location can be detected by the RGeo lookup<br>                                    service. |
|  | `streetNumber` | `streetNumber` | Street number of the address. <br>A value is returned only if<br>                                        `streetAddressLookupType` is set to<br>                                        `full` in the API request. |
|  | `addressLine` | `addressLine` | Contains street name, and other address lines such as apartment<br>                                number, if applicable.<br>A value is returned only if<br>                                        `streetAddressLookupType` is set to<br>                                        `full` in the API request. |
|  | `neighborhood` | `neighborhood` | Neighborhood of the address. |
|  | `city` | `city` | City of the address. |
|  | `metro1` | `metro1` | City of the location. |
|  | `metro2` | `metro2` | City/township of the location. |
|  | `postalCode` | `postalCode` | Postal code associated with the address. |
|  | `country` | `country` | County in which the address is located. |
|  | `region` | `region` | Region in which the address is located. |
|  | `stateCode` | `stateCode` | State code associated with the address. |
|  | `stateName` | `stateName` | State in which the address is located. |
|  | `countryCode` | `countryCode` | Country code associated with the address. |
| `venue` | `venue` | `venue` | Venue element. <br>A value is returned only if the beacons<br>                                    associated with the user’s account (linked by authentication<br>                                    key) are relevant to the beacons in the API request that were<br>                                    determined for a specific indoor venue. |
|  | `name` | `name` | Name of the venue. |
|  | `conf` | `conf` | Confidence value in detecting the venue, in decimal<br>                                percentage. |
|  | `floor` | `floor` | Floor element. <br>A value is returned only if the beacons in the<br>                                    API request were determined for a specific floor within the<br>                                    venue. |
|  |  | `name` | Name of the floor. |
|  |  | `level` | Level of the floor, in decimals, such as 0.5 floors may<br>                                exist. |
|  |  | `conf` | Confidence value in detecting the floor within the venue, in<br>                                decimal percentage. |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

### Sample response

    {
        "location": {
            "lat": 42.297002,
            "lng": -71.233323
        },
        "accuracy": 18,
        "nap": 0,
        "ncell": 0,
        "nlac": 0,
        "nsat": 9,
        "nble": 0,
        "source": "gnss",
        "streetAddress": {
            "streetNumber": 64,
            "addressLine": "Farnsworth St",
            "neighborhood": "Beantown",
            "city": "Boston",
            "metro1": "Boston",
            "metro2": "Boston County",
            "postalCode": "02210",
            "county": "Suffolk",
            "region": "North East",
            "stateCode": "MA",
            "stateName": "Massachusetts",
            "countryCode": "US",
            "countryName": "United States"
        },
        "venue": {
            "name": "TestLoc",
            "conf": 0.9,
            "floor": {
                "name": "Floor 1",
                "level": 1,
                "conf": 0.9
            }
        }
    }
    Copy to clipboard

Last Published: Aug 03, 2026

[Previous Topic
TPS JSON API request](https://docs.qualcomm.com/bundle/publicresource/80-42204-1/topics/4_TPS_JSON_API_request.md) [Next Topic
Sample TPS JSON API request](https://docs.qualcomm.com/bundle/publicresource/80-42204-1/topics/sample-aps-json-api-request.md)