지물과 태그 이해

K-OSM에서 사용하는 지도 태그를 설명하는 문서입니다. K-OSM은 한국형 지도이며, [https://wiki.openstreetmap.org/wiki/Ko:Map_features OpenStreetMap(OSM)]의 데이터 구조와 태그 문법을 대부분 따릅니다.

이 문서는 태그를 단순히 노드·길·면으로 나누지 않습니다. 같은 태그가 여러 표현 형태에서 사용될 수 있기 때문입니다. 먼저 표현 형태를 이해하고, 실제 태그는 공통 태그와 지물 종류를 기준으로 찾아보면 됩니다.

=== 1. 태그와 표현 형태 이해 ===
태그는 지물이 무엇인지 설명하고, 노드·길·면·관계는 그 지물을 지도에 어떻게 표현할지 결정합니다.

==== 노드로 표현하기 ====
노드는 위치 하나를 나타내는 점입니다. 출입구, 음식점, 버스 정류소, 가로등, 벤치, 나무처럼 특정 위치를 표시하는 지물에 사용합니다. 자세한 요소 구조는 [[노드]]에서 확인할 수 있습니다.

대표 태그: <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 출입구">[[Key: entrance|entrance=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=카페">[[Key: amenity|amenity=cafe]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로=버스 정류소">[[Key: highway|highway=bus_stop]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로=가로등">[[Key: highway|highway=street_lamp]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=나무 한 그루">[[Key: natural|natural=tree]]</code>

==== 길로 표현하기 ====
길은 노드를 순서대로 연결한 선입니다. 도로·보도·철도·하천처럼 선 자체가 중요한 지물에 사용합니다. 길의 구조와 방향은 [[길]]에서 확인할 수 있습니다.

대표 태그: <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로=주거 도로">[[Key: highway|highway=residential]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="철도=일반 철도 선로">[[Key: railway|railway=rail]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="하천·수로=강">[[Key: waterway|waterway=river]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설=울타리">[[Key: barrier|barrier=fence]]</code>

==== 면(Area·폴리곤)으로 표현하기 ====
면은 공간을 차지하는 지물입니다. 일반적으로 닫힌 길에 면을 나타내는 태그를 붙이거나, 구멍이 있거나 경계가 복잡한 경우 관계로 구성합니다. K-OSM에서는 [https://wiki.openstreetmap.org/wiki/Area OSM의 Area 설명]을 참고해 면으로 해석되는지 확인합니다.

대표 태그: <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=종류를 구분하지 않은 건물">[[Key: building|building=yes]]</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: natural|natural=water]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=주차장">[[Key: amenity|amenity=parking]]</code>

==== 관계로 표현하기 ====
관계는 여러 노드·길·관계를 하나의 의미로 묶습니다. 버스 노선, 통행 제한, 구멍이 있는 복합 면처럼 하나의 요소만으로 설명하기 어려운 경우 사용합니다. 자세한 구조는 [[관계]]에서 확인할 수 있습니다.

대표 태그: <code class="kosm-tag-reference kosm-tag-reference--link" title="관계 유형=노선 관계">[[Key: type|type=route]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="관계 유형=여러 외곽·내곽으로 구성된 면 관계">[[Key: type|type=multipolygon]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="관계 유형=회전·통행 제한 관계">[[Key: type|type=restriction]]</code>

=== 2. 태그의 역할 ===
OSM의 태그는 자유로운 <code>Key=Value</code> 형식이지만, 모든 Key가 같은 역할을 하지는 않습니다. 어떤 태그는 객체가 무엇인지 정의하고, 어떤 태그는 이미 정의된 객체에 이름·운영시간·층수 같은 정보를 덧붙입니다. 자세한 기본 원리는 [https://wiki.openstreetmap.org/wiki/Key_Value_System OSM Wiki의 태그 구조]에서 확인할 수 있습니다.

K-OSM에서는 태그를 다음 다섯 단계로 구분합니다.

# 지물 핵심 Key — 객체가 무엇인지 정의합니다.
# 공통 속성 Key — 여러 종류의 객체에 폭넓게 정보를 추가합니다.
# 조건부 공통 Key — 여러 분야에서 쓰이지만 적용 조건이 있습니다.
# 지물 종속 Key — 특정 지물 핵심 Key가 있어야 의미가 분명해집니다.
# 관계·구조 Key — 여러 요소를 묶거나 데이터 구조를 정의합니다.

이 구분은 태그를 입력하는 순서이기도 합니다. 먼저 객체의 표현 형태와 지물 핵심 Key를 정한 뒤, 필요한 속성만 단계적으로 추가합니다.

==== 2.1 지물 핵심 Key ====
지물 핵심 Key는 “이 객체가 무엇인가?”를 정의합니다. [https://wiki.openstreetmap.org/wiki/Main_key OSM Wiki의 Top-level tag] 또는 Feature tag에 해당하며, 독립된 지도 객체는 일반적으로 하나 이상의 지물 핵심 태그를 가집니다.

{| class="wikitable"
! 분야 !! 주요 Key !! 정의하는 지물 !! 대표 태그
|-
| 도로·교통 || <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로">[[Key: highway|highway]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="철도">[[Key: railway|railway]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="대중교통">[[Key: public_transport|public_transport]]</code> || 도로·보행로·철도·정류장 || <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로=주거 도로">[[Key: highway|highway=residential]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="철도=일반 철도 선로">[[Key: railway|railway=rail]]</code>
|-
| 시설·장소 || <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형">[[Key: shop|shop]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="사무 시설">[[Key: office|office]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="의료·보건">[[Key: healthcare|healthcare]]</code> || 생활시설·상점·사무실·의료시설 || <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=학교">[[Key: amenity|amenity=school]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형=편의점">[[Key: shop|shop=convenience]]</code>
|-
| 관광·여가 || <code class="kosm-tag-reference kosm-tag-reference--link" title="관광 시설">[[Key: tourism|tourism]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="여가·휴식 시설">[[Key: leisure|leisure]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="역사 지물">[[Key: historic|historic]]</code> || 관광시설·공원·체육·역사 지물 || <code class="kosm-tag-reference kosm-tag-reference--link" title="관광 시설=호텔">[[Key: tourism|tourism=hotel]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="여가·휴식 시설=공원">[[Key: leisure|leisure=park]]</code>
|-
| 건물·인공물 || <code class="kosm-tag-reference kosm-tag-reference--link" title="건물">[[Key: building|building]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="인공 구조물">[[Key: man_made|man_made]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설">[[Key: barrier|barrier]]</code>, <code class="kosm-tag-reference" title="전력 시설의 유형">power</code> || 건물·인공 구조물·장벽·전력시설 || <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=공동주택">[[Key: building|building=apartments]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설=울타리">[[Key: barrier|barrier=fence]]</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: natural|natural]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="하천·수로">[[Key: waterway|waterway]]</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: natural|natural=tree]]</code>
|-
| 장소·경계 || <code class="kosm-tag-reference kosm-tag-reference--link" title="장소·정착지">[[Key: place|place]]</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: place|place=city]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="경계 유형=행정구역 경계">[[Key: boundary|boundary=administrative]]</code>
|}

한 객체에 지물 핵심 태그가 둘 이상 붙을 수도 있습니다. 예를 들어 학교 건물 하나가 학교 시설 전체를 함께 나타낸다면 <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=학교 건물">[[Key: building|building=school]]</code>과 <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=학교">[[Key: amenity|amenity=school]]</code>이 함께 사용될 수 있습니다. 단, 모든 태그가 같은 실제 객체를 모순 없이 설명해야 합니다.

==== 2.2 공통 속성 Key ====
공통 속성 Key는 객체의 유형을 바꾸지 않고 이름·식별자·운영 주체·물리 정보 등을 보충합니다. 여기서 ‘공통’은 모든 객체에 반드시 입력한다는 뜻이 아니라, 여러 종류의 지물에 반복해서 사용할 수 있다는 뜻입니다.

{| class="wikitable"
! 정보 종류 !! 주요 Key !! 설명
|-
| 이름 || <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: official_name|official_name]]</code>, <code>short_name</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="대체 이름">[[Key: alt_name|alt_name]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="다국어 이름 - 영어">[[Key: name:en|name:en]]</code> || 대표 이름·공식 명칭·약칭·다른 이름·언어별 이름
|-
| 식별 || <code class="kosm-tag-reference kosm-tag-reference--link" title="참조 번호">[[Key: ref|ref]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="Wikidata 식별자">[[Key: wikidata|wikidata]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="Wikipedia 문서">[[Key: wikipedia|wikipedia]]</code> || 공식 참조번호와 외부 지식 항목 연결
|-
| 운영·관리 || <code class="kosm-tag-reference kosm-tag-reference--link" title="운영 주체">[[Key: operator|operator]]</code>, <code class="kosm-tag-reference" title="소유 주체">owner</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="브랜드">[[Key: brand|brand]]</code>, <code class="kosm-tag-reference" title="노선이나 시설이 속한 망의 이름">network</code> || 운영자·소유자·브랜드·소속 망
|-
| 연락 || <code class="kosm-tag-reference kosm-tag-reference--link" title="웹사이트">[[Key: website|website]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="전화번호">[[Key: phone|phone]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="이메일">[[Key: email|email]]</code> || 공식 웹사이트와 연락처
|-
| 물리 정보 || <code class="kosm-tag-reference kosm-tag-reference--link" title="높이(미터)">[[Key: height|height]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="폭">[[Key: width|width]]</code>, <code class="kosm-tag-reference" title="해발 고도">ele</code>, <code>material</code>, <code>colour</code> || 높이·폭·해발고도·재료·색상
|-
| 설명·시점 || <code class="kosm-tag-reference kosm-tag-reference--link" title="보충 설명">[[Key: description|description]]</code>, <code>note</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="존재·사용 시작 시점">[[Key: start_date|start_date]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="최근 확인일">[[Key: check_date|check_date]]</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: railway|railway=station]]</code> 같은 지물 핵심 태그로 먼저 정의해야 합니다.

==== 2.3 조건부 공통 Key ====
조건부 공통 Key는 여러 분야에서 사용할 수 있지만, 실제 객체에 해당 조건이 있을 때만 입력합니다. 겉보기에는 범용적이어도 모든 지물에 무조건 적용하지 않습니다.

{| class="wikitable"
! Key !! 사용할 수 있는 대상 !! 확인할 점
|-
| <code>addr:*</code> || 주소가 있는 건물·시설·주소 노드 || 주소를 가진 객체인지 확인
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="운영시간">[[Key: opening_hours|opening_hours]]</code> || 운영·개방 시간이 있는 시설 || 건물 자체와 내부 시설의 운영시간을 구분
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access]]</code> || 출입·통행 규칙이 있는 길·시설·구역 || 물리적 접근 가능성과 이용 규칙을 구분
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성">[[Key: wheelchair|wheelchair]]</code> || 접근성을 확인할 수 있는 시설·교통 지물 || 실제 출입과 이용 가능 여부를 확인
|-
| <code>fee</code> || 이용료가 있는 시설·도로·주차장 || 상품 가격을 기록하는 태그가 아님
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="표면 재질">[[Key: surface|surface]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="조명 여부">[[Key: lit|lit]]</code> || 도로·광장·주차장 등 || 실제 표면과 조명 제공 여부가 의미 있는지 확인
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level]]</code> || 건물·역사·복합시설 내부 지물 || 객체가 위치한 층을 기록
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer]]</code> || 서로 교차하거나 겹치는 길·면 || 층수·높이·고도가 아닌 상대적 위아래 순서
|}

<code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=1]]</code>은 시설이 건물의 어느 층에 있는지 나타냅니다. 반면 <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=1]]</code>은 교량과 터널처럼 교차하는 지물 사이의 상대적인 위아래 관계를 나타냅니다. 자세한 차이는 [https://wiki.openstreetmap.org/wiki/Key:level OSM Wiki의 level=*]과 [https://wiki.openstreetmap.org/wiki/Key:layer layer=*]에서 확인합니다.

==== 2.4 지물 종속 Key ====
지물 종속 Key는 특정 지물 핵심 태그와 함께 사용할 때 의미가 분명해집니다. 이 태그만 단독으로 입력하기보다 어떤 지물의 세부 속성인지 먼저 확인합니다.

{| class="wikitable"
! 대상 !! 종속 Key !! 함께 필요한 지물 핵심 Key
|-
| 건물 || <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground]]</code>, <code class="kosm-tag-reference" title="건축물의 외장·구조 재료">building:material</code>, <code>roof:shape</code> || <code class="kosm-tag-reference kosm-tag-reference--link" title="건물">[[Key: building|building=*]]</code> 또는 <code class="kosm-tag-reference" title="건물을 이루는 부분 구조">building:part=*</code>
|-
| 도로 || <code class="kosm-tag-reference kosm-tag-reference--link" title="차로 수">[[Key: lanes|lanes]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="최고 제한속도">[[Key: maxspeed|maxspeed]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="일방통행">[[Key: oneway|oneway]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="보도 배치">[[Key: sidewalk|sidewalk]]</code>, <code class="kosm-tag-reference" title="차로별 회전 방향">turn:lanes</code> || 주로 <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로">[[Key: highway|highway=*]]</code>
|-
| 철도 || <code class="kosm-tag-reference kosm-tag-reference--link" title="철도 궤간">[[Key: gauge|gauge]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="철도 전철화 방식">[[Key: electrified|electrified]]</code>, <code>tracks</code>, <code class="kosm-tag-reference" title="철도 노선이 맡는 역할">usage</code> || <code class="kosm-tag-reference kosm-tag-reference--link" title="철도">[[Key: railway|railway=*]]</code>
|-
| 행정경계 || <code class="kosm-tag-reference kosm-tag-reference--link" title="행정 경계 단계">[[Key: admin_level|admin_level]]</code> || <code class="kosm-tag-reference kosm-tag-reference--link" title="경계 유형=행정구역 경계">[[Key: boundary|boundary=administrative]]</code>
|-
| 식생 || <code class="kosm-tag-reference" title="생물 종">species</code>, <code>genus</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="잎 형태">[[Key: leaf_type|leaf_type]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="잎의 계절성">[[Key: leaf_cycle|leaf_cycle]]</code> || <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=나무 한 그루">[[Key: natural|natural=tree]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="자연 지물=관목 한 그루">[[Key: natural|natural=shrub]]</code> 등
|-
| 출입구 || <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 출입구=주 출입구">[[Key: entrance|entrance=main]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 출입구=직원·물류용 출입구">[[Key: entrance|entrance=service]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 출입구=비상 출입구">[[Key: entrance|entrance=emergency]]</code> || 건물·시설 경계의 출입구 노드
|}

예를 들어 <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels=15]]</code>는 건물의 지상층 수이므로 <code class="kosm-tag-reference kosm-tag-reference--link" title="건물">[[Key: building|building=*]]</code> 또는 <code class="kosm-tag-reference" title="건물을 이루는 부분 구조">building:part=*</code>가 있는 객체에 사용합니다. [https://wiki.openstreetmap.org/wiki/Key:building:levels OSM Wiki의 building:levels=*]처럼 각 종속 Key 문서에는 함께 필요한 태그와 적용 대상이 정리되어 있습니다.

==== 2.5 관계·구조 Key ====
관계·구조 Key는 일반 속성을 추가하기보다 여러 요소가 어떤 방식으로 결합되는지 설명합니다.

{| class="wikitable"
! 태그 조합 !! 구조의 의미 !! 주요 구성원 역할
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="관계 유형=노선 관계">[[Key: type|type=route]]</code> + <code class="kosm-tag-reference kosm-tag-reference--link" title="노선 종류">[[Key: route|route=*]]</code> || 버스·철도·도로·자전거 노선 || <code class="kosm-tag-reference" title="노선의 정류장 구성원">stop</code>, <code class="kosm-tag-reference" title="승객 승하차 공간">platform</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: type|type=multipolygon]]</code> || 여러 길로 구성되거나 구멍이 있는 면 || <code class="kosm-tag-reference" title="다중 영역의 바깥 경계">outer</code>, <code class="kosm-tag-reference" title="다중 영역의 안쪽 구멍 경계">inner</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="관계 유형=경계 관계">[[Key: type|type=boundary]]</code> + <code class="kosm-tag-reference kosm-tag-reference--link" title="경계 유형">[[Key: boundary|boundary=*]]</code> || 행정구역·보호구역 등의 경계 || <code class="kosm-tag-reference" title="다중 영역의 바깥 경계">outer</code>, <code class="kosm-tag-reference" title="다중 영역의 안쪽 구멍 경계">inner</code>, <code>admin_centre</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="관계 유형=회전·통행 제한 관계">[[Key: type|type=restriction]]</code> + <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 제한 종류">[[Key: restriction|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="다중 영역의 바깥 경계">outer</code>, <code class="kosm-tag-reference" title="다중 영역의 안쪽 구멍 경계">inner</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>는 일반 태그가 아니라 관계 구성원에게 부여하는 역할(role)입니다. 관계 자체의 태그와 구성원의 역할을 구분해야 합니다.

K-OSM은 대부분 OSM 태그를 따르며, 한국형 표현을 위해 별도로 정의한 항목은 K-OSM 태그로 구분합니다. 태그별 출처와 배지의 의미, 같은 Key가 문맥에 따라 달라지는 사례는 [[KOSM Feature Key Reference|K-OSM Feature Key Reference]]에서 확인합니다.

=== 3. 태그를 읽고 입력하는 순서 ===
# 실제 지물을 노드·길·면·관계 중 어떤 형태로 표현할지 결정합니다.
# 지물 핵심 Key로 객체가 무엇인지 정의합니다.
# 이름·참조번호·운영자 같은 공통 속성을 추가합니다.
# 주소·운영시간·접근성처럼 실제로 확인된 조건부 속성을 추가합니다.
# 건물 층수·도로 차로 수처럼 해당 지물에 종속되는 세부 정보를 추가합니다.
# 여러 요소를 함께 묶어야 할 때만 관계와 구성원 역할을 확인합니다.

예를 들어 편의점 노드는 <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형=편의점">[[Key: shop|shop=convenience]]</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: opening_hours|opening_hours=24/7]]</code>을 필요한 속성으로 추가합니다. 공동주택 면은 <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=공동주택">[[Key: building|building=apartments]]</code>로 유형을 정한 뒤 <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=K-OSM 아파트]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels=15]]</code>와 주소 태그를 추가할 수 있습니다.

=== 4. 더 많은 Key 찾기 ===
이 페이지는 태그의 구조와 역할을 이해하는 데 필요한 주요 Key만 다룹니다. K-OSM에서 사용 중인 더 많은 Key와 Value 목록은 [[KOSM Feature Key Reference|K-OSM Feature Key Reference]]에서 분야별로 확인할 수 있습니다.

이 문서에 없는 OSM 태그와 최신 사용법은 [https://wiki.openstreetmap.org/wiki/Ko:Map_features OSM Map Features]와 각 Key의 [https://wiki.openstreetmap.org/wiki/Ko:Map_features OSM Wiki 문서]를 참고합니다.

[[분류:KOSM 태그 구성]]