Jump to Content

How to contribute WLAN, GNSS, and Country Info

📘
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.

User Story

The user wants to improve the responses for requests to the locate resource by contributing WLAN measurements together with a GNSS location and country information.

Request

The code block below demonstrates a POST request to contribute the WLAN measurements and GNSS location and country information in the POST body.

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

You need to set the 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":[
    {
      "wlan":[
        { 
          "mac": "52:67:51:28:37:a2", 
          "powrx": -87, 
          "band": 5,
          "timestamp":"2016-06-30T14:10:30Z" 
        },
        { 
          "mac": "72:8d:f7:bc:7c:58", 
          "powrx": -79, 
          "band": 2.4,
          "timestamp":"2016-06-30T14:10:30Z"
        }
      ],
      "position":{
        "type":"gnss",
        "lat":52.501608,
        "lng":13.403481,
        "accuracy":17,
        "alt":68,
        "altaccuracy":95,
        "speed": 2,
        "satellitecount": 8,
        "course": 52,
        "timestamp":"2016-06-30T14:10:30Z"
      },
      "country":{
        "mcc": 262
      }
    },
    {
      "wlan": [
        { 
          "mac": "52:67:51:28:37:a4", 
          "powrx": -87, 
          "band": 5,
          "timestamp":"2016-06-30T14:10:33Z"
        },
        { 
          "mac": "72:8d:f7:bc:7c:60", 
          "powrx": -79, 
          "band": 2.4,
          "timestamp":"2016-06-30T14:10:33Z" 
        }
      ],
      "position":{
        "type":"gnss",
        "lat":52.501608,
        "lng":13.403481,
        "accuracy": 8,
        "alt":15,
        "altaccuracy":102,
        "speed": 5,
        "satellitecount": 8,
        "course": 53,
        "timestamp":"2016-06-30T13:15:34Z"
      },
      "country":{
        "mcc": 262
      }
    }
  ]
}

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