Key: layer
KOSM Feature Key Reference로 돌아가기
Key 개요
| Key | 의미 | 태그 구분 | 적용 형태 | 값 형식 | 공식 문서 |
|---|---|---|---|---|---|
layer |
레이어 — 교량·터널처럼 지물이 서로 교차할 때 상대적인 위아래 순서를 뜻합니다. 실제 층수나 높이를 뜻하지 않습니다. | OSM 태그 | 주로 길·면 | integer |
OSM Wiki |
어떻게 사용하나요?
layer=*는 교차하지만 서로 연결되지 않는 지물들의 위아래 순서만 나타냅니다. 실제 높이나 층수가 아니라 상대적인 순서입니다.
지상의 일반 객체에는 붙이지 않습니다. 교량·터널처럼 겹침이 실제로 생기는 구간에서, 겹치는 상대와 비교해 필요한 만큼만 씁니다.
적용 대상
layer=*는 일반적으로 주로 길·면에 적용합니다.
입체 교차하는 도로·철도·수로·경계의 해당 길 구간에 붙입니다. 연결된 동일 평면의 객체나 실내 층 구분에는 사용하지 않습니다.
Value 선택
서로 교차하지만 연결되지 않는 지물의 상대적 위아래 순서만 나타냅니다. 지상 객체에 일괄 0을 붙이지 말고 교량·터널 구간에서 필요한 최소 범위에 사용하며, 물리적 높이나 건물 층을 표현하지 않습니다.
확인되지 않은 값은 짐작해서 넣지 않습니다. 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.
비슷한 Key와 구분하기
비슷해 보이는 Key도 서로 다른 질문에 답합니다. 한 Key에 모든 의미를 넣지 말고 아래 기준에 따라 나누어 기록합니다.
| Key | 무엇을 기록하나요? | 예시·구분 기준 |
|---|---|---|
level=* |
건물·실내에서 대상이 위치하거나 연결되는 층 | level=-1 — 지하 1층
|
location=* |
지하·지상·해상 같은 위치 환경 | location=underground
|
building:levels=* |
건물 전체의 지상층 수 | building:levels=15
|
height=* |
지물의 물리적인 전체 높이 | 단위가 없으면 미터 |
ele=* |
해수면을 기준으로 한 지점의 고도 | 건물 높이와 구분 |
주요 Value
아래 표에는 KOSM에서 중요하게 다루거나 자주 사용하는 주요 Value를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. 정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다. 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 OSM Wiki — Key:layer에서 확인합니다.
| Value | 의미 | 언제·어떻게 사용하나요? | 태그 구분 | OSM Wiki |
|---|---|---|---|---|
layer=1 |
기준면보다 한 단계 위 | 다른 지물과 직접 연결되지 않고 한 단계 위로 통과하는 교량·고가 구간 등에 사용합니다. bridge=* 등 물리적 구조 태그와 함께 확인합니다. |
OSM 태그 | Key 문서에서 확인 |
layer=0 |
기본 단계 | 기본 지표면의 교차 구조에 해당할 때 사용하며 보통 기본값이므로 명시하지 않아도 됩니다. 실제 건물 층을 뜻하지 않습니다. | OSM 태그 | Key 문서에서 확인 |
layer=-1 |
기준면보다 한 단계 아래 | 다른 지물 아래로 통과하는 터널·지하 구간 등에 사용합니다. tunnel=*과 함께 확인하고 건물 지하층 번호인 level=-1과 구분합니다. |
OSM 태그 | Key 문서에서 확인 |
layer=2 |
두 단계 위 | 두 단계 이상 겹치는 교차 구조에서 기준면보다 두 단계 위임을 뜻합니다. 단순 높이가 높다는 이유로 숫자를 키우지 않고 주변 교차 관계만 비교합니다. | OSM 태그 | Key 문서에서 확인 |
값 입력 방법
교차하지만 직접 연결되지 않는 지물의 상대적인 위아래 순서를 정수로 기록합니다.
layer=1— 교차 지점에서 위를 지나감layer=-1— 교차 지점에서 아래를 지나감- 보통
-5부터5까지 사용하며,layer=0은 따로 적지 않습니다. - 서로 교차하지 않는 지물 사이의 높이 차이는 나타내지 않습니다. 실제 높이는
ele=*, 건물 층은level=*로 기록합니다.
함께 사용하는 Key
Key가 비슷해 보여도 각각 나타내는 정보가 다릅니다. 하나의 Key에 여러 의미를 넣지 말고, 정보의 종류에 맞는 Key를 각각 사용합니다.
| 관련 Key | 역할 | 공식 문서 |
|---|---|---|
name |
출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다. | OSM Wiki |
ref |
출입구 번호·도로 번호·정류장 번호처럼 외부에서 사용하는 식별자를 기록합니다. | OSM Wiki |
description |
다른 정형 태그로 표현하기 어려운 보충 설명을 기록합니다. | OSM Wiki |
서로 교차하는 지물의 연결 여부는 layer=*만으로 결정되지 않습니다. 다리·터널과 노드 연결 상태를 함께 확인합니다.
참고 문서
이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 OSM Wiki — Key:layer에서 확인합니다.