TROBDB: Unterschied zwischen den Versionen

Aus Geoinformation HSR
Wechseln zu: Navigation, Suche
K (Get traffic obstructions)
K (Webservices)
Zeile 20: Zeile 20:
 
* Base URL is http://trobdb.hsr.ch/
 
* Base URL is http://trobdb.hsr.ch/
 
* The current API only allows GET (read) requests. Modifying request are not implemented and not allowed.
 
* 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'
+
* Usage policy: restricted use!
 +
 
 +
Parameters common for all webservices:
 +
* format - Values: 'geojson' (optional)
 +
* key - Values: 'demo'|<<user_id>>. Used for simple authentication. Please contact us for registration.
  
 
=== Get traffic obstructions ===
 
=== Get traffic obstructions ===

Version vom 28. November 2013, 23:31 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.

Datenquellen

  1. Verkehrszentrale des Bundes (Baustellen, Pässe, Tunnelzufahrten und andere Verkehrssperrungen). Die Daten werden jeweils vor 11h und vor 16h von truckinfo.ch abgeholt.
  2. Stadt Zürich, Baustellen, als Download-Service.
  3. Rettungsdienst BLUgis/Regio144 (geplant)
  4. 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.
  • Usage policy: restricted use!

Parameters common for all webservices:

  • format - Values: 'geojson' (optional)
  • key - Values: 'demo'|<<user_id>>. Used for simple authentication. Please contact us for registration.

Get traffic obstructions

  • Description: Returns a traffic obstruction (as an array of way_id's)
  • URL: /api/[version]/trobs/
  • Parameters:
    • way_id - Values: long integer (mandatory)
  • 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:

{ "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: