Changes between Version 43 and Version 55 of Help/Plugin/TurnRestrictions
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Plugin/TurnRestrictions
v43 v55 1 1 [[TranslatedPages]] 2 2 [[PageOutline]] 3 3 4 = Plugin -> Turn Restrictions = 4 [[Image(/pluginicon/turnrestrictions.jar/images/preferences/turnrestrictions.png)]] 5 6 [[Image(source:osm/applications/editors/josm/plugins/turnrestrictions/images/preferences/turnrestrictions.png,48,link=,middle,margin-right=20)]] 5 7 6 8 == Introduction == 7 In 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.9 In OpenStreetMap a **turn restriction** limits navigation options. It represents the restriction that one cannot navigate from a [wikitr:/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. 8 10 9 [[Image(only_left_turn_sample.png)]] 11 [[Image(only_left_turn_sample.png,link=)]] 10 12 11 The {{{turnrestrictions}}}plugin supports editing of turn restrictions. It consists of two major components:13 The ''**turnrestrictions**'' plugin supports editing of turn restrictions. It consists of two major components: 12 14 13 1. '''Turn Restriction Toggle Dialog''' - the turn restrictions toggle dialog is displayed on the right in the Toggle Dialogs Section. It displays the list of turn restrictions in the current data set and allows to create or delete turn restrictions, or to launch the Turn Restriction Editor to edit a turn restriction. 15 1. **Turn Restriction Panel** - the turn restrictions panel is displayed on the right in sidebar. It displays the list of turn restrictions in the current data set and allows to create or delete turn restrictions, or to launch the Turn Restriction Editor to edit a turn restriction. 16 1. **Turn Restriction Editor (`Alt+Shift+2`)** - the Turn Restriction Editor is a special purpose editor for turn restrictions. 14 17 15 2. '''Turn Restriction Editor''' - the Turn Restriction Editor is a special purpose editor for turn restrictions.16 18 17 19 == Tagging model == 18 20 Turn restrictions a standard map feature decribed on the [osmwiki:Relation:restriction OSM wiki]. 19 21 20 Technically, a turn restriction is an OSM [wiki:/Help/Concepts/Object#Relations relation]. A turn restriction 22 Technically, a turn restriction is an OSM [wikitr:/Help/Concepts/Object#Relations relation]. A turn restriction 21 23 22 * must have a relation member with role '''{{{from}}}'''referring to a [wiki:/Help/Concepts/Object#Ways way]. We call this way the'''''from'''''-'''way'''.23 * must have a relation member with role '''{{{to}}}'''referring to a [wiki:/Help/Concepts/Object#Ways way]. We call this way the'''''to'''''-'''way'''.24 * must have at least o f relation member with role {{{via}}} referring to a [wiki:Concepts/Object#Nodes node] or [wiki:/Help/Concepts/Object#Ways way]. We call these objects'''''via'''''-'''object'''.24 * must have a relation member with role **`from`** referring to a [wikitr:/Help/Concepts/Object#Ways way]. We call this way the **''from**''-**way**. 25 * must have a relation member with role **`to`** referring to a [wikitr:/Help/Concepts/Object#Ways way]. We call this way the **''to**''-**way**. 26 * must have at least one relation member with role `via` referring to a [wikitr:/Help/Concepts/Object#Nodes node] or [wikitr:/Help/Concepts/Object#Ways way]. We call these objects **''via**''-**object**. 25 27 26 {{{ 27 #!comment 28 *************************************************************************************************************************** 29 }}} 28 30 29 == Use Cases == 31 30 === Creating a turn restriction ===#CreateANewTurnRestriction 32 There are several possibilities to create a new turn restriction. First, you can lauch the Turn Restriction Editor for a new turn restriction from the Turn Restriction Toggle Dialog:33 1. Click on [[ Image(source:/trunk/images/new.png,20)]] in the Turn RestrictionToggle Dialog. Alternatively, select [[Image(source:/trunk/images/new.png,20)]]'''New'''from the popup menu.31 There are several possibilities to create a new turn restriction. First, you can lauch the Turn Restriction Editor for a new turn restriction from the Turn Restriction Panel: 32 1. Click on [[JOSMImage(new,link=,24,middle)]] in the Turn Restriction Panel. Alternatively, select [[JOSMImage(new,link=,24,middle)]] **New** from the popup menu. 34 33 35 34 Alternatively, you can launch a new editor with a keyboard shortcut: 36 1. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is '''{{{Ctrl+Shift+T}}}'''.35 1. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is **`Alt+Shift+2`**. 37 36 1. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up. 38 37 39 [[Image(create-turn-restriction-popup.png )]] [[BR]]40 Just click on [[Image(source:/trunk/images/new.png,20)]] '''Create new turn restriction''' to launch the turn restriction editor for a new turn restriction. Alternatively, press the key '''{{{N}}}''' or hit '''{{{Enter}}}'''.38 [[Image(create-turn-restriction-popup.png,link=)]] \\ 39 Just click on [[JOSMImage(new,link=,24,middle)]] **Create new turn restriction** to launch the turn restriction editor for a new turn restriction. Alternatively, press the key **`N`** or hit **`Enter`**. 41 40 42 In 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 1. The last selected way in the JOSM selection becomes the '''''to'''''-way45 1. If the '''''from'''''- and'''''to'''''-way have a node in common, this node becomes a ''via''-object.41 In both cases, the ''turnrestrictions'' plugin initializes the new turn restriction with objects from the current JOSM selection: 42 1. The first selected way in the JOSM selection becomes the **''from**''-way. 43 1. The last selected way in the JOSM selection becomes the **''to**''-way 44 1. If the **''from**''- and **''to**''-way have a node in common, this node becomes a ''via''-object. 46 45 47 46 A fast way to create a turn restriction is therefore to 48 1. Select the '''''from'''''- and'''''to'''''-way in JOSM49 1. Press '''{{{Ctrl+Shift+T}}}'''47 1. Select the **''from**''- and **''to**''-way in JOSM 48 1. Press **`Alt+Shift+2`** 50 49 1. Choose the type of the turn restriction and save it. 51 50 52 51 === Editing a turn restriction === #EditingATurnRestriction 53 There 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 Dialog55 1. 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.52 There 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 Panel: 53 1. Select a turn restriction in the Turn Restriction Panel 54 1. Click on [[JOSMImage(dialogs/edit,link=,24,middle)]]. Alternatively, select [[JOSMImage(dialogs/edit,link=,24,middle)]] **Edit** from the popup menu. 56 55 57 56 Second, you can launch a new editor with a keyboard shortcut: 58 1. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is '''{{{Ctrl+Shift+T}}}'''.57 1. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is **`Alt+Shift+2`**. 59 58 1. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up. 60 59 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.60 [[Image(create-turn-restriction-popup.png,link=)]] \\ 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. 63 62 64 63 A fast way to edit a turn restriction is therefore to 65 1. Select the '''''from'''''- or'''''to'''''-way in JOSM66 1. Press '''{{{Ctrl+Shift+T}}}'''67 1. Type '''{{{1}}}'''to lauch the Turn Restriction Editor64 1. Select the **''from**''- or **''to**''-way in JOSM 65 1. Press **`Alt+Shift+2`** 66 1. Type **`1`** to launch the Turn Restriction Editor 68 67 69 68 === Deleting a turn restriction === 70 There are several possible ways to delete a turn restriction. First, you can delete it in the Turn Restriction Toggle Dialog:71 1. Select a turn restriction in the Turn Restriction Toggle Dialog72 1. 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.69 There are several possible ways to delete a turn restriction. First, you can delete it in the Turn Restriction Panel: 70 1. Select a turn restriction in the Turn Restriction Panel 71 1. Press **`DEL`** or click on [[JOSMImage(dialogs/delete,link=,24,middle)]]. Alternatively, select [[JOSMImage(dialogs/delete,link=,24,middle)]] **Delete** from the popup menu. 73 72 74 Alternatively, you can [#EditingATurnRestriction launch a Turn Restriction Editor] and click on [[Image(source:/trunk/images/dialogs/delete.png)]] in its toolbar. 75 {{{ 76 #!comment 77 ********************************************************************************************* 78 Turn Restriction Toggle Dialog 79 ********************************************************************************************* 80 }}} 81 == Turn Restriction Toggle Dialog == #TurnRestrictionToggleDialog 82 The Turn Restriction Toggle Dialog helps you to keep track of the turn restrictions in the current edit layer. 73 Alternatively, you can [#EditingATurnRestriction launch a Turn Restriction Editor] and click on [[JOSMImage(dialogs/delete,link=,24,middle)]] in its toolbar. 83 74 84 Here's a screenshot of the toggle dialog and its popup menu:[[br]]85 [[Image(toggle-dialog-screenshot.png)]]86 75 87 If you tick the checkbox '''Only participating in selection''' the dialog displays only turn restrictions in which objects from the current selection are participating. If the checkbox isn't selected, then all turn restrictions in the current edit layer are displayed. 76 == Turn Restriction Panel == #TurnRestrictionPanel 77 [=#TurnRestrictionToggleDialog] 78 The Turn Restriction Panel helps you to keep track of the turn restrictions in the current edit layer. 79 80 Here's a screenshot of the panel and its popup menu: \\ 81 [[Image(toggle-dialog-screenshot.png,link=)]] 82 83 If you tick the checkbox **Only participating in selection** the dialog displays only turn restrictions in which objects from the current selection are participating. If the checkbox isn't selected, then all turn restrictions in the current edit layer are displayed. 88 84 89 85 You can apply some commands to the turn restrictions displayed in this dialog. 90 ||'''Create''' a new turn restriction||Click [[Image(source:/trunk/images/new.png,15)]] or select [[Image(source:/trunk/images/new.png,15)]]'''New''' from the popup menu|| 91 ||'''Edit''' a turn restriction||Select the turn restriction and click [[Image(source:/trunk/images/dialogs/edit.png,15)]] or select [[Image(source:/trunk/images/dialogs/edit.png,15)]]'''Edit''' from the popup menu|| 92 ||'''Delete''' a turn restriction||Select one or more turn restrictions, press '''{{{DEL}}}''', or click on [[Image(source:/trunk/images/dialogs/delete.png,15)]] or select [[Image(source:/trunk/images/dialogs/delete.png,15)]]'''Delete''' from the popup menu.|| 93 ||'''Select''' the turn restriction||In order to select the turn restriction and its members in the current edit layer, first select the turn restriction in the list and then select [[Image(source:/trunk/images/selectall.svg,15)]]'''Select in current data layer''' from the popup menu.|| 94 ||'''Zoom''' to the turn restriction||Select the turn restriction in the list and then select [[Image(source:/trunk/images/dialogs/autoscale/selection.png,15)]]'''Zoom to''' from the popup menu.|| 86 ||=**Command**=||=**Description**=|| 87 ||**Create** a new turn restriction||Click [[JOSMImage(new,link=,24,middle)]] or select [[JOSMImage(new,link=,24,middle)]] **New** from the popup menu.|| 88 ||**Edit** a turn restriction||Select the turn restriction and click [[JOSMImage(dialogs/edit,link=,24,middle)]] or select [[JOSMImage(dialogs/edit,link=,24,middle)]] **Edit** from the popup menu.|| 89 ||**Delete** a turn restriction||Select one or more turn restrictions, press **`DEL`**, or click on [[JOSMImage(dialogs/delete,link=,24,middle)]] or select [[JOSMImage(dialogs/delete,link=,24,middle)]] **Delete** from the popup menu.|| 90 ||**Select** the turn restriction||In order to select the turn restriction and its members in the current edit layer, first select the turn restriction in the list and then select [[JOSMImage(selectall,link=,24,middle)]] **Select in current data layer** from the popup menu.|| 91 ||**Zoom** to the turn restriction||Select the turn restriction in the list and then select [[JOSMImage(dialogs/autoscale/selection,link=,24,middle)]] **Zoom to** from the popup menu.|| 95 92 96 {{{ 97 #!comment 98 ********************************************************************************************* 99 Turn Restriction Editor 100 ********************************************************************************************* 101 }}} 93 102 94 == Turn Restriction Editor ==#TurnRestrictionEditor 103 95 The Turn Restriction Editor allows you to create and edit turn restriction. It provides two user interfaces: 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.96 * a **Basic Editor**. This is a special purpose user interface for editing the properties of a turn restriction. 97 * an **Advanced Editor**. This is a generic user interface for editing the raw data elements of the OSM relation which represents a turn restriction. 106 98 107 99 You 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. 108 100 109 101 === Basic Editor === #BasicEditor 110 The Basic Editor allows you to set the '''''from'''''-way, the'''''to'''''-way, and exceptions to the turn restriction for a selection of vehicle types.102 The Basic Editor allows you to set the **''from**''-way, the **''to**''-way, and exceptions to the turn restriction for a selection of vehicle types. 111 103 112 In order to set the '''''from'''''-way104 In order to set the **''from**''-way 113 105 1. Select a way in the current edit layer 114 1. '''Drag'''it from the list of selected objects (on the left in the editor) onto the input field'''From:'''106 1. **Drag** it from the list of selected objects (on the left in the editor) onto the input field **From:** 115 107 116 108 Alternatively, you can 117 109 1. Select a way in the current edit layer 118 1. Copy it (using '''{{{Ctrl+C}}}''' or [[Image(source:/trunk/images/copy.png,20)]]'''Copy'''in the popup menu) in the list of selected objects on the right of the Turn Restriction Editor119 1. 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)110 1. Copy it (using **`Ctrl+C`** or [[JOSMImage(copy,link=,24,middle)]] **Copy** in the popup menu) in the list of selected objects on the right of the Turn Restriction Editor 111 1. Click on the **From:** field and paste the copied way (using **`Ctrl+V`** or [[JOSMImage(paste,link=,24,middle)]] **Paste** from the popup menu) 120 112 121 [[Image(sample-screen-shot-1.png)]] 113 [[Image(sample-screen-shot-1.png,link=)]] 122 114 123 115 In 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. … … 125 117 The following screen shot shows the Basic Editor configured to display/edit ''via''-objects too. 126 118 127 [[Image(basic-editor-with-vias.png)]] 119 [[Image(basic-editor-with-vias.png,link=)]] 128 120 129 121 === Advanced Editor === #AdvancedEditor 130 122 The 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. 131 123 132 [[Image(sample-screen-shot-2.png)]] 124 [[Image(sample-screen-shot-2.png,link=)]] 133 125 134 126 ==== Editing the tags ==== 135 127 In 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: 136 128 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]. 141 129 * `type=restriction` - this is a required tag for a turn restriction. 130 * `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]. 131 * `except=...` - 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]. 132 * (`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].) **''Deprecated, please use [osmwiki:/Conditional_restrictions conditional restrictions] instead.''** 142 133 143 134 ==== Editing the members ==== 144 In the lower half of the Advanced Editor you can edit the membersof the turn restriction relation.135 In the lower half of the Advanced Editor you can edit the [osmwiki:Relation:restriction#Members members] of the turn restriction relation. 145 136 146 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 [osmwiki:Relation:restriction OSM wiki]).137 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''-objects. (The role `location_hint` is deprecated as it is not verifiable on the ground). 147 138 148 139 To add members just drag-and-drop or copy/paste objects from the JOSM selection view on the right to the list of relation members. 149 140 150 You can '''reorder'''the relation members:141 You can **reorder** the relation members: 151 142 1. Select one or more members 152 1. Press '''Alt-Up'''to move them up by one position. Alternatively you can select'''Move up'''from the popup menu.143 1. Press **Alt-Up** to move them up by one position. Alternatively you can select **Move up** from the popup menu. 153 144 154 Press '''Alt-Down'''to move them down by one position. Alternatively you can select'''Move down'''from the popup menu.145 Press **Alt-Down** to move them down by one position. Alternatively you can select **Move down** from the popup menu. 155 146 156 147 To edit the role of a relation member 157 148 1. Double-click on the table cell with the role 158 1. Edit the role and press '''ENTER'''149 1. Edit the role and press **ENTER** 159 150 160 151 === Resolving Errors and Warnings === #ErrorsAndWarnings 161 [[Image(sample-screen-shot-3.png)]] 152 [[Image(sample-screen-shot-3.png,link=)]] 162 153 163 {{{ 164 #!comment 165 ***************************************************************************************************** 166 }}} 154 167 155 == Preferences ==#Preferences 168 156 To launch the preferences panel for the turnrestrictions plugin: 169 157 170 1. Click on [[ Image(source:/trunk/images/preference.png)]] in the JOSM toolbar or press'''{{{F10}}}'''.171 1. Click on [[Image( osm:source:applications/editors/josm/plugins/turnrestrictions/images/preferences/turnrestrictions.png,20)]] to display the preferences panel for the turnrestrictions plugin158 1. Click on [[JOSMImage(preference)]] in the JOSM toolbar or press **`F10`**. 159 1. Click on [[Image(source:osm/applications/editors/josm/plugins/turnrestrictions/images/preferences/turnrestrictions.png,24,link=,middle)]] to display the preferences panel for the turnrestrictions plugin 172 160 173 [[Image(preferences- screen-shot.png)]]161 [[Image(ticket:21243:preferences-withoutShortCut.png,link=)]] 174 162 175 163 === Select icon set for road signs === … … 182 170 You can override the standard setting, though. If you tick the respective checkbox in the preferences (see screen shot above) the list of via-objects is displayed in the Basic Editor too. 183 171 184 === Configure shortcut for creating/editing a turn restriction ===185 In the preference dialog you can also configure the shortcut to create/edit a turn restriction. The default shortcut is '''{{{Ctrl+Shift+T}}}''' but you can change it to whatever shortcut you like.186 187 Be careful not to override already defined shortcuts, though. For instance, '''{{{Ctrl+S}}}''' is the defined shortcut for '''Save to file'''. If you set the turn restrictions shortcut to '''{{{Ctrl+S}}}''', then pressing '''{{{Ctrl+S}}}''' won't save the current layer any more. The turn restriction editor is launched instead.188 172 189 173 == See also == 174 * [osmwiki:JOSM/Plugins/turnrestrictions Turnrestriction Plugin page] - Historic reference, development of this plugin in 2010-03 was sponsored by [https://www.skobbler.de/ skobbler GmbH] 190 175 191 * [https://wiki.openstreetmap.org/wiki/JOSM/Plugins/turnrestrictions Turnrestriction Plugin page] - Historic reference, development of this plugin in 2010-03 was sponsored by [http://www.skobbler.de/ skobbler GmbH]192 176 193 177 ---- 194 Back to [wiki:/Plugins#JOSMdocu Plugin Help] [[BR]]195 Back to [wiki:/Help Main Help] 178 Back to [wikitr:/Plugins#JOSMdocu Plugin Help] \\ 179 Back to [wikitr:/Help Main Help]
