Key: waterway 문서 원본 보기

[[KOSM Feature Key Reference|K-OSM Feature Key Reference]]로 돌아가기

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="하천·수로">waterway</code> || '''하천·수로''' — 물이 흐르는 강·하천·도랑과 수리 구조물을 표현합니다. || '''OSM 태그''' || 주로 길, 일부 노드·면 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:waterway OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="하천·수로">waterway=*</code>는 '''물이 흐르는 길과 그 흐름을 다루는 구조물'''을 정하는 지물 핵심 Key입니다. 강·개울·운하처럼 이어지는 흐름과, 그 흐름을 막거나 조절하는 댐·보·갑문을 함께 다룹니다.

흐름이 아니라 '''고여 있는 물의 넓이'''는 이 Key가 담당하지 않습니다. 호수·저수지나 강의 수면 영역은 <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류">[[Key: water|water=*]]</code>로 표현하므로, 대상이 흐름인지 수면인지 먼저 구분합니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="하천·수로">waterway=*</code>는 일반적으로 '''주로 길, 일부 노드·면'''에 적용합니다.

강·개울·운하·배수로는 흐름 방향의 중심선 길에 적용합니다. 댐·보·갑문처럼 특정 구조물 값은 실제 위치의 노드나 길에 사용하고, 넓은 수면 면에는 별도 수역 태그를 사용합니다.

흐름 방향을 확인하지 못했다면 길을 임의의 방향으로 그리지 않습니다.

==== Value 선택 ====
흐름을 나타내는 길은 '''물이 흐르는 방향으로''' 그립니다. 이름·폭·간헐성·교량·터널 구간은 <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="폭">[[Key: width|width=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="간헐성">[[Key: intermittent|intermittent=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="터널">[[Key: tunnel|tunnel=*]]</code> 등으로 보완합니다.

값을 고를 때는 먼저 자연적으로 생긴 흐름인지 사람이 만든 수로인지 나눕니다. 자연 하천은 규모에 따라 <code class="kosm-tag-reference" title="하천·수로=개울·소하천">waterway=stream</code>과 <code class="kosm-tag-reference" title="하천·수로=강">waterway=river</code>로, 인공 수로는 목적과 규모에 따라 <code class="kosm-tag-reference" title="하천·수로=흙으로 판 좁은 인공 도랑">waterway=ditch</code>, <code class="kosm-tag-reference" title="하천·수로=바닥과 벽을 마감한 인공 배수 수로">waterway=drain</code>, <code class="kosm-tag-reference" title="하천·수로=운하·인공 수로">waterway=canal</code>로 갈립니다. OSM Wiki는 <code>stream</code>을 ‘성인이 뛰어넘을 수 있을 정도로 강이라고 하기에는 좁은 자연 수로’로 설명하므로, 폭을 가늠하기 어려울 때 판단 기준으로 삼을 수 있습니다.

댐·보·갑문은 물의 흐름 자체가 아니라 흐름을 막거나 조절하는 '''구조물'''입니다. 하천 길 위의 노드로 놓거나 구조물의 축을 따라 별도의 길로 그리며, 흐름을 나타내는 하천 길과 같은 객체로 합치지 않습니다.

하천의 수면 폭이 지도에서 구분될 정도라면 흐름의 중심선과 함께 수면 영역을 별도 면으로 표현할 수 있습니다. 호수·저수지처럼 흐름보다 수면 자체가 중심인 대상은 <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류">[[Key: water|water=*]]</code>를 우선 검토합니다.

'''확인되지 않은 값은 임의로 추정하지 않습니다.''' 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.

=== 비슷한 Key와 구분하기 ===
비슷해 보이는 Key도 서로 다른 질문에 답합니다. 한 Key에 모든 의미를 넣지 말고 아래 기준에 따라 나누어 기록합니다.

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물">[[Key: natural|natural=*]]</code> || 자연 지형·식생·수역 자체의 종류 || <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=자연림 또는 숲">[[Key: natural|natural=wood]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="토지 이용">[[Key: landuse|landuse=*]]</code> || 일정 영역에서 주로 이루어지는 토지 이용 || <code class="kosm-tag-reference kosm-tag-reference--link" title="토지 이용=주거 지역">[[Key: landuse|landuse=residential]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류">[[Key: water|water=*]]</code> || <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code> 수역의 세부 유형 || <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code> + <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류=저수지">[[Key: water|water=reservoir]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="습지 유형">[[Key: wetland|wetland=*]]</code> || <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=습지">[[Key: natural|natural=wetland]]</code> 습지의 세부 유형 || 지물 핵심 태그와 함께 사용
|}

=== 주요 Value ===
아래 표에는 '''K-OSM에서 중요하게 다루거나 자주 사용하는 주요 Value'''를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 [https://wiki.openstreetmap.org/wiki/Key:waterway OSM Wiki — Key:waterway]에서 확인합니다.

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="하천·수로=개울·소하천">waterway=stream</code> || 개울이나 소하천 || 자연적으로 생긴 흐름 가운데 강이라고 하기에는 좁은 소하천에 사용합니다. OSM Wiki는 ‘성인이 뛰어넘을 수 있을 정도’를 기준으로 제시하므로 폭을 가늠할 때 참고할 수 있습니다. 규모가 큰 강은 <code>river</code>, 사람이 만든 수로는 <code>ditch</code>·<code>drain</code>과 구분하며 길 방향은 물의 흐름을 따릅니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Dstream Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=흙으로 판 좁은 인공 도랑">waterway=ditch</code> || 흙으로 판 좁은 인공 도랑 || 관개·배수를 위해 파 놓은 좁은 인공 도랑에 사용합니다. 대체로 바닥과 벽을 따로 마감하지 않은 흙 수로라는 점에서, 콘크리트 등으로 마감한 배수 수로인 <code>drain</code>과 갈립니다. 자연 하천은 <code>stream</code>으로 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Dditch Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=바닥과 벽을 마감한 인공 배수 수로">waterway=drain</code> || 바닥과 벽을 마감한 인공 배수 수로 || 빗물이나 사업장 배출수 등을 흘려보내도록 만든 인공 배수 수로에 사용합니다. 보통 콘크리트·석재 등으로 바닥과 벽을 마감한다는 점이 <code>ditch</code>와 나누는 실질적인 기준이며, 흐름 방향으로 그립니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Ddrain Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=강">waterway=river</code> || 강 || 상시 흐르는 자연 수로 중 규모가 커 일반적으로 사람이 걸어서 건너기 어려운 강의 중심선에 사용합니다. 수면 폭은 <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류=강의 수면 영역">[[Key: water|water=river]]</code> 영역으로 별도 표현할 수 있습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Driver Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=운하·인공 수로">waterway=canal</code> || 운하·인공 수로 || 운송·관개·급수 등을 위해 인공적으로 조성된 비교적 큰 수로에 사용합니다. 작은 배수로인 <code>drain</code>·<code>ditch</code>와 실제 목적과 규모를 기준으로 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Dcanal Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=보">waterway=weir</code> || 물의 흐름을 조절하는 보 || 하천을 가로질러 수위나 유속을 조절하는 낮은 보 구조물에 사용합니다. '''물이 구조물 위를 넘어 흐른다'''는 점이 물을 가두는 <code class="kosm-tag-reference" title="하천·수로=댐">waterway=dam</code>과 나누는 기준이며, 하천 길 위의 노드나 구조물의 축을 따라 그린 길로 표현합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Dweir Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=댐">waterway=dam</code> || 댐 || 물을 막아 수위를 높이거나 저수지를 형성하는 댐 구조물의 축에 사용합니다. 보통 물이 구조물 위로 넘어 흐르지 않는다는 점에서 <code class="kosm-tag-reference" title="하천·수로=보">waterway=weir</code>와 갈리며, 길이나 면으로 그립니다. 댐이 가둔 수면은 <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>와 적절한 <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류">[[Key: water|water=*]]</code>로 별도 표현합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Ddam Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=갑문">waterway=lock_gate</code> || 갑문 || 운하·하천의 갑문에서 수위를 조절하도록 열고 닫는 문 위치에 사용합니다. 갑문 구역 전체나 일반 수문과 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Dlock_gate Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="하천·수로=폐기된 값">waterway=riverbank</code> || 강 수면을 나타내던 폐기된 값 || 강 수면 영역을 나타내던 이전 방식으로, OSM Wiki에서 '''폐기된 값'''으로 표시되어 있습니다. 기존 데이터를 해석할 때만 참고하고 새로 그릴 때는 <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류=강의 수면 영역">[[Key: water|water=river]]</code> 조합을 사용합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:waterway%3Driverbank Tag 문서에서 확인]
|}

=== 함께 사용하는 Key ===
Key가 비슷해 보여도 '''각각 나타내는 정보가 다릅니다.''' 하나의 Key에 여러 의미를 넣지 말고, '''정보의 종류에 맞는 Key를 각각 사용합니다.'''

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name]]</code> || 출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:name OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물">[[Key: natural|natural]]</code> || 수역, 숲, 관목지, 습지, 해안선 등 자연적으로 형성된 지물을 분류합니다. || [https://wiki.openstreetmap.org/wiki/Key:natural OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류">[[Key: water|water]]</code> || <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>로 표현한 수역의 종류를 구체화합니다. || [https://wiki.openstreetmap.org/wiki/Key:water OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="간헐성">[[Key: intermittent|intermittent]]</code> || 물의 흐름이나 존재가 연중 지속되지 않는지 나타냅니다. || [https://wiki.openstreetmap.org/wiki/Key:intermittent OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="터널">[[Key: tunnel|tunnel]]</code> || 지물이 터널 안을 통과함을 나타냅니다. || [https://wiki.openstreetmap.org/wiki/Key:tunnel OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="교량">[[Key: bridge|bridge]]</code> || 지물이 다리 위를 통과하거나 다리 구조 자체임을 나타냅니다. || [https://wiki.openstreetmap.org/wiki/Key:bridge OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer]]</code> || 교량·터널처럼 지물이 서로 교차할 때 상대적인 위아래 순서를 나타냅니다. 실제 층수나 높이를 뜻하지 않습니다. || [https://wiki.openstreetmap.org/wiki/Key:layer OSM Wiki]
|}

==== 대표 태그 조합 ====
OSM Wiki에서 설명하는 사용 방식과 널리 정착된 조합만 선별했습니다. 실제로 확인되지 않은 속성은 예시를 그대로 복사하지 말고 생략합니다.

{| class="wikitable"
! 사용 장면 !! 태그 조합 !! 조합하는 이유
|-
| 이름이 있는 하천의 흐름 || <code class="kosm-tag-reference" title="하천·수로=강">waterway=river</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=예시천]]</code> || 물이 흐르는 방향으로 중심선을 그리고 이름을 붙입니다. 수면의 넓이는 이 길이 아니라 <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류=강의 수면 영역">[[Key: water|water=river]]</code> 면으로 표현합니다.
|-
| 폭이 있는 강의 수면 || <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=수역">[[Key: natural|natural=water]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류=강의 수면 영역">[[Key: water|water=river]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=예시강]]</code> || 흐름을 나타내는 <code class="kosm-tag-reference" title="하천·수로=강">waterway=river</code> 길과 수면 범위를 나타내는 면은 서로 다른 객체입니다. 두 정보를 한 객체에 합치지 않습니다.
|-
| 비가 올 때만 물이 흐르는 소하천 || <code class="kosm-tag-reference" title="하천·수로=개울·소하천">waterway=stream</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="간헐성=간헐적으로 물이 있음">[[Key: intermittent|intermittent=yes]]</code> || 수로의 종류는 <code class="kosm-tag-reference" title="하천·수로">waterway=*</code>로 정하고, 연중 흐르지 않는다는 사실은 <code class="kosm-tag-reference kosm-tag-reference--link" title="간헐성">[[Key: intermittent|intermittent=*]]</code>로 따로 기록합니다.
|-
| 하천을 가로지르는 보 || <code class="kosm-tag-reference" title="하천·수로=보">waterway=weir</code> || 보는 흐름이 아니라 흐름을 조절하는 구조물입니다. 하천 길 위의 노드나 구조물의 축을 따라 그린 별도의 길로 표현합니다.
|-
| 도로 아래로 수로가 지나는 암거 || <code class="kosm-tag-reference" title="하천·수로=바닥과 벽을 마감한 인공 배수 수로">waterway=drain</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="터널=하천·배수로가 지나는 암거">[[Key: tunnel|tunnel=culvert]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=-1]]</code> || 수로의 종류는 그대로 두고 구조물 아래를 지나는 구간만 길을 나누어 <code class="kosm-tag-reference kosm-tag-reference--link" title="터널=하천·배수로가 지나는 암거">[[Key: tunnel|tunnel=culvert]]</code>를 붙입니다.
|}

=== 참고 문서 ===
이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 [https://wiki.openstreetmap.org/wiki/Key:waterway OSM Wiki — Key:waterway]에서 확인합니다.

[[분류:KOSM 태그 사전]]