Segment length: Difference between revisions Discussion View history

m (Text replacement - "Category:Style guide " to "Category:Style guides")
 
(22 intermediate revisions by 7 users not shown)
Line 1: Line 1:
When creating a segment, it is important to ensure that any individual segment is longer than 5 meters or about 15 feet. It is less important to keep segments under any particular length, but there are drawbacks to long segments discussed below.
When creating a segment, it is important to ensure that any individual segment is at least {{:Segment length/Minimum}}. It is less important to keep segments under any particular length, but there are drawbacks to long segments discussed below.


==Length issues==
=={{anchor|Length issues}}Determine the length==
===Too short===
When a segment is too short (less than 5 meters) it becomes difficult for the navigation engine to determine traffic speed through that segment. That will in turn negatively affect drive time estimations and best routing.


====Between intersections====
The length of a segment can be determined after it is created '''and saved''' by selecting it and looking at the general tab with the segment selected. The length will be displayed toward the bottom of the tab in feet or miles (using the [[Map_Editor_Interface_and_Controls#Imperial|imperial unit setting in WME]]) or meters or kilometers (using the [[Map_Editor_Interface_and_Controls#Metric|metric unit setting in WME]]). The length does not appear before it is saved.
[[File:Mismatched_Intersection.png|200px|right]]There may be times when driveways or other roads join a main road with close proximity to each other. This may cause small segments to be created between the two junctions along that main road. If the segment is shorter than the minimum length, it may be best to simply merge the two intersections into a single junction. It is OK if the joining roads in the map do not exactly align with the visual map in the Waze Map Editor.
{{mbox
| type = info
| text = The displayed length for both imperial and metric settings is based on a rounded metric number and does not reflect the actual segment length. However, a developer in the Waze editing community has developed a script called [[Scripts/WME True Segment Length|WME True Segment Length]]. This script will display the true length of the segment in both metric and imperial units with two decimal places of accuracy. Unfortunately, that display is not really important since the server only considers the rounded metric values.}}
 
==Too short==
When a segment is less than {{:Segment length/Minimum}} it becomes difficult for the navigation engine to determine traffic speed through that segment. That will in turn negatively affect drive time estimations and best routing.
 
===Between intersections===
[[File:Mismatched_Intersection.png|200px|right]]There may be times when driveways or other roads join a main road with close proximity to each other. This may cause small segments to be created between the two junctions along that main road. If the segment is shorter than {{:Segment length/Minimum}}, it may be best to simply merge the two intersections into a single junction. It is OK if the joining roads in the map do not exactly align with the visual map in the Waze Map Editor.


See the [[Junction Style Guide#Offset Roads|Junction Style Guide section on offset roads]] for more details about this situation.
See the [[Junction Style Guide#Offset Roads|Junction Style Guide section on offset roads]] for more details about this situation.
{{Clear}}
{{Clear}}
===Too long===
There are no system operation issues that require limiting the length of a segment, but there are a number of reasons that would make things better by limited the length.


A segment should not have [[unnecessary junctions]], but some two-segment junctions may be present for the following reasons:
=== {{anchor|Fixing short segments}}Necessary short segments===


* Long roadways or railroads with the city name present will cause a [[smudged city]] issue on the [[Map_Editor_Interface_and_Controls#Cities|city layer]].
There are a few instances where a single short segment may be present between two other segments with no other segments at those junctions. Sometimes these junctions are necessary and should not be removed. These include:
* Segments that extend outside of an editor's [[Waze_Map_Editor#Editable_Area|editable area]] cannot be modified in any way. Keeping roads shorter than 10,000 meters reduces the chances of editors running into more roads with this restriction.
{{:Necessary junctions}}
* Long segments require more resources in the client and WME when rendering them on screen.
* At one time there were issues surrounding segments over 10,000 meters. The junction may be present due to this reason alone.


==Determine the length==
In the above cases, the segment is necessary so it cannot be deleted, but it can be made at least the minimum length and still meet the needs of the original purpose.<!--
--
*******************************************
Review in the forums if stubs should be noted here.
*******************************************
-->


The length of a segment can be determined after it is created '''and saved''' by selecting it and looking at the general tab with the segment selected. The length will be displayed toward the bottom of the tab in meters. The length does not appear before it is saved.
==Too long==
Segments longer than about 62 miles (100 km) cannot be saved. In addition, there are several good reasons to keep segments shorter than 6.2 miles (10 km):


==Fixing short segments==
* Long roadways or railroads with the city name present will cause a [[smudged city]] issue on the [[Map_Editor_Interface_and_Controls#Cities|city layer]].
 
* Long segments require more resources in the client and WME to render on the screen.
There are a few instances where a single short segment may be present between two other segments with no other segments at those junctions.
* Loop roads. A single segment cannot loop back upon itself, so a junction is required to create two separate segments. It does not matter where the junction is located, so long as each segment meets the minimum segment length.
* Road, city, or state name change. There are times when a road, city, or state name will change with no other intersecting road at that point. A junction is added to enable each side of the junction to have a different name.  
* Ramp or freeway splits. There are cases where a freeway may split into two separate freeways. In order to provide navigation to drivers, it may be necessary to create short segments on the freeway to show the two different road names at the split. Under certain situations it may be best to make the segments as short as possible. This is covered in detail in the [[Junction_Style_Guide#Highway.2FFreeway_Splits|Junction Style Guide]].


In the above cases, the segment is necessary so it cannot be deleted, but it can be made the minimum length and still meet the needs of the original purpose.
===Fixing long segments===
Simply [[Creating_and_editing_road_segments#Cut_a_segment_to_create_a_new_junction|cut the segment]] to add one or more [[Glossary#Junction|junction point]]s. Each resulting segment should be shorter than the maximum length and longer than the minimum length.


==Fixing long segments==
[[Category:Style guides]][[Category:Waze Map Editor]]
Simply add a [[Glossary#Junction_or_Junction_Point|junction point]] along the segment length which will result in the two segments being less than the recommended length. If the segment is more than two times longer than the maximum, then consider adding two (or more) additional junction points.

Latest revision as of 06:25, 14 August 2022

When creating a segment, it is important to ensure that any individual segment is at least 19.69 ft (6 m). It is less important to keep segments under any particular length, but there are drawbacks to long segments discussed below.

Determine the length

The length of a segment can be determined after it is created and saved by selecting it and looking at the general tab with the segment selected. The length will be displayed toward the bottom of the tab in feet or miles (using the imperial unit setting in WME) or meters or kilometers (using the metric unit setting in WME). The length does not appear before it is saved.

The displayed length for both imperial and metric settings is based on a rounded metric number and does not reflect the actual segment length. However, a developer in the Waze editing community has developed a script called WME True Segment Length. This script will display the true length of the segment in both metric and imperial units with two decimal places of accuracy. Unfortunately, that display is not really important since the server only considers the rounded metric values.

Too short

When a segment is less than 19.69 ft (6 m) it becomes difficult for the navigation engine to determine traffic speed through that segment. That will in turn negatively affect drive time estimations and best routing.

Between intersections

There may be times when driveways or other roads join a main road with close proximity to each other. This may cause small segments to be created between the two junctions along that main road. If the segment is shorter than 19.69 ft (6 m), it may be best to simply merge the two intersections into a single junction. It is OK if the joining roads in the map do not exactly align with the visual map in the Waze Map Editor.

See the Junction Style Guide section on offset roads for more details about this situation.

Necessary short segments

There are a few instances where a single short segment may be present between two other segments with no other segments at those junctions. Sometimes these junctions are necessary and should not be removed. These include:

  • Loop roads. A single segment cannot loop back upon itself, so a junction is required to create two separate segments. It does not matter where the junction is located, so long as each segment meets the minimum segment length. Some roads have two separate segments that share the same start and end junctions creating two alternate paths between them. These configurations cause routing problems and require one of the two segments to have a 2-segment junction. More details are covered in Junction Style Guide on Loops.
  • Ramp or freeway splits. There are cases where a freeway may split into two separate freeways. In order to provide navigation to drivers, it may be necessary to create short segments on the freeway to show the two different road names at the split. Under certain situations it may be best to make the segments as short as possible, so long as each segment meets the minimum segment length. This is covered in detail in the Junction Style Guide.
  • Long segments. Segments are best kept under a certain distance.
  • Segment Property Change. When a segment property changes between intersections, a two-segment junction may be required:
  • Road, city, or state name change. When the road, city, or state name changes between intersections, add a junction so the segments on either side may have a different name.
  • Elevation Change. When elevation changes at complex interchanges, a junction can be added to introduce an elevation change.
  • Speed Limit Change. When the speed limit changes between intersections, add a junction so the segments on either side may have a different speed limit.

In the above cases, the segment is necessary so it cannot be deleted, but it can be made at least the minimum length and still meet the needs of the original purpose.

Too long

Segments longer than about 62 miles (100 km) cannot be saved. In addition, there are several good reasons to keep segments shorter than 6.2 miles (10 km):

  • Long roadways or railroads with the city name present will cause a smudged city issue on the city layer.
  • Long segments require more resources in the client and WME to render on the screen.

Fixing long segments

Simply cut the segment to add one or more junction points. Each resulting segment should be shorter than the maximum length and longer than the minimum length.