From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg obstacle
Obstacle-Dense vegetation.JPG
Objective obstacles in a path (or highways) that difficult the passability Edit or translate this description.
Group: Properties
Used on these elements
may be used on nodesmay be used on waysshould not be used on areasmay be used on relations
See also


Status: proposedPage for proposal

The goal of this tag is to mark obstacles which are not derived from the properties of the road (surface, material, width, etc.) but from its environment or local properties; similarly, marks places where a way (most often waterways) have environmental obstacles. This tag can be used in a navigation application to avoid areas or use parts of the road with lower priorities when calculate routes, similarly to bumps, ferries or non-free roads, but it can be used on paths for non-vehicles.

See also the more common key barrier=*, used to map barriers on roads and paths, including logs, blocks, debris and ditches.


This key has been proposed, but the most frequently used values are not covered by the proposal. Please help document what these values mean and where they come from.

General use

Values as of 2015-06-15 according to taginfo
Value Usage Count Meaning Alternatives Ways Project Image
vegetation node


2705 Movement on route is hard due to the vegetation (shubs, dense grass, nettle, lianas etc.), movement is significantly slowed down or you have to move carefully. highway General Obstacle-Dense vegetation.JPG
yes node way 117 undefined (or "other") environmental factors make moving on the route difficult use a more specific tag highway General
fallen_tree node 1084 There is a big fallen tree that completely hinders passability, and you only can continue the path if you cross the tree (cross it above or below). Lesser used alternative to barrier=log. See #Fallen tree below. highway General Obstacle-Fallen tree.JPG
unevenness way node 33 To follow the trail you must use hands and it cannot be avoided. see discussion highway General Obstacle-Unevenness.JPG
precipice node way 17 There is an important precipice alongside the trail (at least one side) that your eyes can't avoid see if you look forward and you see the falling. There are a minimal risk of falling, but it's an important difficulty for people with dizziness. You can't move over away from the precipice and take out it of your visual field. highway General Obstacle-Path with precipice.JPG
heap node 10 There is a large heap of material (soil, rock pile, rubbish heap, etc.) making the movement difficult. highway General Obstacle-Heap.JPG
hole node 10 There is a large hole or holes on the road making the movement difficult or dangerous by smaller vehicles. highway General Obstacle-Hole.JPG

OpenSeaMap use (obsolete)

Values as of 2015-06-15 according to taginfo
Value Usage Count Meaning Alternatives Ways Project Image
bridge 2320 (Old tagging scheme not used by OpenSeaMap) bridge=* waterway OpenSeaMap
lock 695 (Old tagging scheme not used by OpenSeaMap) lock=*, waterway=lock_gate waterway OpenSeaMap
? (Old tagging scheme not used by OpenSeaMap) barrier=* + access=no
line 476 (Old tagging scheme not used by OpenSeaMap) ? waterway OpenSeaMap
ferry ? 44 (Old tagging scheme not used by OpenSeaMap) route=ferry waterway OpenSeaMap
drawbridge 24 (Old tagging scheme not used by OpenSeaMap) bridge:movable=drawbridge waterway OpenSeaMap
tunnel 24 (Old tagging scheme not used by OpenSeaMap) tunnel=* waterway OpenSeaMap


If you use the obstacle=* you can give more details about it by using

Key Value
obstacle_description=* The short and precise description of the obstacle (eg. "nettle", "dug hole", "rubbish" [heap])

Related tags

Specific cases

The obstacles are most often points so you should use them on a way node. When an obstacle is larger than approximately 5 meters (this is usually the lower bound of GPS sensitivity) you may use it on a way or area, but this preferably should be avoided.

Fallen tree

Fallen trees are almost always nodes, unless it is a way continuously covered by large amounts of fallen trees (like a not cleaned narrow valley road). When a tree crosses multiple ways use multiple way nodes instead of a "tree way" line; if it's a tree which could be used as a way please use highway=path + surface=wood instead. Do not use this tagging on "fresh" or "temporary" fallen trees; if a tree is visibly there for years or you reasonably expect it to stay there for years to come then tag it, but try not to tag trees which will be cleaned up (or cut) soon.

Hole and heap

These are usually nodes. It is possible that a large hole or heap have a size beyond 5 meters and could be tagged on a way; avoid tagging it as an area because it would make it nearly impossible to use for navigational applications. (A 10 meter hole or heap technically make the road disappear and people usually expected to go around it, creating a new path without hole or heap.)

See also

  • barrier=* - A barrier is a physical structure which blocks or impedes movement. This key is more common