ldproxy

Routing

implproposal

Unterstützung für pgRoutingopen in new window zur Berechnung von Routen.

Umfang

pgRouting kann zur Berechnung von Routen auf Grundlage eines Knoten-Kanten-Datensatzes verwendet werden. Diese Feature-Provider-Erweiterung erlaubt, die Kanten/Segmente einer Route als Antwort auf eine Abfrage bereitzustellen. Das Schema der Routensegmente wird als Objektart spezifiziert.

Das Schema der Routensegmente muss die folgenden Bedingungen erfüllen:

  • Jedes Feature ist ein Routensegment / eine Kante der Route. Die Kanten werden der Reihe nach von Anfang bis Ende zurückgegeben.
  • Der Name der Feature-Tabelle ist "_route_".
  • Die Objektart hat eine INTEGER-Eigenschaft node, die den Knoten am Anfang des Routensegments identifiziert. Der Wert ist entweder gleich data/source (Route in positiver Richtung der Kante) oder gleich data/target (Route in negativer Richtung der Kante).
  • Die Objektart hat eine FLOAT-Eigenschaft cost, die die Kosten der Kante in Fahrtrichtung angibt.
  • Die Objektart hat eine OBJECT-Eigenschaft data.
  • Das data-Objekt hat eine INTEGER-Eigenschaft source mit der Knoten-Id am Anfang der Kante.
  • Das data-Objekt hat eine INTEGER-Eigenschaft target mit der Knoten-Id am Ende der Kante.
  • Das data-Objekt hat eine FLOAT-Eigenschaft length_m mit der Länge der Kante in Meter.
  • Das data-Objekt hat eine GEOMETRY-Eigenschaft mit einer LINE_STRING-Geometrie.
  • Das data-Objekt kann eine FLOAT-Eigenschaft duration_forward_s mit der Dauer für das Fahren der Kante in positiver Richtung haben.
  • Das data-Objekt kann eine FLOAT-Eigenschaft duration_backward_s mit der Dauer für das Fahren der Kante in negativer Richtung haben.
  • Das data-Objekt kann eine FLOAT-Eigenschaft maxHeight_m mit der maximalen Fahrzeughöhe in Meter für die Kante haben.
  • Das data-Objekt kann eine FLOAT-Eigenschaft maxWeight_m mit dem maximalen Fahrzeuggewicht in Tonnen für die Kante haben.
  • Das data-Objekt kann eine FLOAT-Eigenschaft maxspeed_forward mit der Geschwindigkeitsbegrenzung auf der Kante in positiver Richtung haben.
  • Das data-Objekt kann eine FLOAT-Eigenschaft maxspeed_backward mit der Geschwindigkeitsbegrenzung am Rand in negativer Richtung haben.

Konfiguration

Optionen

NameDefaultBeschreibungTypSeit
type
Immer ROUTES.
string
v2.0
enabled
false
Soll die Erweiterung aktiviert werden?
boolean
v2.0
fromToQuery
null
Required Die SQL-Abfrage zur Bestimmung des Start- und Endpunkts der Route. ${point} wird durch die WKT-POINT-Geometrie des Wegpunktes ersetzt, der als Start/Ende verwendet werden soll.
object
v3.1
edgesQuery
null
Required Die SQL-Abfrage zur Bestimmung der Kanten/Routensegmente der Route. ${cost_column} und ${reverse_cost_column} werden durch die Spaltennamen ersetzt, die für die Optimierung der Route verwendet werden sollen. Dabei ist ${cost_column} der Wert in Richtung der Kante, ${reverse_cost_column} in der entgegengesetzten Richtung.
object
v3.1
routeQuery
null
Required Die SQL-Abfrage zur Berechnung der Route. Verwenden Sie ${edgesQuery} als Platzhalter für die edgesQuery, ${from_vid} und ${to_vid} als Platzhalter für den Start/Endpunkt. Falls unterstützt, verwenden Sie ${height}, ${weight}, und ${obstacles} als Platzhalter für die Einschränkungen bezüglich Höhe, Gewicht und Gebiet. ${flag_mask}, falls angegeben, wird durch die Summe aller für die Routing-Anfrage gesetzten zusätzlichen Flags ersetzt.
string
v3.1
flags
{}
Zusätzliche Flags, die gesetzt werden können, um sie bei der Berechnung der Route zu berücksichtigen. Der ganzzahlige Wert eines Flags muss ein eindeutiger Bit-Wert sein.
object
v3.1
nativeCrs
CRS84
Das Koordinatenreferenzsystem, in dem Geometrien in dem Routing-Datensatz geführt werden. Der EPSG-Code des Koordinatenreferenzsystems wird als Integer in code angegeben. Mit forceAxisOrder kann die Koordinatenreihenfolge geändert werden: NONE verwendet die Reihenfolge des Koordinatenreferenzsystems, LON_LAT verwendet stets Länge/Ostwert als ersten und Breite/Nordwert als zweiten Wert, LAT_LON entsprechend umgekehrt. Beispiel: Das Default-Koordinatenreferenzsystem CRS84 entspricht code: 4326 und forceAxisOrder: LON_LAT.
object
v3.1
preferences
{}
Required Listet die verfügbaren Optionen zur Optimierung der Route auf. Der Schlüssel ist die Id, der Wert ein Objekt aus Key-Value-Paaren mit den folgenden erforderlichen Keys: "label", "costColumn" (Name der Spalte in der Tabelle des zu minimierenden Netzsegments, wenn das Segment in positiver Richtung befahren wird), "reverseCostColumn" (dasselbe, aber für die Fahrt in negativer Richtung).
object
v3.1
modes
{}
Listet die verfügbaren Verkehrsmittel auf, der Schlüssel ist die Id, der Wert eine Bezeichnung.
object
v3.1
weightDefault
0
Legt einen Standardwert für das Gewicht des Verkehrsmittels in Tonnen fest. 0 bedeutet keine Gewichtsangabe.
string
v3.1
heightDefault
0
Legt einen Standardwert für die Höhe des Verkehrsmittels in Metern fest. 0 bedeutet keine Höhenangabe.
string
v3.1
obstaclesDefault
EMPTY
Legt einen Standardwert für ein zu vermeidendes Gebiet fest.
string
v3.1
warmup
false
Aktiviert eine Routenberechnung mit den Standardwerten beim Start des Providers. Dies kann sinnvoll sein, wenn der Routing-Algorithmus bestimmte Informationen in einem Cache speichert.
boolean
v3.1

Beispiel


extensions:
 - type: ROUTES
   enabled: true
   warmup: true
   fromToQuery:
     driving: 'SELECT id as oid, ST_Distance(${point},the_geom) AS distance FROM v_ways_vertices_pgr WHERE connected and ST_DWithin(${point},the_geom, 0.25) ORDER BY distance ASC LIMIT 1'
   edgesQuery:
     driving: 'SELECT gid as id, source, target, x1, y1, x2, y2, ${cost_column} AS cost, ${reverse_cost_column} AS reverse_cost, maxheight, maxweight FROM v_ways WHERE tag_id NOT IN (113, 114, 115, 116, 117, 118, 119, 120, 122, 201, 202, 203, 204, 301, 302, 303, 304, 305)'
   routeQuery: 'SELECT * from pgr_aStar(${edgesQuery}, ${from_vid}, ${to_vid}, ${height}, ${weight}, ''SELECT gid FROM v_ways WHERE ST_Intersects(the_geom, ${obstacles})'', false, 5, (1+8+16))'
   nativeCrs:
     code: 4326
     forceAxisOrder: LON_LAT
   preferences:
     fastest:
       label: Fastest
       costColumn: cost_s
       reverseCostColumn: reverse_cost_s
     shortest:
       label: Shortest
       costColumn: cost
       reverseCostColumn: reverse_cost
   modes:
     driving: Driving
types:
 route:
   type: OBJECT
   sourcePath: /_route_
   properties:
     id:
       sourcePath: id
       type: INTEGER
       role: ID
     edge:
       sourcePath: edge
       type: INTEGER
     node:
       sourcePath: node
       type: INTEGER
     cost:
       sourcePath: cost
       type: FLOAT
     agg_cost:
       sourcePath: agg_cost
       type: FLOAT
     data:
       type: OBJECT
       sourcePath: '[edge=gid]v_ways{sortKey=gid}'
       properties:
         geometry:
           sourcePath: the_geom
           type: GEOMETRY
           geometryType: LINE_STRING
           role: PRIMARY_GEOMETRY
           forcePolygonCCW: false
         source:
           sourcePath: source
           type: INTEGER
         target:
           sourcePath: target
           type: INTEGER
         type:
           sourcePath: tag_id
           type: STRING
           transformations:
             codelist: wayTag
         #osm_id:
         #  sourcePath: osm_id
         #  type: INTEGER
         length_m:
           sourcePath: length_m
           type: FLOAT
         duration_forward_s:
           sourcePath: cost_s
           type: FLOAT
         duration_backward_s:
           sourcePath: reverse_cost_s
           type: FLOAT
         roadName:
           sourcePath: name
           type: STRING
         oneway:
           sourcePath: oneway
           type: STRING
         maxspeed_forward:
           sourcePath: maxspeed_forward
           type: FLOAT
         maxspeed_backward:
           sourcePath: maxspeed_backward
           type: FLOAT
         maxHeight_m:
           sourcePath: maxheight
           type: FLOAT
         maxWeight_t:
           sourcePath: maxweight
           type: FLOAT
ImpressumDatenschutzerklärung