{"id":50707876,"url":"https://github.com/starwit/dave-adapter-telraam","last_synced_at":"2026-06-09T13:01:12.426Z","repository":{"id":359380187,"uuid":"1245794696","full_name":"starwit/dave-adapter-telraam","owner":"starwit","description":"Transfers data from Telraam sensors to DAVe","archived":false,"fork":false,"pushed_at":"2026-06-08T15:28:29.000Z","size":220,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-08T17:19:05.915Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/starwit.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-21T15:03:45.000Z","updated_at":"2026-06-03T09:17:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/starwit/dave-adapter-telraam","commit_stats":null,"previous_names":["starwit/dave-adapter-telraam"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/starwit/dave-adapter-telraam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starwit%2Fdave-adapter-telraam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starwit%2Fdave-adapter-telraam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starwit%2Fdave-adapter-telraam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starwit%2Fdave-adapter-telraam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/starwit","download_url":"https://codeload.github.com/starwit/dave-adapter-telraam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starwit%2Fdave-adapter-telraam/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34107866,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-09T13:00:37.352Z","updated_at":"2026-06-09T13:01:12.410Z","avatar_url":"https://github.com/starwit.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Adapter to send Telraam sensor data to DAVe\n[DAVe](https://starwit-technologies.de/products/dave-open-source-traffic-count-analysis-for-modern-mobility-management/) is a software to analyse and visualize traffic data. Data is collected by a large number of sensors. This repository shall provide code, to transfer data from sensor offered by [Telraam](https://telraam.net/). See their web page, if you want to know more about their hardware.\n\n## Mission Goal\nThis software shall read data from Telraam's sensor network and convert counting data such, that DAVe can create node stream diagrams. Diagrams look like so:\n![](doc/node-stream-diagram.jpg)\n\n### Target Features\n* Auto detect all sensors in a geo-fenced region\n* Check if for every sensor a counting spot in DAVe exists\n* Auto Detect traffic direction (north, south,...)\n* Transfer count data every 15 minutes\n\n## Traffic Data Background\nThis section provides all info, to understand how to transfer data to DAVe and how to extract them from Telraam.\n\n### Data Model in DAVe\nIn [DAVe](https://opensource.muenchen.de/de/software/dave.html) directions are defined as shown in the following image. Top side is pointing north. Following image shows an example for a configured intersection counting.\n\n![](doc/dave-directions.jpg)\n\nAll collected data needs to be brought into this format.\n\n### Telraam Sensor Doc\nData for Telraam sensors can be accessed via a centralized API. See [API Definition](https://app.swaggerhub.com/apis-docs/telraam/Telraam-API/1.2.0) for more details. There are also some [examples](doc/telraam.md) how to query this API.\n\n## Technical Architecture\nApplication is implemented using Spring Boot. Core is a scheduled task, that reads data from Telraam REST API and send converted date to DAVe. \n\n### Configuration\nCore config concept is (for the time being), that adapter collects all Telraam sensors in a provided geo-fence. For every sensor found data is queried if there is a mapping to a DAVe counting location. This mapping looks like so:\n\n```properties\ntelraam.segment-mapping[0].segment-id=9000011165\ntelraam.segment-mapping[0].zaehlung-id=f6e155f4-89e9-4046-830a-ead29fa6d7a5\n```\n\nFor all config items see shipped [application.properties](src/main/resources/application.properties).\n\n### Authentication \nBoth endpoints need configuration data including authentication. DAVe uses openID connect to authenticate API access whereas Telraam needs an API key.\n\nFollowing config shows, how to provide necessary config items.\n\n```properties\n# DAVe Authentication\nspring.security.oauth2.client.registration.dave.client-id=client_id\nspring.security.oauth2.client.registration.dave.client-secret=secret\nspring.security.oauth2.client.registration.dave.authorization-grant-type=client_credentials\nspring.security.oauth2.client.registration.dave.scope=openid\nspring.security.oauth2.client.provider.dave.token-uri=https://hostname.de/auth/realms/dave/protocol/openid-connect/token\n\n# Telraam Authentication\ntelraam.api-url=https://telraam-api.net\ntelraam.api-key=sExGZJSxQK3mEBv8UTNhv3keK2ZOZpEg7GmIq2PV\n```\n\n# Developer Doc\nAdapter is developed using Java \u0026 Spring Boot. In order to run adapter, you need\n* a Telraam API key for advanced API\n* a running DAVe instance \n* create a counting location, for at least one Telraam sensor\n* openID credentials, if your DAVe instance is protected by Keycloak\n* easiest way to provide necessary config, is to create a copy of [application.properties](src/main/resources/application.properties) to root folder of adapter repo\n\n\n```bash\n# build adapter\nmvn package\n\n# run adapter, replace with latest version\njava -jar target/dave-adapter-telraam-0.0.1-SNAPSHOT.jar\n```\n\n## Docker \u0026 Helm\nTODO\n\n\n# License \u0026 Contribution\nThis project is licensed under the AGPLv3 License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarwit%2Fdave-adapter-telraam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstarwit%2Fdave-adapter-telraam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarwit%2Fdave-adapter-telraam/lists"}