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

How to get indoor floor level coordinates with Bluetooth

📘

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 determine the WGS-84 compliant coordinates defined by the Bluetooth information in the POST body together with a floor level information.

Request

The code block below demonstrates a POST request to get the geocoordinates defined by the Bluetooth information in the POST body.

https://pos.ls.hereapi.com/positioning/v1/locate?desired=floor

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

Authorization: Bearer {YOUR_TOKEN}
Content-Type: application/json

This POST request requires the following POST body.

{
  "bt": [{
    "mac": "EE:01:02:00:00:06",
    "rss": -74
  }, {
    "mac": "EE:01:02:00:00:30",
    "rss": -75
  },{
    "mac": "EE:01:02:00:00:13",
    "rss": -76
  },{
    "mac": "EE:01:02:00:00:18",
    "rss": -77
  },{
    "mac": "EE:01:02:00:00:16",
    "rss": -79
  }]
}

Response

The response to the request contains:

  • lat: WGS-84 compliant latitude coordinate
  • lng: WGS-84 compliant longitude coordinate
  • accuracy: Radius of the uncertainty circle around the position in meters
  • floor: Floor information
  • floor.level: Floor level
  • floor.id: Building Id
  • floor.name: Building Name
{
  "location": {
    "lat": 61.470619,
    "lng": 23.722658,
    "accuracy": 7,
    "floor": {
      "level": 1,
      "id": "DM_1111111",
      "name": "Test Building"
    }
  }
}

Related Information

Updated last month