# 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
`hpeConfidence` is set to 68% (default) or 95% in
the API request.
Note: The default 68%
confidence is supported in TPS v2.28 and later.
For 95% confidence, set `hpeConfidence` to 95 in
the location request. |
| `nap` | `nap` | `nap` | Number of AP scans used to determine location.
A value is
returned only if `includeBeaconCounts` is set to
`true` in the API request. |
| `ncell` | `ncell` | `ncell` | Number of cell scans used to determine location.
A value is
returned only if `includeBeaconCounts` is set to
`true` in the API request. |
| `nlac` | `nlac` | `nlac` | Number of Location Area Codes (LACs) used to determine location.
A value is returned only if
`includeBeaconCounts` is set to
`true` in the API request. |
| `nsat` | `nsat` | `nsat` | Number of satellites in the GPS location used to determine
location. In case of cell fallback, this value is greater than
0.
A value is returned only if `includeBeaconCounts`
is set to `true` in the API request. |
| `nble` | `nble` | `nble` | Number of BLE scans used to determine location.
A value is
returned only if `includeBeaconCounts` is set to
`true` in the API request. |
| `source` | `source` | `source` | Beacon type used to determine to location.
A value is
returned only if `includeLocationSource` is set
to `true` in the API request. Values can be:
unknown
cell
wifi
gnss
ble
rfpm
hybrid (scans of multiple beacon types
used)
|
| `streetAddress` | `streetAddress` | `streetAddress` | Street address element.
A value is returned only if
`streetAddressLookupType` is set to either
`full` or `limited` in the API
request, and its location can be detected by the RGeo lookup
service. |
| | `streetNumber` | `streetNumber` | Street number of the address.
A value is returned only if
`streetAddressLookupType` is set to
`full` in the API request. |
| | `addressLine` | `addressLine` | Contains street name, and other address lines such as apartment
number, if applicable.
A value is returned only if
`streetAddressLookupType` is set to
`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.
A value is returned only if the beacons
associated with the user’s account (linked by authentication
key) are relevant to the beacons in the API request that were
determined for a specific indoor venue. |
| | `name` | `name` | Name of the venue. |
| | `conf` | `conf` | Confidence value in detecting the venue, in decimal
percentage. |
| | `floor` | `floor` | Floor element.
A value is returned only if the beacons in the
API request were determined for a specific floor within the
venue. |
| | | `name` | Name of the floor. |
| | | `level` | Level of the floor, in decimals, such as 0.5 floors may
exist. |
| | | `conf` | Confidence value in detecting the floor within the venue, in
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: Mar 17, 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)