Paths

This graph represents all the routes by which the user can move within the building. More details here.
The path object
nodes array of objects
Each node represents a certain location within the building (x, y, floor)
Node attributes
id integer
Node identifier
floor_id integer
Floor identifier in which the node is situated
x float
Cartesian coordinate taking the bottomleft corner as the origin
More details here
Coordinate in meters
y float
Cartesian coordinate taking the bottomleft corner as the origin
More details here
Coordinate in meters
links array of objects
Each link represents a navigable path within two nodes
Link attributes
source integer
Node identifier
target integer
Node identifier
origin string
Indicates if the link is uni or bidirectional depending on whether the origin is in one, another or both nodes
This can be either source, target or both
accesible boolean
Indicates if the path is situable for persons with reduced mobility
This can be either true or false
Example Response
{
  "nodes": [
    {
      "id": 1,
      "floor_id": 257,
      "x": 0.998,
      "y": 24.348
    },
    {
      "id": 3,
      "floor_id": 257,
      "x": 26.299,
      "y": 24.121
    }
  ],
  ,
  "links": [
    {
      "source": 1,
      "target": 3,
      "origin": "both",
      "accessible": true
    }
  ]
}

Graph representing the navigable paths of a building

The graph is represented by a set of nodes and a set of links within those nodes. Each node represent a certain location within the building (x, y, floor), while each link represents a navigable path within two positions. Moreover, a link may have different attributes: accesible (suitable for persons with reduced mobility), uni or bidirectional, etc.
Parameters
X-API-EMAIL required
The email of the user
X-API-KEY required
The API key of the user
building_id required path param
Building identifier (retrieve all your buildings to know their identifiers)
Returns
Returns a hash with an array of nodes and an array of links.
Error Status Codes
Request url
https://dashboard.situm.es/api/v1/buildings/:building_id/paths
*Deprecated: https://dashboard.situm.es/api/v1/projects/:building_id/paths (supported until SDK 4.0)
Curl
curl -H 'Content-Type: application/json' -H 'X-API-EMAIL: user@example.com' -H 'X-API-KEY: T9NP2lzk+jSI/Oi5DG6ODk57O0pZXdx4' "https://dashboard.situm.es/api/v1/buildings/:building_id/paths"
Response body
{
  "nodes": [
    {
      "id": 1,
      "floor_id": 257,
      "x": 0.998,
      "y": 24.348
    },
    {
      "id": 3,
      "floor_id": 257,
      "x": 26.299,
      "y": 24.121
    },
    {
      "id": 4,
      "floor_id": 257,
      "x": 37.166,
      "y": 28.649
    },
    {
      "id": 5,
      "floor_id": 257,
      "x": 39.487,
      "y": 31.14
    },
    {
      "id": 6,
      "floor_id": 257,
      "x": 35.298,
      "y": 33.857
    },
    {
      "id": 7,
      "floor_id": 257,
      "x": 42.543,
      "y": 36.234
    },
    {
      "id": 8,
      "floor_id": 257,
      "x": 40.392,
      "y": 37.706
    },
    {
      "id": 9,
      "floor_id": 257,
      "x": 1.224,
      "y": 16.31
    },
    {
      "id": 10,
      "floor_id": 257,
      "x": 5.639,
      "y": 24.404
    },
    {
      "id": 11,
      "floor_id": 257,
      "x": 5.922,
      "y": 16.82
    },
    {
      "id": 12,
      "floor_id": 257,
      "x": 30.883,
      "y": 33.687
    },
    {
      "id": 13,
      "floor_id": 256,
      "x": 31.053,
      "y": 34.14
    },
    {
      "id": 14,
      "floor_id": 256,
      "x": 36.26,
      "y": 31.593
    },
    {
      "id": 16,
      "floor_id": 256,
      "x": 37.845,
      "y": 28.366
    },
    {
      "id": 17,
      "floor_id": 256,
      "x": 27.77,
      "y": 24.121
    },
    {
      "id": 18,
      "floor_id": 256,
      "x": 1.281,
      "y": 24.121
    },
    {
      "id": 20,
      "floor_id": 256,
      "x": 42.826,
      "y": 35.668
    },
    {
      "id": 21,
      "floor_id": 256,
      "x": 36.204,
      "y": 39.743
    },
    {
      "id": 22,
      "floor_id": 256,
      "x": 35.298,
      "y": 30.291
    },
    {
      "id": 23,
      "floor_id": 256,
      "x": 30.657,
      "y": 32.894
    },
    {
      "id": 24,
      "floor_id": 255,
      "x": 30.94,
      "y": 34.592
    },
    {
      "id": 25,
      "floor_id": 255,
      "x": 36.034,
      "y": 31.31
    },
    {
      "id": 26,
      "floor_id": 255,
      "x": 35.355,
      "y": 29.895
    },
    {
      "id": 27,
      "floor_id": 255,
      "x": 37.619,
      "y": 28.423
    },
    {
      "id": 28,
      "floor_id": 255,
      "x": 27.77,
      "y": 24.348
    },
    {
      "id": 29,
      "floor_id": 255,
      "x": 24.827,
      "y": 23.499
    },
    {
      "id": 30,
      "floor_id": 255,
      "x": 24.431,
      "y": 17.159
    },
    {
      "id": 32,
      "floor_id": 255,
      "x": 42.487,
      "y": 36.008
    },
    {
      "id": 33,
      "floor_id": 255,
      "x": 1.664,
      "y": 24.686
    }
  ],
  "links": [
    {
      "source": 3,
      "target": 4,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 4,
      "target": 5,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 5,
      "target": 6,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 5,
      "target": 7,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 7,
      "target": 8,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 1,
      "target": 9,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 1,
      "target": 10,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 3,
      "target": 10,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 10,
      "target": 11,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 4,
      "target": 12,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 12,
      "target": 13,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 13,
      "target": 14,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 16,
      "target": 17,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 17,
      "target": 18,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 16,
      "target": 20,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 20,
      "target": 21,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 16,
      "target": 22,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 14,
      "target": 22,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 22,
      "target": 23,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 23,
      "target": 24,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 24,
      "target": 25,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 25,
      "target": 26,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 26,
      "target": 27,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 27,
      "target": 28,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 28,
      "target": 29,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 29,
      "target": 30,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 27,
      "target": 32,
      "origin": "both",
      "accessible": true
    },
    {
      "source": 29,
      "target": 33,
      "origin": "target",
      "accessible": true
    }
  ]
}