The Detector Ingestion API provides an endpoint to submit raw detector measurements for a PTV Flow product instance.  The submitted measurements are validated, archived, and forwarded for …

Protocol Buffers (Protobuf) , originally developed by Google, is a free and open-source cross-platform data format used to serialize structured data (see here ). It is useful in developing applications that communicate with each other over a network or …

Partial batch acceptance: valid and invalid items A System Integrator (SI) submits a batch where some measurements are valid and some are not (for example, a detector code that does not exist, or a reserved field set to a non-null value).  The service …

Partial batch acceptance: high volume ingestion A System Integrator (SI) submits a batch of 20.000 measurements. Due to the volume of the batch and the limit of the architectiure, the processing budget is exceeded after validating 14.000 items. The …

For architectural reasons, you can ingest up to 14.000 measurements in one only batch operation. If you want to load: One measurement for every detector, you can load 14.000 measurement joined to 14.000 detectors. Two measurements for every detector, you …

The Detector Ingestion API service is connected to Detectors API service. For this reason is relevant to take a look to Detectors API Relevant terms section.   Gzip Gzip (GNU Zip) is a widely used file format and software utility for lossless data …

{ "openapi": "3.0.3", "info": { "title": "Data Provider Detector Ingestion API", "description": "The *Data Provider Detector Ingestion API* provides an endpoint to submit raw detector measurements\nfor a product instance. Submitted measurements are …

You can use the Detector Ingestion service to implement standard batch ingestion of the measurements associated with the detectors in your Flows instance. A typical scenario is a client application (for example, a telemetry system) that provides a …

Add two detectors to a count location associated to a count site The System Integrator (SI) creates a sensors network. First step In one only payload the SI can build the entire hierarchy of count sites, count locations and detectors. In this use case, in …

A count site represents a logical object (like an intersection or a parking facility)  where speeds, flows, counts, etc. are measured with different technologies (for example, loops and cameras). It is a logical aggregation of many types of hardware …

Count site A count site represents a logical object (like an intersection or a parking facility)  where speeds, flows, counts, etc. are measured with different technologies (for example,  loops and cameras). It is a logical aggregation of many type of …

With the Detectors service you can get several types of measurements from the field of your instance. Follow the steps on this page to get started with Detectors …

Introduction PTV Flows allows traffic operators to effortlessly monitor and predict traffic in real-time, optimizing traffic management without extensive resources.   PTV Flows provides embedded functionalities such as: Automatic map matching of Floating …

Use Cases related to Sensors API …

Add a vehicle type The System Integrator (SI) needs to add a new vehicle type. First step As starting point, it is necessary to check which vehicle types are associated to your instance. GET …

{ "openapi": "3.1.1", "info": { "title": "Data Provider Registry API", "description": "The *PTV Flows Detector API* provides endpoints to access detector data of your product instance. It offers functionalities such as:\n* management interfaces for *count …

The Detectors API can be used to build a count site capable to register several types of real-time data. A count site represents a logical object (such as an intersection or a parking facility)  where speeds, flows, counts, etc. are measured using …

KPI instance  A KPI instance is described by a set of attributes: KPI identifier: unique alphanumeric string associated to a KPI instance.  Example: "kpiId" : "a5c22445-8592-430b-b36b-01d265a996d0" KPI name: string associated with a KPI instance. KPI …

{ "openapi": "3.0.3", "info": { "title": "PTV Flows Realtime Traffic API", "description": "The PTV Flows Realtime Traffic API provides the realtime traffic data of your product instance.", "version": "1.0.0-SNAPSHOT" }, "tags": [ { "name": "Traffic" } ], …

Protocol Buffers  ( Protobuf ), originally developed by Google, is a free and open-source cross-platform data format used to serialize structured data (see here ).  It is useful in developing applications that communicate with each other over a network or …

How to show the travel times forecast at +30 minutes The use case reflects the common need of a system integrator that must show of forecast results at +30 minutes on the GUI the layer. GET https://ptvgroup.tech/mlf/v1/forecast/realtime The result is an …

With the Network service you can get several information about tiles of your network. Follow the steps on this page to get started with Network …

Tiles  In the context of a traffic network map, a tile is a small square segment of an image or vector data that makes up a portion of a larger map.   Instead of downloading a single, massive image of the entire road network, modern mapping systems divide …

{ "openapi": "3.0.3", "info": { "title": "PTV Flows Network API", "description": "The PTV Flows Network API provides the network data of your product instance.", "version": "1.0.1-SNAPSHOT" }, "tags": [ { "name": "Network" }, { "name": "Tile" }, { "name": …

How to create alerts associated with a KPI value  The use case is focused on the creation of alerts associated with KPI values.  The KPI values can be compared with two different thresholds identifying a WARNING level (YELLOW) and a CRITICAL level (RED). …