Key: type 문서 원본 보기

[[KOSM Feature Key Reference]]로 돌아가기

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="관계 유형">type</code> || '''관계 유형''' — 관계가 노선·다중 영역·경계·통행 제한 중 어떤 구조인지 지정하는 OSM Key입니다. || '''OSM 태그''' || 관계 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:type OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="관계 유형">type=*</code>는 '''관계가 어떤 구조 규칙을 따르는지'''를 정하는, 관계 전용의 필수 Key입니다. 관계의 주제가 아니라 구성 방식을 가리킵니다.

값마다 요구되는 구성원과 역할이 정해져 있습니다. 예를 들어 <code class="kosm-tag-reference" title="관계 유형=회전·통행 제한 관계">type=restriction</code>은 <code class="kosm-tag-reference" title="통행 제한의 진입 구성원">from</code>·<code class="kosm-tag-reference" title="통행 제한의 경유 구성원">via</code>·<code class="kosm-tag-reference" title="통행 제한의 진출 구성원">to</code>가 모두 있어야 의미가 성립합니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="관계 유형">type=*</code>는 일반적으로 '''관계'''에 적용합니다.

노드나 길이 아니라 관계에만 적용하며 관계의 구성 규칙을 결정합니다. <code class="kosm-tag-reference" title="관계 유형">type=*</code>만 있고 구성원이 없는 관계는 실제 지리 구조를 설명하지 못합니다.

<code class="kosm-tag-reference" title="관계 유형">type=*</code>는 관계에 사용합니다. 대한민국 법정 도로 유형에는 사용하지 않습니다.

==== Value 선택 ====
관계가 <code>multipolygon</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="경계 유형">[[Key: boundary|boundary]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류">[[Key: route|route]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 제한 종류">[[Key: restriction|restriction]]</code> 중 어떤 구조 규칙을 따르는지 지정합니다. 관계 이름의 주제가 아니라 구성 방식에 맞는 값을 선택하고, 값마다 요구되는 구성원 역할이 완성되어 있는지 함께 검증합니다.

'''확인되지 않은 값은 짐작해서 넣지 않습니다.''' 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류">[[Key: route|route=*]]</code> || <code class="kosm-tag-reference" title="관계 유형=노선 관계">type=route</code> 관계가 나타내는 경로·교통수단 || <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류=버스 노선">[[Key: route|route=bus]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="상위 노선 종류">[[Key: route_master|route_master=*]]</code> || 같은 계통의 여러 노선 관계를 묶는 상위 관계 || 개별 운행 경로와 구분
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 제한 종류">[[Key: restriction|restriction=*]]</code> || <code class="kosm-tag-reference" title="관계 유형=회전·통행 제한 관계">type=restriction</code> 관계가 제한하는 동작 || <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 제한 종류=좌회전 금지">[[Key: restriction|restriction=no_left_turn]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="경계 유형">[[Key: boundary|boundary=*]]</code> || <code class="kosm-tag-reference" title="관계 유형=경계 관계">type=boundary</code>일 때 경계의 성격을 나타내는 값 || <code class="kosm-tag-reference kosm-tag-reference--link" title="경계 유형=행정구역 경계">[[Key: boundary|boundary=administrative]]</code>
|}

=== 주요 Value ===
아래 표에는 '''KOSM에서 중요하게 다루거나 자주 사용하는 주요 Value'''를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. '''정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다.''' 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 [https://wiki.openstreetmap.org/wiki/Key:type OSM Wiki — Key:type]에서 확인합니다.

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="관계 유형=여러 외곽·내곽으로 구성된 면 관계">type=multipolygon</code> || 여러 외곽·내곽으로 구성된 면 관계 || 하나의 닫힌 길로 표현하기 어려운 복합 영역에 사용합니다. 바깥 경계는 <code class="kosm-tag-reference" title="다중 영역의 바깥 경계">outer</code>, 구멍은 <code class="kosm-tag-reference" title="다중 영역의 안쪽 구멍 경계">inner</code> 역할로 구성하고 지물의 의미 태그는 관계에 적습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:type%3Dmultipolygon Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="관계 유형=경계 관계">type=boundary</code> || 경계 관계 || 행정구역·보호구역 같은 경계 관계에 사용합니다. <code class="kosm-tag-reference kosm-tag-reference--link" title="경계 유형">[[Key: boundary|boundary=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=*]]</code>과 필요한 계층 Key를 관계에 기록하고 경계선의 구성원 역할과 인접 관계 공유 여부를 확인합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:type%3Dboundary Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="관계 유형=노선 관계">type=route</code> || 노선 관계 || 노선·경로 관계를 만들 때 사용합니다. <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류=버스 노선">[[Key: route|route=bus]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류=자전거 노선">[[Key: route|route=bicycle]]</code> 등으로 경로 종류를 지정하고 구성 길과 정류장의 순서·역할을 함께 확인합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:type%3Droute Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="관계 유형=회전·통행 제한 관계">type=restriction</code> || 회전·통행 제한 관계 || 회전·진입 같은 통행 제한 관계에 사용합니다. 일반적으로 진입 길 <code class="kosm-tag-reference" title="통행 제한의 진입 구성원">from</code>, 교차 노드나 길 <code class="kosm-tag-reference" title="통행 제한의 경유 구성원">via</code>, 진출 길 <code class="kosm-tag-reference" title="통행 제한의 진출 구성원">to</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 제한 종류">[[Key: restriction|restriction=*]]</code> 값이 필요합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:type%3Drestriction Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="관계 유형=여러 노선 변형을 묶는 상위 관계">type=route_master</code> || 여러 노선 변형을 묶는 상위 관계 || 같은 노선의 방향별·운행형태별 여러 <code class="kosm-tag-reference" title="관계 유형=노선 관계">type=route</code> 관계를 하나의 상위 노선으로 묶을 때 사용합니다. 개별 경로 길을 직접 넣기보다 하위 노선 관계를 구성원으로 포함하고 <code class="kosm-tag-reference kosm-tag-reference--link" title="상위 노선 종류">[[Key: route_master|route_master=*]]</code>로 교통수단을 지정합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:type%3Droute_master Tag 문서에서 확인]
|}

=== 값 입력 방법 ===
관계의 구조적 유형을 Value로 기록합니다.

* <code class="kosm-tag-reference" title="관계 유형=여러 외곽·내곽으로 구성된 면 관계">type=multipolygon</code>
* <code class="kosm-tag-reference" title="관계 유형=노선 관계">type=route</code>
* <code class="kosm-tag-reference" title="관계 유형=회전·통행 제한 관계">type=restriction</code>
* 일반 지물의 종류나 KOSM 법정 도로 유형을 기록하는 Key가 아닙니다.

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류">[[Key: route|route]]</code> || <code class="kosm-tag-reference" title="관계 유형=노선 관계">type=route</code> 관계의 교통수단이나 경로 종류를 뜻합니다. || [https://wiki.openstreetmap.org/wiki/Key:route OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="상위 노선 종류">[[Key: route_master|route_master]]</code> || 같은 계통에 속한 여러 노선 관계를 상위 관계로 묶습니다. || [https://wiki.openstreetmap.org/wiki/Key:route_master OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 제한 종류">[[Key: restriction|restriction]]</code> || <code class="kosm-tag-reference" title="관계 유형=회전·통행 제한 관계">type=restriction</code> 관계에서 금지하거나 허용하는 회전·통행 동작을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:restriction OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="참조 번호">[[Key: ref|ref]]</code> || 출입구 번호·도로 번호·정류장 번호처럼 외부에서 사용하는 식별자를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:ref OSM Wiki]
|-
| <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" title="노선이나 시설이 속한 망의 이름">network</code> || 노선이나 시설이 속한 교통망·운영망을 뜻합니다. || [https://wiki.openstreetmap.org/wiki/Key:network OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="운영 주체">[[Key: operator|operator]]</code> || 시설이나 서비스를 실제로 운영하는 기관 또는 사업자를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:operator OSM Wiki]
|}

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

{| class="wikitable"
! 사용 장면 !! 태그 조합 !! 조합하는 이유
|-
| 버스 노선 관계 || <code class="kosm-tag-reference" title="관계 유형=노선 관계">type=route</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류=버스 노선">[[Key: route|route=bus]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="참조 번호">[[Key: ref|ref=100]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="운영 주체">[[Key: operator|operator=예시교통]]</code> || <code class="kosm-tag-reference" title="관계 유형=노선 관계">type=route</code>로 관계 구조를 정의하고 <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류=버스 노선">[[Key: route|route=bus]]</code>로 교통수단을 지정합니다. 노선 번호와 운영자는 별도 Key로 기록합니다.
|-
| 다중 영역 관계 || <code class="kosm-tag-reference" title="관계 유형=여러 외곽·내곽으로 구성된 면 관계">type=multipolygon</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: name|name=예시호수]]</code> || 바깥 경계에는 <code class="kosm-tag-reference" title="다중 영역의 바깥 경계">outer</code>, 내부 구멍에는 <code class="kosm-tag-reference" title="다중 영역의 안쪽 구멍 경계">inner</code> 역할을 부여하고 지물의 의미 태그는 관계에 적습니다.
|-
| 좌회전 금지 관계 || <code class="kosm-tag-reference" title="관계 유형=회전·통행 제한 관계">type=restriction</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 제한 종류=좌회전 금지">[[Key: restriction|restriction=no_left_turn]]</code> || 진입 길 <code class="kosm-tag-reference" title="통행 제한의 진입 구성원">from</code>, 교차 지점 또는 길 <code class="kosm-tag-reference" title="통행 제한의 경유 구성원">via</code>, 진출 길 <code class="kosm-tag-reference" title="통행 제한의 진출 구성원">to</code> 구성원이 함께 필요합니다.
|}

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

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