Positioning API Developer's Guide

Constructing a Request

A typical request to the Positioning API includes the basic elements shown in the following table and, in addition, it may contain resource-specific parameters or data.

Table 1. Basic request elements
Element Value/Example Description
Base URL



Production environment only

CIT environment: see HERE Server Environments

Path /positioning/v1/  


HTTPS POST only, submit data in the body of the request

HTTP header field Content-Type=application/json Used in both requests and responses.
HTTP header field Content-Encoding=gzip Optional header, indicates gzip encoded request body content
Application Code &app_code={YOUR_APP_CODE} Substitute your own unique app_code
Application Id &app_id={YOUR_APP_ID} Substitute your own unique app_id
Here is an example of locate request, which uses the HTTP POST method:
The POST body is as follows
  "wcdma": [{
    "mcc": 262,
    "mnc": 1,
    "cid": 2106148