Key: type
K-OSM Feature Key Reference로 돌아가기
Key 개요
| Key | 의미 | 태그 구분 | 적용 형태 | 값 형식 | 공식 문서 |
|---|---|---|---|---|---|
type |
관계 유형 — 관계가 노선·다중 영역·경계·통행 제한 중 어떤 구조인지 지정하는 OSM Key입니다. | OSM 태그 | 관계 | text |
OSM Wiki |
어떻게 사용하나요?
type=*는 관계가 어떤 구조 규칙을 따르는지를 정하는, 관계 전용의 필수 Key입니다. 관계의 주제가 아니라 구성 방식을 가리킵니다.
값마다 요구되는 구성원과 역할이 정해져 있습니다. 예를 들어 type=restriction은 from·via·to가 모두 있어야 의미가 성립합니다.
적용 대상
type=*는 일반적으로 관계에 적용합니다.
노드나 길이 아니라 관계에만 적용하며 관계의 구성 규칙을 결정합니다. type=*만 있고 구성원이 없는 관계는 실제 지리 구조를 설명하지 못합니다.
type=*는 관계에 사용합니다. 대한민국 법정 도로 유형에는 사용하지 않습니다.
Value 선택
관계가 multipolygon, boundary, route, restriction 중 어떤 구조 규칙을 따르는지 지정합니다. 관계 이름의 주제가 아니라 구성 방식에 맞는 값을 선택하고, 값마다 요구되는 구성원 역할이 완성되어 있는지 함께 검증합니다.
확인되지 않은 값은 짐작해서 넣지 않습니다. 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.
비슷한 Key와 구분하기
비슷해 보이는 Key도 서로 다른 질문에 답합니다. 한 Key에 모든 의미를 넣지 말고 아래 기준에 따라 나누어 기록합니다.
| Key | 무엇을 기록하나요? | 예시·구분 기준 |
|---|---|---|
route=* |
type=route 관계가 나타내는 경로·교통수단 |
route=bus
|
route_master=* |
같은 계통의 여러 노선 관계를 묶는 상위 관계 | 개별 운행 경로와 구분 |
restriction=* |
type=restriction 관계가 제한하는 동작 |
restriction=no_left_turn
|
boundary=* |
type=boundary일 때 경계의 성격을 나타내는 값 |
boundary=administrative
|
주요 Value
아래 표에는 K-OSM에서 중요하게 다루거나 자주 사용하는 주요 Value를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. 정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다. 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 OSM Wiki — Key:type에서 확인합니다.
| Value | 의미 | 언제·어떻게 사용하나요? | 태그 구분 | OSM Wiki |
|---|---|---|---|---|
type=multipolygon |
여러 외곽·내곽으로 구성된 면 관계 | 하나의 닫힌 길로 표현하기 어려운 복합 영역에 사용합니다. 바깥 경계는 outer, 구멍은 inner 역할로 구성하고 지물의 의미 태그는 관계에 적습니다. |
OSM 태그 | Tag 문서에서 확인 |
type=boundary |
경계 관계 | 행정구역·보호구역 같은 경계 관계에 사용합니다. boundary=*, name=*과 필요한 계층 Key를 관계에 기록하고 경계선의 구성원 역할과 인접 관계 공유 여부를 확인합니다. |
OSM 태그 | Tag 문서에서 확인 |
type=route |
노선 관계 | 노선·경로 관계를 만들 때 사용합니다. route=bus, route=bicycle 등으로 경로 종류를 지정하고 구성 길과 정류장의 순서·역할을 함께 확인합니다. |
OSM 태그 | Tag 문서에서 확인 |
type=restriction |
회전·통행 제한 관계 | 회전·진입 같은 통행 제한 관계에 사용합니다. 일반적으로 진입 길 from, 교차 노드나 길 via, 진출 길 to와 restriction=* 값이 필요합니다. |
OSM 태그 | Tag 문서에서 확인 |
type=route_master |
여러 노선 변형을 묶는 상위 관계 | 같은 노선의 방향별·운행형태별 여러 type=route 관계를 하나의 상위 노선으로 묶을 때 사용합니다. 개별 경로 길을 직접 넣기보다 하위 노선 관계를 구성원으로 포함하고 route_master=*로 교통수단을 지정합니다. |
OSM 태그 | Tag 문서에서 확인 |
값 입력 방법
관계의 구조적 유형을 Value로 기록합니다.
type=multipolygontype=routetype=restriction- 일반 지물의 종류나 K-OSM 법정 도로 유형을 기록하는 Key가 아닙니다.
함께 사용하는 Key
Key가 비슷해 보여도 각각 나타내는 정보가 다릅니다. 하나의 Key에 여러 의미를 넣지 말고, 정보의 종류에 맞는 Key를 각각 사용합니다.
| 관련 Key | 역할 | 공식 문서 |
|---|---|---|
route |
type=route 관계의 교통수단이나 경로 종류를 뜻합니다. |
OSM Wiki |
route_master |
같은 계통에 속한 여러 노선 관계를 상위 관계로 묶습니다. | OSM Wiki |
restriction |
type=restriction 관계에서 금지하거나 허용하는 회전·통행 동작을 기록합니다. |
OSM Wiki |
ref |
출입구 번호·도로 번호·정류장 번호처럼 외부에서 사용하는 식별자를 기록합니다. | OSM Wiki |
name |
출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다. | OSM Wiki |
network |
노선이나 시설이 속한 교통망·운영망을 뜻합니다. | OSM Wiki |
operator |
시설이나 서비스를 실제로 운영하는 기관 또는 사업자를 기록합니다. | OSM Wiki |
대표 태그 조합
OSM Wiki에서 설명하는 사용 방식과 널리 정착된 조합만 선별했습니다. 실제로 확인되지 않은 속성은 예시를 그대로 복사하지 말고 생략합니다.
| 사용 장면 | 태그 조합 | 조합하는 이유 |
|---|---|---|
| 버스 노선 관계 | type=route, route=bus, ref=100, operator=예시교통 |
type=route로 관계 구조를 정의하고 route=bus로 교통수단을 지정합니다. 노선 번호와 운영자는 별도 Key로 기록합니다.
|
| 다중 영역 관계 | type=multipolygon, natural=water, name=예시호수 |
바깥 경계에는 outer, 내부 구멍에는 inner 역할을 부여하고 지물의 의미 태그는 관계에 적습니다.
|
| 좌회전 금지 관계 | type=restriction, restriction=no_left_turn |
진입 길 from, 교차 지점 또는 길 via, 진출 길 to 구성원이 함께 필요합니다.
|
참고 문서
이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 OSM Wiki — Key:type에서 확인합니다.