OpenLR™ is a standard for handling map locations.
![Map OpenLR encoded](/sites/default/files/inline-images/OpenLR_Flows_API_labeled_0.png)
It is designed to transfer location information between different traffic management systems, using dissimilar maps. The encoded locations are typically specific road stretches, lists of connected roads, point locations or areas.
OpenLR™ allows users to read data from Flows without to know the internal network representation used by Flows.
In KPI API context, a KPI result is associated to a specific location: a location is composed by several streets and every street has an OpenLR code.
KPI API endpoints return details for all locations, for a given customer, adding OpenLR codes attached to the street entities associated to a generic corridor.
Example:
{
"name": "giotestfinal",
"entities": [
{
"strt": 84899,
"fsnd": 96586,
"openLrCode": "CwjonR3U/yKDBADPAMYiM+k=",
"order": 0,
"startProgressive": 0.66502345,
"endProgressive": 1
},
{
"strt": 84898,
"fsnd": 88888,
"openLrCode": "CwjonR3U/yKDBADPAMYicxbf",
"order": 1,
"startProgressive": 0,
"endProgressive": 1
},
{
"strt": 126146,
"fsnd": 80148,
"openLrCode": "CwjonR3U/yKDBADPAMYicyBm",
"order": 2,
"startProgressive": 0,
"endProgressive": 1
},
{
"strt": 136457,
"fsnd": 126079,
"openLrCode": "CwjonR3U/yKDBADPAMYic5kX",
"order": 3,
"startProgressive": 0,
"endProgressive": 1
},
{
"strt": 135697,
"fsnd": 135178,
"openLrCode": "CwjonR3U/yKDBADPAMYiU+g=",
"order": 4,
"startProgressive": 0,
"endProgressive": 1
},
{
"strt": 65935,
"fsnd": 49646,
"openLrCode": "Cwjo/h3VWyKDAgBjAFkiM5Y=",
"order": 5,
"startProgressive": 0,
"endProgressive": 1
},
{
"strt": 36182,
"fsnd": 29518,
"openLrCode": "Cwjo/h3VWyKDAgBjAFkiU2o=",
"order": 6,
"startProgressive": 0,
"endProgressive": 0.5083329
}
],
"shape": "LINESTRING (12.5279 41.951363, 12.52796 41.95142, 12.52796 41.95142, 12.52804 41.95151, 12.52804 41.95151, 12.52903 41.95244, 12.52903 41.95244, 12.52966 41.95305, 12.52966 41.95305, 12.52985 41.95323, 12.52985 41.95323, 12.53026 41.9536, 12.53026 41.9536, 12.530555 41.953864)",
"locationId": "833c5ead-3777-4a00-9d8b-87e1b41d1e7f",
"locationType": "PATH"
}
As shown in the example, you see an OpenLR code associated to any street of the corridor (locationType: PATH).