Changes between Version 35 and Version 36 of Help/Plugin/TurnRestrictions


Ignore:
Timestamp:
2014-10-23T19:56:59+02:00 (11 years ago)
Author:
skyper
Comment:

interwiki links + layout

Legend:

Unmodified
Added
Removed
Modified

  • Help/Plugin/TurnRestrictions

    v35 v36  
    77In OpenStreetMap a '''turn restriction''' limits navigation options. It represents the restriction that one cannot navigate from a [wiki:/Help/Concepts/Object#Ways way] to another way. For instance, the turn restriction depicted below forbids to drive straight. Vehicles have to turn left at the junction where the two ways meet (the so called via-node). Turn restrictions are important for routing and navigation software which are based on OSM data. 
    88
    9 [[Image(only_left_turn_sample.png)]][[BR]]
     9[[Image(only_left_turn_sample.png)]]
    1010
    1111The {{{turnrestrictions}}} plugin supports editing of turn restrictions. It consists of two major components:
    … …  
    1616
    1717== Terminology ==
    18 Turn restrictions a standard map feature decribed on the [http://wiki.openstreetmap.org/wiki/Relation:restriction OSM wiki].
     18Turn restrictions a standard map feature decribed on the [osmwiki:Relation:restriction OSM wiki].
    1919
    2020Technically, a turn restriction is an OSM [wiki:/Help/Concepts/Object#Relations relation]. A turn restriction
    … …  
    3434
    3535Alternatively, you can launch a new editor with a keyboard shortcut:
    36  1. Press the shortcut for creating or editing a turn restriction. On most plattforms the shortcut is '''{{{Ctrl+Shift+T}}}'''.
    37  2. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up.
     361. Press the shortcut for creating or editing a turn restriction. On most plattforms the shortcut is '''{{{Ctrl+Shift+T}}}'''.
     371. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up.
    3838 
    3939 [[Image(create-turn-restriction-popup.png)]] [[BR]]
    … …  
    4141
    4242In both cases, the {{{turnrestrictions}}} plugin initializes the new turn restriction with objects from the current JOSM selection:
    43  1. The first selected way in the JOSM selection becomes the '''''from'''''-way.
    44  2. The last selected way in the JOSM selection becomes the '''''to'''''-way
    45  3. If the '''''from'''''- and '''''to'''''-way have a node in common, this node becomes a ''via''-object.
     431. The first selected way in the JOSM selection becomes the '''''from'''''-way.
     441. The last selected way in the JOSM selection becomes the '''''to'''''-way
     451. If the '''''from'''''- and '''''to'''''-way have a node in common, this node becomes a ''via''-object.
    4646
    4747A fast way to create a turn restriction is therefore to
    48  1. Select the '''''from'''''- and '''''to'''''-way in JOSM
    49  2. Press '''{{{Ctrl+Shift+T}}}'''
    50  3. Choose the type of the turn restriction and save it.   
     481. Select the '''''from'''''- and '''''to'''''-way in JOSM
     491. Press '''{{{Ctrl+Shift+T}}}'''
     501. Choose the type of the turn restriction and save it.   
    5151   
    5252=== Editing a turn restriction === #EditingATurnRestriction
    5353There are several possible ways to launch a Turn Restriction Editor in order to edit a turn restriction. First, you can lauch the Turn Restriction Editor for an existing turn restriction from the Turn Restriction Toggle Dialog:
    54  1. Select a turn restriction in the Turn Restriction Toggle Dialog
    55  2. Click on [[Image(source:/trunk/images/dialogs/edit.png,20)]]. Alternatively, select [[Image(source:/trunk/images/dialogs/edit.png,20)]]'''Edit''' from the popup menu.
     541. Select a turn restriction in the Turn Restriction Toggle Dialog
     551. Click on [[Image(source:/trunk/images/dialogs/edit.png,20)]]. Alternatively, select [[Image(source:/trunk/images/dialogs/edit.png,20)]]'''Edit''' from the popup menu.
    5656
    5757Second, you can launch a new editor with a keyboard shortcut:
    58  1. Press the shortcut for creating or editing a turn restriction. On most plattforms the shortcut is '''{{{Ctrl+Shift+T}}}'''.
    59  2. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up.[[BR]]
    60     [[Image(create-turn-restriction-popup.png)]] [[BR]]
    61     Just double-click on the turn restriction you want to edit. Alternatively, for the top 9 turn restrictions displayed in the popup window you can use the shortcuts '''1''' to '''9''' to launch the Turn Restriction Editor. In the example above, you would press '''1''' to start editing.
     581. Press the shortcut for creating or editing a turn restriction. On most plattforms the shortcut is '''{{{Ctrl+Shift+T}}}'''.
     591. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up.
     60
     61 [[Image(create-turn-restriction-popup.png)]] [[BR]]
     62 Just double-click on the turn restriction you want to edit. Alternatively, for the top 9 turn restrictions displayed in the popup window you can use the shortcuts '''1''' to '''9''' to launch the Turn Restriction Editor. In the example above, you would press '''1''' to start editing.
    6263
    6364A fast way to edit a turn restriction is therefore to
    64  1. Select the '''''from'''''- or '''''to'''''-way in JOSM
    65  2. Press '''{{{Ctrl+Shift+T}}}'''
    66  3. Type '''{{{1}}}''' to lauch the Turn Restriction Editor
     651. Select the '''''from'''''- or '''''to'''''-way in JOSM
     661. Press '''{{{Ctrl+Shift+T}}}'''
     671. Type '''{{{1}}}''' to lauch the Turn Restriction Editor
    6768 
    6869=== Deleting a turn restriction ===
    6970There are several possible ways to delete a turn restriction. First, you can delete it in the Turn Restriction Toggle Dialog:
    70  1. Select a turn restriction in the Turn Restriction Toggle Dialog
    71  2. Press '''{{{DEL}}}''' or click on [[Image(source:/trunk/images/dialogs/delete.png,20)]]. Alternatively, select [[Image(source:/trunk/images/dialogs/delete.png,20)]]'''Delete''' from the popup menu.
     711. Select a turn restriction in the Turn Restriction Toggle Dialog
     721. Press '''{{{DEL}}}''' or click on [[Image(source:/trunk/images/dialogs/delete.png,20)]]. Alternatively, select [[Image(source:/trunk/images/dialogs/delete.png,20)]]'''Delete''' from the popup menu.
    7273
    7374Alternatively, you can [#EditingATurnRestriction launch a Turn Restriction Editor] and click on  [[Image(source:/trunk/images/dialogs/delete.png)]] in its toolbar.
    … …  
    101102== Turn Restriction Editor ==#TurnRestrictionEditor
    102103The Turn Restriction Editor allows you to create and edit turn restriction. It provides two user interfaces:
    103  * a '''Basic Editor'''. This is a special purpose user interface for editing the properties of a turn restriction.
    104  * an '''Advanced Editor'''. This is a generic user interface for editing the raw data elements of the OSM relation which represents a turn restriction.
     104* a '''Basic Editor'''. This is a special purpose user interface for editing the properties of a turn restriction.
     105* an '''Advanced Editor'''. This is a generic user interface for editing the raw data elements of the OSM relation which represents a turn restriction.
    105106
    106107You can use either of these user interfaces. Regardless of whether you use the Basic Editor or the Advanced Editor you should make sure that the resulting turn restriction is valid. The turn restriction editor checks the turn restriction and shows error messages and warnings in a third user interface, i.e. the list of issues.
    … …  
    110111
    111112In order to set the '''''from'''''-way
    112  1. Select a way in the current edit layer
    113  2. '''Drag''' it from the list of selcted objects (on the left in the editor) onto the input field '''From:'''
     1131. Select a way in the current edit layer
     1141. '''Drag''' it from the list of selcted objects (on the left in the editor) onto the input field '''From:'''
    114115
    115116Alternatively, you can
    116  1. Select a way in the current edit layer
    117  2. Copy  it (using '''{{{Ctrl+C}}}''' or [[Image(source:/trunk/images/copy.png,20)]]'''Copy''' in the popup menu) in the list of selcted objects on the right of the Turn Restriction Editor
    118  3. Click on the '''From:''' field and paste the copied way (using '''{{{Ctrl+V}}}''' or [[Image(source:/trunk/images/paste.png,20)]]'''Paste''' from the popup menu)
     1171. Select a way in the current edit layer
     1181. Copy  it (using '''{{{Ctrl+C}}}''' or [[Image(source:/trunk/images/copy.png,20)]]'''Copy''' in the popup menu) in the list of selcted objects on the right of the Turn Restriction Editor
     1191. Click on the '''From:''' field and paste the copied way (using '''{{{Ctrl+V}}}''' or [[Image(source:/trunk/images/paste.png,20)]]'''Paste''' from the popup menu)
    119120
    120 [[Image(sample-screen-shot-1.png)]][[br]]
     121[[Image(sample-screen-shot-1.png)]]
    121122
    122123In the standard configuration,  ''via''-objects aren't displayed in the Basic Editor. You have to switch to the [#AdvancedEditor Advanced Editor] to edit them. In the preferences for  the turnrestrictions plugin you can change the default configuration, though. [#Preferences Launch the preference dialog] and [#ToggleEditingOfViaObjects enable displaying/editing of via-objects] in the Basic Editor.
    … …  
    124125The following screen shot shows the Basic Editor configured to display/edit ''via''-objects too.
    125126
    126 [[Image(basic-editor-with-vias.png)]][[BR]]
     127[[Image(basic-editor-with-vias.png)]]
    127128
    128129=== Advanced Editor === #AdvancedEditor
    129130The Advanced Editor allows you to edit the raw OSM data, i.e. the tags and the relation members of the relation representing the turn restriction.
    130131
    131 [[Image(sample-screen-shot-2.png)]][[br]]
     132[[Image(sample-screen-shot-2.png)]]
    132133
    133134==== Editing the tags ====
    134135In the upper half of the Advanced Editor you can edit the tags of the turn restriction. You can add tags with arbitrary keys and values but please note that some tags have a special meaning in turn restrictions:
    135136
    136   * {{{type=restriction}}}  - this is a required tag for a turn restriction.
    137   * {{{restriction=...}}}   - the value of this tag should be one of the [http://wiki.openstreetmap.org/wiki/Relation:restriction supported types for turn restrictions]. Instead of editing the raw tag value you can also select a restriction type from the drop-down box in the [#BasicEditor Basic Editor].
    138   * {{{exception=...}}} -  the value of this tag should be a set of [http://wiki.openstreetmap.org/wiki/Relation:restriction supported vehicle types]. Instead of editing the raw tag value you can also tick the respective vehicle types in the [#BasicEditor Basic Editor].
    139   * {{{day_on=...}}}, {{{day_off=...}}}, {{{hour_on=...}}} and {{{hour_off=...}}} can be used to specify when a turn restriction is actually in place, refer to the [http://wiki.openstreetmap.org/wiki/Relation:restriction OSM wiki for more information].
     137* {{{type=restriction}}}  - this is a required tag for a turn restriction.
     138* {{{restriction=...}}}   - the value of this tag should be one of the [osmwiki:Relation:restriction supported types for turn restrictions]. Instead of editing the raw tag value you can also select a restriction type from the drop-down box in the [#BasicEditor Basic Editor].
     139* {{{exception=...}}} -  the value of this tag should be a set of [osmwiki:Relation:restriction supported vehicle types]. Instead of editing the raw tag value you can also tick the respective vehicle types in the [#BasicEditor Basic Editor].
     140* {{{day_on=...}}}, {{{day_off=...}}}, {{{hour_on=...}}} and {{{hour_off=...}}} can be used to specify when a turn restriction is actually in place, refer to the [osmwiki:Relation:restriction OSM wiki for more information].
    140141
    141142
    … …  
    143144In the lower half of the Advanced Editor you can edit the members of the turn restriction relation.
    144145
    145 In addition to the ''from''-way and the ''to''-way, which you can edit in the  [#BasicEditor Basic Editor] too, you can also enter ''via''-object and a node with role {{{location_hint}}} (see  [http://wiki.openstreetmap.org/wiki/Relation:restriction OSM wiki]).
     146In addition to the ''from''-way and the ''to''-way, which you can edit in the  [#BasicEditor Basic Editor] too, you can also enter ''via''-object and a node with role {{{location_hint}}} (see  [osmwiki:Relation:restriction OSM wiki]).
    146147
    147148To add members just drag-and-drop or copy/paste objects from the JOSM selection view on the right to the list of relation members.
    148149
    149150You can '''reorder''' the relation members:
    150   1. Select one or more members
    151   2. Press '''Alt-Up''' to move them up by one position. Alternatively you can select '''Move up''' from the popup menu.[[BR]]
    152      Press '''Alt-Down''' to move them down by one position. Alternatively you can select '''Move down''' from the popup menu.
     1511. Select one or more members
     1521. Press '''Alt-Up''' to move them up by one position. Alternatively you can select '''Move up''' from the popup menu.
     153
     154 Press '''Alt-Down''' to move them down by one position. Alternatively you can select '''Move down''' from the popup menu.
    153155
    154156To edit the role of a relation member
    155   1. Double-click on the table cell with the role
    156   2. Edit the role and press '''ENTER'''
     1571. Double-click on the table cell with the role
     1581. Edit the role and press '''ENTER'''
    157159
    158160=== Resolving Errors and Warnings === #ErrorsAndWarnings
    159 [[Image(sample-screen-shot-3.png)]][[br]]
     161[[Image(sample-screen-shot-3.png)]]
    160162
    161163{{{
    … …  
    166168To launch the preferences panel for the turnrestrictions plugin:
    167169
    168  1. Click on [[Image(source:/trunk/images/preference.png)]] in the JOSM toolbar or press '''{{{F10}}}'''.
    169  2. Click on [[Image(osm:source:applications/editors/josm/plugins/turnrestrictions/images/preferences/turnrestrictions.png,20)]] to display the preferences panel for the turnrestrictions plugin
     1701. Click on [[Image(source:/trunk/images/preference.png)]] in the JOSM toolbar or press '''{{{F10}}}'''.
     1711. Click on [[Image(osm:source:applications/editors/josm/plugins/turnrestrictions/images/preferences/turnrestrictions.png,20)]] to display the preferences panel for the turnrestrictions plugin
    170172
    171 [[Image(preferences-screen-shot.png)]] [[BR]]
     173[[Image(preferences-screen-shot.png)]]
    172174
    173175=== Select icon set for road signs ===