Positioning API Developer's Guide

WCDMA Positioning

This section provides an example of a request for a position based on WCDMA measurements.

User Story

The user wants to determine the WGS-84 compliant coordinates defined by the WCDMA information in the POST body.

Request Summary

The following list summarizes the elements required to create a request matching the user story and shows, in square brackets, how those elements are used in the request example below. Note that the request example also uses the authentication parameters.

Resource: locate
Parameter: Description:
app_id

xs:string

A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.

You must include an app_id and app_code with every request.  To get an app_id assigned to you, please see Acquiring Credentials.

app_code

xs:string

A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.

You must include an app_id and app_code with every request.  For information on how to get an app_id assigned to you, see Acquiring Credentials.

Content-Type: application/json
Body: "wcdma": [...], an array of wcdma cells in the measurement

Request

The code block below demonstrates the complete request, specifying that the response data are to be delivered in JSON.
https://pos.cit.api.here.com/positioning/v1/locate?app_id={YOUR_APP_ID}&app_code={YOUR_APP_CODE}
{
  "wcdma": [{
  "mcc": 262,
  "mnc": 7,
  "cid": 14674663,
  "nmr": [
    { "uarfcndl": 10786, "psc": 149},
    { "uarfcndl": 10762, "psc": 211}
  ]
  }]
}

Response

The response to the request contains:
  • lat: WGS-84 compliant latitude coordinate
  • long: WGS-84 compliant longitude coordinate
  • accuracy: Radius of the uncertainty circle around the position in meters
{
  "location": {
  "lat": 52.5186685,
  "lng": 13.37713954,
  "accuracy": 396
  }
}

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.