GuidesAPI Reference
Guides
  1. Network Positioning API v1
  2. Guide
  3. Examples

How to contribute multiple technology measurements

📘

Note

HERE Network Positioning API v1 is in maintenance and is not actively developed. Use HERE Network Positioning API v2 to get the latest features and updates. To learn more, see the HERE Network Positioning API v2 Developer Guide.

This section provides an example of a contribute request with measurements of different cellular technologies together with a gnss location.

User Story

User wants to wants to improve the responses for requests to the locate resource by contributing measurements from different technologies from a known location.

Request

The code block below demonstrates a POST request to contribute the cellular information in the POST body.

https://pos.ls.hereapi.com/positioning/v1/contribute?apiKey={YOUR_API_KEY}

You need to set request content type in the HTTP headers:

Content-Type: application/json

This POST request requires the following POST body.

{
  "client":{
    "manufacturer":"maker-of-the-device",
    "platform":"platform-of-the-device",
    "name":"client-name",
    "version":"1.1.10107",
    "model":"XYZ-123",
    "firmware": "1.2.3",
    "homenetwork": [
      {
        "mcc": 262,
        "mnc": 501
      }
    ]
  },
  "contributions":[
    {
      "gsm":[
        {
          "mcc": 262,
          "mnc": 501,
          "lac": 29589,
          "cid": 19373,
          "timestamp":"2016-06-30T14:10:32Z"
        }
      ],
      "lte":[
        {
          "mcc": 262, 
          "mnc": 501,
          "cid": 152649985,
          "ta": 47,
          "rsrp": -60,
          "rsrq": -10,
          "timestamp":"2016-06-30T14:10:34Z"
        }
      ],
      "wlan":[
        { 
          "mac": "52:67:51:28:37:a2", 
          "powrx": -87, 
          "band": 5 
        },
        { 
          "mac": "72:8d:f7:bc:7c:58", 
          "powrx": -79, 
          "band": 2.4 
        },
        { 
          "mac": "02:09:4f:80:91:97", 
          "powrx": -75 
        }
      ],
      "position":{
        "type":"gnss",
        "lat":52.400608,
        "lng":13.389481,
        "accuracy":17,
        "alt":68,
        "altaccuracy":95,
        "speed": 1,
        "course": 42,
        "satellitecount": 9,
        "timestamp":"2016-06-30T14:10:34Z"
      }
    },
    {
      "gsm":[
        {
          "mcc":262,
          "mnc":501,
          "lac":29589,
          "cid":19374,
          "timestamp":"2016-06-30T14:15:34Z"
        }
      ],
      "wlan": [
        { 
          "mac": "52:67:51:28:37:a4", 
          "powrx": -87, 
          "band": 5
        },
        { 
          "mac": "72:8d:f7:bc:7c:60", 
          "powrx": -79, 
          "band": 2.4 
        }
      ],
      "position":{
        "type":"gnss",
        "lat":52.501608,
        "lng":13.403481,
        "accuracy":11,
        "alt":15,
        "altaccuracy":102,
        "speed": 2,
        "satellitecount": 8,
        "course": 52,
        "timestamp":"2016-06-30T13:15:34Z"
      }
    }
  ]
}

Response

The response to the request contains the status of the POST request.

{
  "success": {
    "code": 200,
    "message": "OK",
    "description": "Data was received successfully"
  }
}

Related Information

Updated last month