TROBDB: Unterschied zwischen den Versionen
Stefan (Diskussion | Beiträge) K (→Webservices) |
Stefan (Diskussion | Beiträge) K (→Get traffic obstructions) |
||
Zeile 36: | Zeile 36: | ||
Example: | Example: | ||
* Request: <code>GET http://trobdb.hsr.ch/api/trobs/?way_id=22222222&key=demo</code> | * Request: <code>GET http://trobdb.hsr.ch/api/trobs/?way_id=22222222&key=demo</code> | ||
− | * Response | + | * Response(if success, GeoJSON): |
− | < | + | <code> |
{ "type": "FeatureCollection", "features": [ | { "type": "FeatureCollection", "features": [ | ||
{"type": "Feature","properties": { "sysdate": "2013-11-26 14:18:42", "traffic_obstruction_end": "2013-11-30 05:00:00", "direction": "as_is", "truckInfoImagePath": "mapserver2/symbols/icone35.png", "traffic_obstruction_start": "2013-11-27 21:00:00", "description": "[Schweiz] rechter Fahrstreifen gesperrt|Bern Richtung Zürich|Zwischen AS Lenzburg und AS Mägenwil rechter Fahrstreifen gesperrt, vorübergehende Begrenzung der Breite auf 3.0 Meter, Höchstgeschwindigkeit: 80 km/h, Baustelle in der Nacht, Dauer: 27.11.2013 21:00 Uhr bis 30.11.2013 05:00 Uhr|", "emergency": "", "title": "[Schweiz] rechter Fahrstreifen gesperrt Bern Richtung Zürich", "issued": "2013-11-26 14:18:16", "traffic_obstruction_string": "27.11.2013 21:00 Uhr bis 30.11.2013 05:00 Uhr", "isTunnel": "False", "issuer_name": "truckinfo.ch", "country": "Schweiz", "roadNarrow": "3", "category": "1_31", "isCarLoad": "False", "isPass": "False", "road": "A1"},"geometry": {"type": "LineString", "coordinates": [[8.2121933, 47.4065703], [8.2126037, 47.4068268], [8.2141709, 47.4077618], [8.2149955, 47.4082739], [8.2154032, 47.4085423], [8.2158038, 47.40881], [8.2164978, 47.4093186], [8.2169385, 47.409656], [8.2173768, 47.4100066], [8.2180022, 47.4105499], [8.2185954, 47.4111157], [8.2192297, 47.4117786], [8.2198332, 47.4124779], [8.2212912, 47.4143689]]}} | {"type": "Feature","properties": { "sysdate": "2013-11-26 14:18:42", "traffic_obstruction_end": "2013-11-30 05:00:00", "direction": "as_is", "truckInfoImagePath": "mapserver2/symbols/icone35.png", "traffic_obstruction_start": "2013-11-27 21:00:00", "description": "[Schweiz] rechter Fahrstreifen gesperrt|Bern Richtung Zürich|Zwischen AS Lenzburg und AS Mägenwil rechter Fahrstreifen gesperrt, vorübergehende Begrenzung der Breite auf 3.0 Meter, Höchstgeschwindigkeit: 80 km/h, Baustelle in der Nacht, Dauer: 27.11.2013 21:00 Uhr bis 30.11.2013 05:00 Uhr|", "emergency": "", "title": "[Schweiz] rechter Fahrstreifen gesperrt Bern Richtung Zürich", "issued": "2013-11-26 14:18:16", "traffic_obstruction_string": "27.11.2013 21:00 Uhr bis 30.11.2013 05:00 Uhr", "isTunnel": "False", "issuer_name": "truckinfo.ch", "country": "Schweiz", "roadNarrow": "3", "category": "1_31", "isCarLoad": "False", "isPass": "False", "road": "A1"},"geometry": {"type": "LineString", "coordinates": [[8.2121933, 47.4065703], [8.2126037, 47.4068268], [8.2141709, 47.4077618], [8.2149955, 47.4082739], [8.2154032, 47.4085423], [8.2158038, 47.40881], [8.2164978, 47.4093186], [8.2169385, 47.409656], [8.2173768, 47.4100066], [8.2180022, 47.4105499], [8.2185954, 47.4111157], [8.2192297, 47.4117786], [8.2198332, 47.4124779], [8.2212912, 47.4143689]]}} | ||
]} | ]} | ||
− | </ | + | </code> |
== Datenstruktur == | == Datenstruktur == |
Version vom 28. November 2013, 23:26 Uhr
Projekt "Traffic Obstruction Database" (TROBDB) mit Webservices
Website (inkl. DB, Webservice/API) für Verkehrshindernisse. Traffic Obstruction Database (TROBDB). Teil des BLUgis-Projekts.
Definition/Abgrenzung: Unter Verkehrshindernisse (engl.: "Traffic Obstructions", Driving Bans) verstehen wir hier temporäre Fahrverbote oder temporär gesperrte Strassen u.a. wegen Baustellen oder Veranstaltungen, die geplant und angekündigt sind. Staus oder andere Echtzeitinformationen gehören nicht dazu.
Inhaltsverzeichnis
Datenquellen
- Verkehrszentrale des Bundes (Baustellen, Pässe, Tunnelzufahrten und andere Verkehrssperrungen). Die Daten werden jeweils vor 11h und vor 16h von truckinfo.ch abgeholt.
- Stadt Zürich, Baustellen, als Download-Service.
- Rettungsdienst BLUgis/Regio144 (geplant)
- Registrierte Nutzer über das Webinterface (geplant)
Hinweis: Die konsolidierten TROBDB-Daten werden jeweils täglich um ca. 11h und 16h aktualisiert.
Webservices
General information about API
- Current API version is 'v1'.
- Base URL is http://trobdb.hsr.ch/
- The current API only allows GET (read) requests. Modifying request are not implemented and not allowed.
- Authentication is implemented using key-parameter. Demo key is 'demo'
Get traffic obstructions
- Description: Returns a traffic obstruction (as an array of way_id's)
- URL: /api/[version]/news/
- Parameters:
- way_id - Values: long integer (mandatory)
- format - Values: (json) (optional)
- Method: GET
- Returns:
- 200 OK - All Ok.
- 401 Unauthorized - Wrong key?
- 400 Bad Request - parameter unknown, not existent or way_id does not exist
Example:
- Request:
GET http://trobdb.hsr.ch/api/trobs/?way_id=22222222&key=demo
- Response(if success, GeoJSON):
{ "type": "FeatureCollection", "features": [
{"type": "Feature","properties": { "sysdate": "2013-11-26 14:18:42", "traffic_obstruction_end": "2013-11-30 05:00:00", "direction": "as_is", "truckInfoImagePath": "mapserver2/symbols/icone35.png", "traffic_obstruction_start": "2013-11-27 21:00:00", "description": "[Schweiz] rechter Fahrstreifen gesperrt|Bern Richtung Zürich|Zwischen AS Lenzburg und AS Mägenwil rechter Fahrstreifen gesperrt, vorübergehende Begrenzung der Breite auf 3.0 Meter, Höchstgeschwindigkeit: 80 km/h, Baustelle in der Nacht, Dauer: 27.11.2013 21:00 Uhr bis 30.11.2013 05:00 Uhr|", "emergency": "", "title": "[Schweiz] rechter Fahrstreifen gesperrt Bern Richtung Zürich", "issued": "2013-11-26 14:18:16", "traffic_obstruction_string": "27.11.2013 21:00 Uhr bis 30.11.2013 05:00 Uhr", "isTunnel": "False", "issuer_name": "truckinfo.ch", "country": "Schweiz", "roadNarrow": "3", "category": "1_31", "isCarLoad": "False", "isPass": "False", "road": "A1"},"geometry": {"type": "LineString", "coordinates": [[8.2121933, 47.4065703], [8.2126037, 47.4068268], [8.2141709, 47.4077618], [8.2149955, 47.4082739], [8.2154032, 47.4085423], [8.2158038, 47.40881], [8.2164978, 47.4093186], [8.2169385, 47.409656], [8.2173768, 47.4100066], [8.2180022, 47.4105499], [8.2185954, 47.4111157], [8.2192297, 47.4117786], [8.2198332, 47.4124779], [8.2212912, 47.4143689]]}}
]}
Datenstruktur
"Traffic Obstruction DB":
Tabelle/Record "trobdb_line":
geometry: Linestring NOT_NULL -- gesperrte Richtung, d.h. Reihenfolge der Stüzpunkte relevant!) id_ref: integer NULL -- id der Quell-Datenbank (und dort UNIQUE NOT_NULL) title: varchar(100) NOT_NULL description: text NUL_NULL traffic_obstruction_start: date/datetime NOT_NULL traffic_obstruction_end: date/datetime NOT_NULL traffic_obstruction_string: text NULL -- Intervall-Zeitangaben (vgl. Bemerkungen) emergency: boolean NULL -- Rettungs-Fz können trotzdem durchfahren direction: (0..1) ENUM(as_is, reverse) NULL -- Default: NULL = "both directions" sysdate: datetime NOT_NULL -- Datum der Erfassung dieser Info issued: datetime NULL -- Datum von demjenigen, von wo die Meldung kam issuer_name: (0..1) text NULL -- Name derjenigen, von wo die Meldung kam file_ref: URL NULL -- relative_path_to_file, allowed formats: PDF, JPG, PNG, GIF osm_way_id: biginteger NULL -- OSM way id vom Matching (nur bei trobdb_line) osm_way_type: string NULL -- Wert des highway-Tags, z.B. motorway, footway (nur bei trobdb_line) osm_way_oneway: boolean NULL -- Einbahnstrasse (nur bei trobdb_line)
Tabelle/Record "trobdb_area":
geometry: Polygon -- gesperrte Fläche, z.B. bei Dorfkern-Sperrungen ... -- ditto wie "trobdb_line"
Tabelle/Record "trobdb_poi":
geometry: Point -- gesperrter Punkt, z.B. Pässe/Tunnel/Autoverlade ... -- ditto wie "trobdb_line"
Bemerkungen:
- Intervall-Zeitangaben ("Behinderungszeiten", Öffnungszeiten, Betriebszeiten):
- Definition OSM: http://wiki.openstreetmap.org/wiki/DE:Key:opening_hours
- Demo (inkl. Source Code): http://robin.de.marissa.hostorama.ch/osm/opening_hours.js/demo.html