K-OSM Key 사전
imported>KOSM Wiki Legacy Import Published from reviewed version-controlled Wiki content |
WikiEditorQA (토론 | 기여) Rename KOSM branding to K-OSM |
||
| 1번째 줄: | 1번째 줄: | ||
K-OSM에서 사용하는 태그를 중심으로 정리한 색인입니다. Key는 지물의 속성이나 큰 분류를 정하고, Value는 그 안의 구체적인 종류나 값을 정합니다. | |||
예를 들어 <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity]]</code> Key 안에는 <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: amenity|amenity=restaurant]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=주차장">[[Key: amenity|amenity=parking]]</code> 같은 태그가 있습니다. 아래 표에서 Key를 누르면 주요 Key=Value 목록과 사용 설명을 한 페이지에서 볼 수 있습니다. | 예를 들어 <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity]]</code> Key 안에는 <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: amenity|amenity=restaurant]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=주차장">[[Key: amenity|amenity=parking]]</code> 같은 태그가 있습니다. 아래 표에서 Key를 누르면 주요 Key=Value 목록과 사용 설명을 한 페이지에서 볼 수 있습니다. | ||
=== 태그 구분과 배지 === | === 태그 구분과 배지 === | ||
이 사전은 각 Key가 OSM에서 사용하는 태그인지, 한국형 표현을 위해 | 이 사전은 각 Key가 OSM에서 사용하는 태그인지, 한국형 표현을 위해 K-OSM에서 자체 정의한 태그인지 먼저 구분합니다. K-OSM 태그도 OSM의 Key=Value 문법과 요소 구조를 따르지만, 의미와 Value 기준은 이 사전의 설명을 기준으로 확인합니다. | ||
{| class="wikitable" | {| class="wikitable" | ||
| 11번째 줄: | 11번째 줄: | ||
| '''OSM 태그''' || OSM 사용 태그 || OSM Wiki에 문서화된 Key입니다. 승인·사실상 표준·사용 중 등 상태가 다를 수 있으므로 상세 페이지의 주의사항도 확인합니다. | | '''OSM 태그''' || OSM 사용 태그 || OSM Wiki에 문서화된 Key입니다. 승인·사실상 표준·사용 중 등 상태가 다를 수 있으므로 상세 페이지의 주의사항도 확인합니다. | ||
|- | |- | ||
| '''OSM 태그''' '''의미 변형''' || OSM | | '''OSM 태그''' '''의미 변형''' || OSM 기반·K-OSM 적용 || OSM Key를 사용하되 한국 주소·행정 체계에 맞게 적용 의미를 구체화합니다. | ||
|- | |- | ||
| ''' | | '''K-OSM 태그''' || K-OSM 자체 || 한국형 데이터 표현을 위해 K-OSM에서 별도로 정의한 Key입니다. | ||
|} | |} | ||
| 21번째 줄: | 21번째 줄: | ||
=== 분류 원칙 === | === 분류 원칙 === | ||
K-OSM에서는 Key를 '''‘이 Key가 어떤 정보를 표현하는가’'''에 따라 다섯 가지로 나눕니다. 교통·건물·시설·자연·주소처럼 하나의 Key가 여러 분야에서 활용될 수 있으므로, 분야보다 데이터에서 맡는 역할을 기준으로 찾습니다. | |||
처음 태그를 입력할 때는 먼저 '''대상이 무엇인지 나타내는 지물 핵심 Key'''를 선택하고, 이름·주소·운영시간·접근성 같은 세부 정보를 덧붙이면 됩니다. | 처음 태그를 입력할 때는 먼저 '''대상이 무엇인지 나타내는 지물 핵심 Key'''를 선택하고, 이름·주소·운영시간·접근성 같은 세부 정보를 덧붙이면 됩니다. | ||
| 220번째 줄: | 220번째 줄: | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="인터넷 이용">[[Key: internet_access|internet_access]]</code> || 인터넷 이용 || '''OSM 태그''' || 접근성과 이용 조건 || 주로 POI || 방문자가 이용할 수 있는 인터넷 접속 방식과 제공 여부를 기록합니다. || <code class="kosm-tag-reference" title="internet_access=wlan · 인터넷 이용=무선 인터넷 제공">wlan</code>, <code class="kosm-tag-reference" title="internet_access=yes · 인터넷 이용=제공(방식 미상)">yes</code>, <code class="kosm-tag-reference" title="internet_access=no · 인터넷 이용=미제공">no</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="인터넷 이용">[[Key: internet_access|internet_access]]</code> || 인터넷 이용 || '''OSM 태그''' || 접근성과 이용 조건 || 주로 POI || 방문자가 이용할 수 있는 인터넷 접속 방식과 제공 여부를 기록합니다. || <code class="kosm-tag-reference" title="internet_access=wlan · 인터넷 이용=무선 인터넷 제공">wlan</code>, <code class="kosm-tag-reference" title="internet_access=yes · 인터넷 이용=제공(방식 미상)">yes</code>, <code class="kosm-tag-reference" title="internet_access=no · 인터넷 이용=미제공">no</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="대기 공간">[[Key: waiting_area|waiting_area]]</code> || 대기 공간 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="대기 공간">[[Key: waiting_area|waiting_area]]</code> || 대기 공간 || '''K-OSM 태그''' || POI 확장 Key || 주로 POI || 방문자를 위한 대기 공간이 있는지 나타내는 K-OSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. || <code class="kosm-tag-reference" title="waiting_area=yes · 대기 공간=있음">yes</code>, <code class="kosm-tag-reference" title="waiting_area=no · 대기 공간=없음">no</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="발레파킹">[[Key: valet_parking|valet_parking]]</code> || 발레파킹 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="발레파킹">[[Key: valet_parking|valet_parking]]</code> || 발레파킹 || '''K-OSM 태그''' || POI 확장 Key || 주로 POI || 발레파킹 서비스 제공 여부를 나타내는 K-OSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. || <code class="kosm-tag-reference" title="valet_parking=yes · 발레파킹=제공">yes</code>, <code class="kosm-tag-reference" title="valet_parking=no · 발레파킹=미제공">no</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="단체 이용 적합">[[Key: group_friendly|group_friendly]]</code> || 단체 이용 적합 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="단체 이용 적합">[[Key: group_friendly|group_friendly]]</code> || 단체 이용 적합 || '''K-OSM 태그''' || POI 확장 Key || 주로 POI || 단체 방문이나 모임에 적합한 장소인지 나타내는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="group_friendly=yes · 단체 이용 적합=적합함">yes</code>, <code class="kosm-tag-reference" title="group_friendly=no · 단체 이용 적합=적합하지 않음">no</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="어린이 이용 조건">[[Key: kids|kids]]</code> || 어린이 이용 조건 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="어린이 이용 조건">[[Key: kids|kids]]</code> || 어린이 이용 조건 || '''K-OSM 태그''' || POI 확장 Key || 주로 POI || 어린이 이용 가능 여부와 이용 정책을 나타내는 K-OSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. || <code class="kosm-tag-reference" title="kids=yes · 어린이 이용 조건=이용 가능">yes</code>, <code class="kosm-tag-reference" title="kids=no · 어린이 이용 조건=이용 불가">no</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="어린이 놀이 공간">[[Key: kids_area|kids_area]]</code> || 어린이 놀이 공간 || '''OSM 태그''' || POI 확장 Key || 주로 노드·면 || 시설에 어린이가 놀 수 있는 공간이 마련되어 있는지 나타냅니다. 공간의 정도에 따라 네 가지 Value로 나눕니다. || <code class="kosm-tag-reference" title="kids_area=yes · 어린이 놀이 공간=놀 수 있는 공간 있음">yes</code>, <code class="kosm-tag-reference" title="kids_area=designated · 어린이 놀이 공간=놀이 목적으로 조성된 공간">designated</code>, <code class="kosm-tag-reference" title="kids_area=limited · 어린이 놀이 공간=놀이 도구 정도만 있음">limited</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="어린이 놀이 공간">[[Key: kids_area|kids_area]]</code> || 어린이 놀이 공간 || '''OSM 태그''' || POI 확장 Key || 주로 노드·면 || 시설에 어린이가 놀 수 있는 공간이 마련되어 있는지 나타냅니다. 공간의 정도에 따라 네 가지 Value로 나눕니다. || <code class="kosm-tag-reference" title="kids_area=yes · 어린이 놀이 공간=놀 수 있는 공간 있음">yes</code>, <code class="kosm-tag-reference" title="kids_area=designated · 어린이 놀이 공간=놀이 목적으로 조성된 공간">designated</code>, <code class="kosm-tag-reference" title="kids_area=limited · 어린이 놀이 공간=놀이 도구 정도만 있음">limited</code> | ||
| 245번째 줄: | 245번째 줄: | ||
! Key !! 한글명 !! 태그 구분 !! 주요 지물 !! 적용 형태 !! 설명 !! 대표 Value | ! Key !! 한글명 !! 태그 구분 !! 주요 지물 !! 적용 형태 !! 설명 !! 대표 Value | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="국내 도로 구분">[[Key: road:class|road:class]]</code> || 국내 도로 구분 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="국내 도로 구분">[[Key: road:class|road:class]]</code> || 국내 도로 구분 || '''K-OSM 태그''' || 교통과 길 || highway 길 || 도로의 법적·행정적 구분과 이를 보완하는 도로 유형을 기록하는 K-OSM 자체 Key입니다. <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로">[[Key: highway|highway=*]]</code>가 붙은 도로에만 함께 사용합니다. || <code class="kosm-tag-reference" title="road:class=고속국도 · 국내 도로 구분">고속국도</code>, <code class="kosm-tag-reference" title="road:class=일반국도 · 국내 도로 구분">일반국도</code>, <code class="kosm-tag-reference" title="road:class=지방도 · 국내 도로 구분">지방도</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="서비스 도로·철도 세부 유형">[[Key: service|service]]</code> || 서비스 도로·철도 세부 유형 || '''OSM 태그''' || 교통과 길 || 길 || highway=service 또는 철도 선로에 세부 용도를 덧붙입니다. || <code class="kosm-tag-reference" title="service=parking_aisle · 서비스 도로·철도 세부 유형=주차 구획 사이 통로">parking_aisle</code>, <code class="kosm-tag-reference" title="service=alley · 서비스 도로·철도 세부 유형=골목·후면 통로">alley</code>, <code class="kosm-tag-reference" title="service=driveway · 서비스 도로·철도 세부 유형=건물·부지 진입로">driveway</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="서비스 도로·철도 세부 유형">[[Key: service|service]]</code> || 서비스 도로·철도 세부 유형 || '''OSM 태그''' || 교통과 길 || 길 || highway=service 또는 철도 선로에 세부 용도를 덧붙입니다. || <code class="kosm-tag-reference" title="service=parking_aisle · 서비스 도로·철도 세부 유형=주차 구획 사이 통로">parking_aisle</code>, <code class="kosm-tag-reference" title="service=alley · 서비스 도로·철도 세부 유형=골목·후면 통로">alley</code>, <code class="kosm-tag-reference" title="service=driveway · 서비스 도로·철도 세부 유형=건물·부지 진입로">driveway</code> | ||
| 275번째 줄: | 275번째 줄: | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use]]</code> || 현재 건물 이용 방식 || '''OSM 태그''' || 건물과 출입구 || 건물 면 || 건물의 건축적 유형이나 원래 목적과 구분하여 현재 건물이 어떤 용도로 사용되는지 기록합니다. || <code class="kosm-tag-reference" title="building:use=residential · 현재 건물 이용 방식=주거용으로 사용">residential</code>, <code class="kosm-tag-reference" title="building:use=apartments · 현재 건물 이용 방식=공동주택으로 사용">apartments</code>, <code class="kosm-tag-reference" title="building:use=commercial · 현재 건물 이용 방식=상업용으로 사용">commercial</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use]]</code> || 현재 건물 이용 방식 || '''OSM 태그''' || 건물과 출입구 || 건물 면 || 건물의 건축적 유형이나 원래 목적과 구분하여 현재 건물이 어떤 용도로 사용되는지 기록합니다. || <code class="kosm-tag-reference" title="building:use=residential · 현재 건물 이용 방식=주거용으로 사용">residential</code>, <code class="kosm-tag-reference" title="building:use=apartments · 현재 건물 이용 방식=공동주택으로 사용">apartments</code>, <code class="kosm-tag-reference" title="building:use=commercial · 현재 건물 이용 방식=상업용으로 사용">commercial</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="주용도">[[Key: building:main_use|building:main_use]]</code> || 주용도 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="주용도">[[Key: building:main_use|building:main_use]]</code> || 주용도 || '''K-OSM 태그''' || 건물과 출입구 || 건물 면 || 건축허가 또는 건축물대장에서 확인한 건축물의 공식 주용도 분류명을 한글로 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="building:main_use=단독주택 · 주용도">단독주택</code>, <code class="kosm-tag-reference" title="building:main_use=공동주택 · 주용도">공동주택</code>, <code class="kosm-tag-reference" title="building:main_use=제1종근린생활시설 · 주용도">제1종근린생활시설</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건축물 구조 형식">[[Key: building:structure|building:structure]]</code> || 건축물 구조 형식 || '''OSM 태그''' · ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="건축물 구조 형식">[[Key: building:structure|building:structure]]</code> || 건축물 구조 형식 || '''OSM 태그''' · '''K-OSM 태그''' || 건물과 출입구 || 건물 면 || 건물의 시공 구조를 나타내는 사용 중인 OSM Key입니다. 사용 지역이 제한적이고 구조가 겉으로 확인되지 않는 경우가 많아 K-OSM 원자료 대응표가 필요합니다. || <code class="kosm-tag-reference" title="building:structure=unreinforced_masonry · 건축물 구조 형식=비보강 조적조">unreinforced_masonry</code>, <code class="kosm-tag-reference" title="building:structure=reinforced_concrete · 건축물 구조 형식=철근콘크리트조">reinforced_concrete</code>, <code class="kosm-tag-reference" title="building:structure=steel_frame · 건축물 구조 형식=철골조">steel_frame</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels]]</code> || 지상층수 || '''OSM 태그''' || 건물과 출입구 || 건물 면 || 지표면 위에서 보이는 건물 층수를 숫자로 기록합니다. || <code class="kosm-tag-reference" title="building:levels=1 · 지상층수">1</code>, <code class="kosm-tag-reference" title="building:levels=2 · 지상층수">2</code>, <code class="kosm-tag-reference" title="building:levels=3 · 지상층수">3</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels]]</code> || 지상층수 || '''OSM 태그''' || 건물과 출입구 || 건물 면 || 지표면 위에서 보이는 건물 층수를 숫자로 기록합니다. || <code class="kosm-tag-reference" title="building:levels=1 · 지상층수">1</code>, <code class="kosm-tag-reference" title="building:levels=2 · 지상층수">2</code>, <code class="kosm-tag-reference" title="building:levels=3 · 지상층수">3</code> | ||
| 283번째 줄: | 283번째 줄: | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground]]</code> || 지하층수 || '''OSM 태그''' || 건물과 출입구 || 건물 면 || 지표면 아래에 있는 건물 층수를 양의 정수로 기록합니다. || <code class="kosm-tag-reference" title="building:levels:underground=0 · 지하층수">0</code>, <code class="kosm-tag-reference" title="building:levels:underground=1 · 지하층수">1</code>, <code class="kosm-tag-reference" title="building:levels:underground=2 · 지하층수">2</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground]]</code> || 지하층수 || '''OSM 태그''' || 건물과 출입구 || 건물 면 || 지표면 아래에 있는 건물 층수를 양의 정수로 기록합니다. || <code class="kosm-tag-reference" title="building:levels:underground=0 · 지하층수">0</code>, <code class="kosm-tag-reference" title="building:levels:underground=1 · 지하층수">1</code>, <code class="kosm-tag-reference" title="building:levels:underground=2 · 지하층수">2</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="연면적">[[Key: building:area:total|building:area:total]]</code> || 연면적 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="연면적">[[Key: building:area:total|building:area:total]]</code> || 연면적 || '''K-OSM 태그''' || 건물과 출입구 || 건물 면 || 건축물의 전체 층 바닥면적 합계인 연면적을 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="building:area:total=198 · 연면적">198</code>, <code class="kosm-tag-reference" title="building:area:total=59.5 · 연면적">59.5</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 대지면적">[[Key: building:area:ground|building:area:ground]]</code> || 건물 대지면적 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 대지면적">[[Key: building:area:ground|building:area:ground]]</code> || 건물 대지면적 || '''K-OSM 태그''' || 건물과 출입구 || 건물 면 || 건물대지면적을 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="building:area:ground=198 · 건물 대지면적">198</code>, <code class="kosm-tag-reference" title="building:area:ground=59.5 · 건물 대지면적">59.5</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건폐율(%)">[[Key: building:bcr|building:bcr]]</code> || 건폐율(%) || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="건폐율(%)">[[Key: building:bcr|building:bcr]]</code> || 건폐율(%) || '''K-OSM 태그''' || 건물과 출입구 || 건물·대지 || 대지면적에 대한 건축면적의 비율을 백분율로 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="building:bcr=59.88 · 건폐율(%)">59.88</code>, <code class="kosm-tag-reference" title="building:bcr=0 · 건폐율(%)">0</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="용적률(%)">[[Key: building:far|building:far]]</code> || 용적률(%) || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="용적률(%)">[[Key: building:far|building:far]]</code> || 용적률(%) || '''K-OSM 태그''' || 건물과 출입구 || 건물·대지 || 대지면적에 대한 연면적의 비율을 백분율로 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="building:far=100 · 용적률(%)">100</code>, <code class="kosm-tag-reference" title="building:far=50 · 용적률(%)">50</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="소속 건물부지 이름">[[Key: eqb:name|eqb:name]]</code> || 소속 건물부지 이름 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="소속 건물부지 이름">[[Key: eqb:name|eqb:name]]</code> || 소속 건물부지 이름 || '''K-OSM 태그''' || 건물과 출입구 || 건물 면 || 건물이 속한 건물부지·건물군의 이름을 그 부지 안의 개별 건물에 기록하는 K-OSM 자체 Key입니다. 건물 자체의 이름을 담는 <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=*]]</code>과 구분합니다. || <code class="kosm-tag-reference" title="eqb:name=한마음아파트 · 소속 건물부지 이름">한마음아파트</code>, <code class="kosm-tag-reference" title="eqb:name=예시산업단지 · 소속 건물부지 이름">예시산업단지</code>, <code class="kosm-tag-reference" title="eqb:name=예시대학교 · 소속 건물부지 이름">예시대학교</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="특별·광역·시도">[[Key: addr:city|addr:city]]</code> || 특별·광역·시도 || '''OSM 태그''' '''의미 변형''' || 이름·주소·운영 정보 || 주로 노드·면 || OSM의 addr:city를 | | <code class="kosm-tag-reference kosm-tag-reference--link" title="특별·광역·시도">[[Key: addr:city|addr:city]]</code> || 특별·광역·시도 || '''OSM 태그''' '''의미 변형''' || 이름·주소·운영 정보 || 주로 노드·면 || OSM의 addr:city를 K-OSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다. || <code class="kosm-tag-reference" title="addr:city=서울특별시 · 특별·광역·시도">서울특별시</code>, <code class="kosm-tag-reference" title="addr:city=경기도 · 특별·광역·시도">경기도</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="시·군·구">[[Key: addr:district|addr:district]]</code> || 시·군·구 || '''OSM 태그''' '''의미 변형''' || 이름·주소·운영 정보 || 주로 노드·면 || OSM의 addr:district를 | | <code class="kosm-tag-reference kosm-tag-reference--link" title="시·군·구">[[Key: addr:district|addr:district]]</code> || 시·군·구 || '''OSM 태그''' '''의미 변형''' || 이름·주소·운영 정보 || 주로 노드·면 || OSM의 addr:district를 K-OSM 주소 체계에서는 시·군·구 단위로 의미를 변형하여 적용합니다. || <code class="kosm-tag-reference" title="addr:district=서구 · 시·군·구">서구</code>, <code class="kosm-tag-reference" title="addr:district=제주시 · 시·군·구">제주시</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="읍·면·동">[[Key: addr:subdistrict|addr:subdistrict]]</code> || 읍·면·동 || '''OSM 태그''' '''의미 변형''' || 이름·주소·운영 정보 || 주로 노드·면 || OSM의 addr:subdistrict를 | | <code class="kosm-tag-reference kosm-tag-reference--link" title="읍·면·동">[[Key: addr:subdistrict|addr:subdistrict]]</code> || 읍·면·동 || '''OSM 태그''' '''의미 변형''' || 이름·주소·운영 정보 || 주로 노드·면 || OSM의 addr:subdistrict를 K-OSM 주소 체계에서는 읍·면·동 단위로 의미를 변형하여 적용합니다. || <code class="kosm-tag-reference" title="addr:subdistrict=신림동 · 읍·면·동">신림동</code>, <code class="kosm-tag-reference" title="addr:subdistrict=애월읍 · 읍·면·동">애월읍</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="리">[[Key: addr:plotarea|addr:plotarea]]</code> || 리 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="리">[[Key: addr:plotarea|addr:plotarea]]</code> || 리 || '''K-OSM 태그''' || 이름·주소·운영 정보 || 주로 노드·면 || 지번 주소가 속한 리 단위 지역명을 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="addr:plotarea=읍내리 · 리">읍내리</code>, <code class="kosm-tag-reference" title="addr:plotarea=용산리 · 리">용산리</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="지번">[[Key: addr:plotnumber|addr:plotnumber]]</code> || 지번 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="지번">[[Key: addr:plotnumber|addr:plotnumber]]</code> || 지번 || '''K-OSM 태그''' || 이름·주소·운영 정보 || 주로 노드·면 || 한국 지번 주소의 본번과 부번을 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="addr:plotnumber=300 · 지번">300</code>, <code class="kosm-tag-reference" title="addr:plotnumber=313-173 · 지번">313-173</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="도로명">[[Key: addr:street|addr:street]]</code> || 도로명 || '''OSM 태그''' || 이름·주소·운영 정보 || 주로 노드·면 || 주소가 속한 도로의 이름을 기록합니다. || <code class="kosm-tag-reference" title="addr:street=세종대로 · 도로명">세종대로</code>, <code class="kosm-tag-reference" title="addr:street=오리로 · 도로명">오리로</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="도로명">[[Key: addr:street|addr:street]]</code> || 도로명 || '''OSM 태그''' || 이름·주소·운영 정보 || 주로 노드·면 || 주소가 속한 도로의 이름을 기록합니다. || <code class="kosm-tag-reference" title="addr:street=세종대로 · 도로명">세종대로</code>, <code class="kosm-tag-reference" title="addr:street=오리로 · 도로명">오리로</code> | ||
| 317번째 줄: | 317번째 줄: | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="주방 운영시간">[[Key: opening_hours:kitchen|opening_hours:kitchen]]</code> || 주방 운영시간 || '''OSM 태그''' || 이름·주소·운영 정보 || 음식점 노드·면 || 시설 전체 영업시간과 다른 경우 음식 주문이나 주방 운영이 가능한 시간을 기록합니다. || <code class="kosm-tag-reference" title="opening_hours:kitchen=Mo-Su 11:00-21:00 · 주방 운영시간">Mo-Su 11:00-21:00</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="주방 운영시간">[[Key: opening_hours:kitchen|opening_hours:kitchen]]</code> || 주방 운영시간 || '''OSM 태그''' || 이름·주소·운영 정보 || 음식점 노드·면 || 시설 전체 영업시간과 다른 경우 음식 주문이나 주방 운영이 가능한 시간을 기록합니다. || <code class="kosm-tag-reference" title="opening_hours:kitchen=Mo-Su 11:00-21:00 · 주방 운영시간">Mo-Su 11:00-21:00</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="주차 가능 여부">[[Key: parking:available|parking:available]]</code> || 주차 가능 여부 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="주차 가능 여부">[[Key: parking:available|parking:available]]</code> || 주차 가능 여부 || '''K-OSM 태그''' || POI 확장 Key || 주로 POI || 해당 장소에서 주차가 가능한지 나타내는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="parking:available=yes · 주차 가능 여부=주차 가능">yes</code>, <code class="kosm-tag-reference" title="parking:available=no · 주차 가능 여부=주차 불가">no</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="미쉐린 가이드 선정">[[Key: award:michelin|award:michelin]]</code> || 미쉐린 가이드 선정 || '''OSM 태그''' || POI 확장 Key || 노드·길·면·관계 || 미쉐린 가이드가 준 등급을 기록합니다. 스타는 개수를 숫자로 적고, 빕 구르망과 셀렉티드는 각각 별도 값으로 구분합니다. || <code class="kosm-tag-reference" title="award:michelin=1 · 미쉐린 가이드 선정=1스타">1</code>, <code class="kosm-tag-reference" title="award:michelin=2 · 미쉐린 가이드 선정=2스타">2</code>, <code class="kosm-tag-reference" title="award:michelin=3 · 미쉐린 가이드 선정=3스타">3</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="미쉐린 가이드 선정">[[Key: award:michelin|award:michelin]]</code> || 미쉐린 가이드 선정 || '''OSM 태그''' || POI 확장 Key || 노드·길·면·관계 || 미쉐린 가이드가 준 등급을 기록합니다. 스타는 개수를 숫자로 적고, 빕 구르망과 셀렉티드는 각각 별도 값으로 구분합니다. || <code class="kosm-tag-reference" title="award:michelin=1 · 미쉐린 가이드 선정=1스타">1</code>, <code class="kosm-tag-reference" title="award:michelin=2 · 미쉐린 가이드 선정=2스타">2</code>, <code class="kosm-tag-reference" title="award:michelin=3 · 미쉐린 가이드 선정=3스타">3</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="미쉐린 선정 근거 주소">[[Key: michelin:url|michelin:url]]</code> || 미쉐린 선정 근거 주소 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="미쉐린 선정 근거 주소">[[Key: michelin:url|michelin:url]]</code> || 미쉐린 선정 근거 주소 || '''K-OSM 태그''' || POI 확장 Key || 주로 POI || 미쉐린 선정 결과를 확인할 수 있는 공식 페이지 주소를 기록하는 K-OSM 자체 Key입니다. || <code class="kosm-tag-reference" title="michelin:url=https://guide.michelin.com/ko/kr/restaurant/example · 미쉐린 선정 근거 주소">https://guide.michelin.com/ko/kr/restaurant/example</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="매체 소개 이력">[[Key: media:*|media:*]]</code> || 매체 소개 이력 || ''' | | <code class="kosm-tag-reference kosm-tag-reference--link" title="매체 소개 이력">[[Key: media:*|media:*]]</code> || 매체 소개 이력 || '''K-OSM 태그''' || POI 확장 Key || 주로 POI || 장소가 매체에 소개된 이력을 매체 종류별로 나누어 기록하는 K-OSM 자체 Key 묶음입니다. 방송은 <code class="kosm-tag-reference kosm-tag-reference--link" title="방송 소개 이력">[[Key: media:*|media:tv:*]]</code>처럼 매체 종류를 콜론 뒤에 두고 그 아래에서 세부 항목을 나눕니다. || <code class="kosm-tag-reference" title="media:tv:program=2TV생생정보 · 방송 프로그램 이름">2TV생생정보</code>, <code class="kosm-tag-reference" title="media:tv:date=2026-01-01 · 방영일">2026-01-01</code>, <code class="kosm-tag-reference" title="media:tv:menu=대표메뉴 · 방송에 소개된 메뉴">대표메뉴</code> | ||
|- | |- | ||
| <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류">[[Key: water|water]]</code> || 수역 종류 || '''OSM 태그''' || 토지·자연·수계 || natural=water 면 || natural=water로 표현한 수역의 구체적인 종류를 기록합니다. || <code class="kosm-tag-reference" title="water=reservoir · 수역 종류=저수지">reservoir</code>, <code class="kosm-tag-reference" title="water=lake · 수역 종류=호수">lake</code>, <code class="kosm-tag-reference" title="water=pond · 수역 종류=연못">pond</code> | | <code class="kosm-tag-reference kosm-tag-reference--link" title="수역 종류">[[Key: water|water]]</code> || 수역 종류 || '''OSM 태그''' || 토지·자연·수계 || natural=water 면 || natural=water로 표현한 수역의 구체적인 종류를 기록합니다. || <code class="kosm-tag-reference" title="water=reservoir · 수역 종류=저수지">reservoir</code>, <code class="kosm-tag-reference" title="water=lake · 수역 종류=호수">lake</code>, <code class="kosm-tag-reference" title="water=pond · 수역 종류=연못">pond</code> | ||
| 356번째 줄: | 356번째 줄: | ||
[[분류:KOSM 태그 사전]] | [[분류:KOSM 태그 사전]] | ||
2026년 8월 31일 (월) 14:18 기준 최신판
K-OSM에서 사용하는 태그를 중심으로 정리한 색인입니다. Key는 지물의 속성이나 큰 분류를 정하고, Value는 그 안의 구체적인 종류나 값을 정합니다.
예를 들어 amenity Key 안에는 amenity=cafe, amenity=restaurant, amenity=parking 같은 태그가 있습니다. 아래 표에서 Key를 누르면 주요 Key=Value 목록과 사용 설명을 한 페이지에서 볼 수 있습니다.
태그 구분과 배지
이 사전은 각 Key가 OSM에서 사용하는 태그인지, 한국형 표현을 위해 K-OSM에서 자체 정의한 태그인지 먼저 구분합니다. K-OSM 태그도 OSM의 Key=Value 문법과 요소 구조를 따르지만, 의미와 Value 기준은 이 사전의 설명을 기준으로 확인합니다.
| 배지 | 구분 | 사용 기준 |
|---|---|---|
| OSM 태그 | OSM 사용 태그 | OSM Wiki에 문서화된 Key입니다. 승인·사실상 표준·사용 중 등 상태가 다를 수 있으므로 상세 페이지의 주의사항도 확인합니다. |
| OSM 태그 의미 변형 | OSM 기반·K-OSM 적용 | OSM Key를 사용하되 한국 주소·행정 체계에 맞게 적용 의미를 구체화합니다. |
| K-OSM 태그 | K-OSM 자체 | 한국형 데이터 표현을 위해 K-OSM에서 별도로 정의한 Key입니다. |
태그가 데이터에서 어떤 역할을 하는지 먼저 이해하려면 Understanding Map Features를 참고합니다.
OSM 태그 체계 전체는 OSM Wiki의 Map Features를 참고합니다.
분류 원칙
K-OSM에서는 Key를 ‘이 Key가 어떤 정보를 표현하는가’에 따라 다섯 가지로 나눕니다. 교통·건물·시설·자연·주소처럼 하나의 Key가 여러 분야에서 활용될 수 있으므로, 분야보다 데이터에서 맡는 역할을 기준으로 찾습니다.
처음 태그를 입력할 때는 먼저 대상이 무엇인지 나타내는 지물 핵심 Key를 선택하고, 이름·주소·운영시간·접근성 같은 세부 정보를 덧붙이면 됩니다.
예를 들어 음식점은 다음과 같이 입력할 수 있습니다.
| 입력 태그 | 나타내는 정보 |
|---|---|
amenity=restaurant |
대상이 음식점임을 정의합니다. |
name=○○식당 |
음식점의 이름을 나타냅니다. |
opening_hours=Mo-Su 10:00-22:00 |
매일 10시부터 22시까지 운영함을 나타냅니다. |
Key의 다섯 가지 역할
| 구분 | 역할 | 대표 Key |
|---|---|---|
| 지물 핵심 Key | 객체가 무엇인지 정의합니다. | highway, building, amenity, shop
|
| 공통 속성 Key | 여러 종류의 객체에 폭넓게 정보를 추가합니다. | name, ref, operator, source
|
| 조건부 공통 Key | 여러 객체에 쓸 수 있지만 필요한 조건에서만 사용합니다. | opening_hours, access, wheelchair, width
|
| 지물 종속 Key | 특정 종류의 객체에 연결해 세부 정보를 나타냅니다. | lanes, cuisine, building:levels
|
| 관계·구조 Key | 여러 객체의 관계나 데이터 구조를 정의합니다. | type=route, type=multipolygon
|
목차
- 1. 지물 핵심 Key — 객체가 무엇인지 정의하는 중심 Key입니다.
- 2. 공통 속성 Key — 여러 종류의 객체에 이름·식별·운영·물리 정보를 폭넓게 추가합니다.
- 3. 조건부 공통 Key — 여러 분야에서 사용할 수 있지만, 실제 대상과 적용 조건을 먼저 확인해야 합니다.
- 4. 지물 종속 Key — 특정 지물 핵심 Key와 함께 사용할 때 의미가 분명해지는 세부 Key입니다.
- 5. 관계·구조 Key — 여러 요소를 묶거나 관계의 데이터 구조를 정의합니다.
Key 목록 읽는 법
각 표의 ‘주요 지물’은 Key가 주로 사용되는 대상을, ‘적용 형태’는 일반적으로 적용되는 노드·길·면·관계를 보여줍니다. 표는 대표적인 사용법을 안내하므로, 세부 조건과 예외는 Key를 눌러 상세 설명에서 확인합니다.
name:*, cycleway:*, lanes:*처럼 *가 붙은 표기는 하나의 Key가 아니라 같은 문법으로 확장되는 Key 묶음입니다. 예를 들어 name:ko=*는 한국어 이름, cycleway:right=*는 진행 방향 기준 오른쪽의 자전거 통행 공간, lanes:forward=*는 정방향 차로 수를 나타냅니다.
아래 목록은 태그를 외우기 위한 구분이 아니라, 대상의 종류를 먼저 정하고 필요한 정보를 하나씩 덧붙이는 순서로 Key를 쉽게 찾을 수 있도록 구성했습니다.
각 구분 안에서는 성격과 적용 대상이 비슷한 Key를 이어서 놓고, 같은 주제 안에서는 넓은 개념에서 세부 개념으로 내려갑니다. 예를 들어 주소는 addr:city에서 시작해 addr:housenumber까지 좁혀지고, 건물 정보는 용도에서 구조·층수·면적 순으로 이어집니다.
1. 지물 핵심 Key
객체가 무엇인지 정의하는 중심 Key입니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
highway |
도로·보행로 | OSM 태그 | 교통과 길 | 주로 | 도로와 길을 기능과 네트워크상 중요도에 따라 분류하며, 버스 정류소처럼 도로와 관련된 노드에도 사용합니다. | motorway, trunk, primary
|
railway |
철도 | OSM 태그 | 교통과 길 | 철도 선로, 역, 승강장과 지하철 출입구 등 철도 시설을 분류합니다. | rail, subway, light_rail
| |
public_transport |
대중교통 | OSM 태그 | 교통과 길 | 정류장, 승강장, 역처럼 대중교통 체계를 구성하는 요소를 표현하는 범용 OSM Key입니다. | platform, stop_position, station
| |
aeroway |
항공 시설 | OSM 태그 | 토지·자연·수계 | 공항, 활주로, 헬리패드 등 항공 운항 시설을 분류합니다. | helipad, aerodrome, runway
| |
waterway |
하천·수로 | OSM 태그 | 교통과 길 | 주로 | 물이 흐르는 강·하천·도랑과 수리 구조물을 표현합니다. | stream, ditch, drain
|
building |
건물 | OSM 태그 | 건물과 출입구 | 주로 | 지붕이 있고 한 위치에 지속적으로 존재하는 구조물의 외곽과 물리적 유형을 나타냅니다. | house, apartments, residential
|
entrance |
건물 출입구 | OSM 태그 | 건물과 출입구 | 건물이나 시설에 들어가는 실제 위치와 출입구 종류를 나타냅니다. | main, yes, secondary
| |
amenity |
공공·생활 편의시설 | OSM 태그 | 생활시설과 POI | 주로 | 방문자와 거주자가 이용하는 음식·교육·공공·교통·편의 시설을 분류합니다. | restaurant, school, fast_food
|
shop |
상점 유형 | OSM 태그 | 생활시설과 POI | 주로 | 상품을 판매하거나 소비자 대상 서비스를 제공하는 상점의 업종을 분류합니다. | hairdresser, clothes, supermarket
|
craft |
수리·제작업 | OSM 태그 | 생활시설과 POI | 주로 | 장인·기술자가 제작, 수리 또는 전문 작업을 제공하는 업종을 분류합니다. | signmaker, cleaning, electronics_repair
|
office |
사무 시설 | OSM 태그 | 생활시설과 POI | 주로 | 기업·전문 서비스·공공기관 사무소의 업무 분야를 분류합니다. | company, estate_agent, consulting
|
healthcare |
의료·보건 | OSM 태그 | 생활시설과 POI | 주로 | 의료기관과 보건 서비스를 전문 분야에 따라 분류합니다. | alternative, laboratory, psychotherapist
|
education |
교육 시설 세부 분류 | OSM 태그 | 생활시설과 POI | 주로 | 교육 시설의 유형을 분류합니다. OSM에서는 당분간 기존 amenity=* 교육 태그와 함께 사용하는 것을 권장합니다. | school, university, kindergarten
|
tourism |
관광 시설 | OSM 태그 | 생활시설과 POI | 주로 | 숙박시설, 관광 명소, 안내시설과 여행자를 위한 시설을 분류합니다. | guest_house, motel, attraction
|
leisure |
여가·휴식 시설 | OSM 태그 | 생활시설과 POI | 공원, 놀이터, 체육시설과 여가 활동 공간을 분류합니다. | fitness_centre, sports_centre, pitch
| |
club |
클럽·동호회 | OSM 태그 | 생활시설과 POI | 주로 | 특정 장소에서 정기적으로 모이는 클럽·동호회의 활동 분야를 정의하는 지물 핵심 Key입니다. 실제 장소의 물리적 용도가 별도로 확인되면 해당 시설 태그도 함께 기록합니다. | sport, social, scout
|
landuse |
토지 이용 | OSM 태그 | 토지·자연·수계 | 주로 | 토지가 주거·산업·농업·녹지 등 어떤 목적으로 이용되는지 나타냅니다. | grass, forest, meadow
|
natural |
자연 지물 | OSM 태그 | 토지·자연·수계 | 수역, 숲, 관목지, 습지, 해안선 등 자연적으로 형성된 지물을 분류합니다. | wood, water, scrub
| |
geological |
지질 지물 | OSM 태그 | 토지·자연·수계 | 주로 | 노두·단층·싱크홀처럼 지질학적으로 구분되는 자연 지물을 표현합니다. | outcrop, sinkhole
|
man_made |
인공 구조물 | OSM 태그 | 토지·자연·수계 | 특정 기능을 위해 사람이 만든 구조물과 설비를 분류합니다. | clarifier, spoil_heap, reservoir_covered
| |
historic |
역사 지물 | OSM 태그 | 토지·자연·수계 | 역사적·문화적 의미가 있는 유적과 구조물을 분류합니다. | tomb, archaeological_site, monument
| |
military |
군사 시설 | OSM 태그 | 토지·자연·수계 | 공개적으로 확인 가능한 군사 목적의 시설이나 구역 유형을 표현합니다. | base, danger_area
| |
place |
장소·정착지 | OSM 태그 | 경계·장벽·관계 | 도시·마을·섬·광장처럼 지리적으로 이름 붙은 장소의 유형을 나타냅니다. | city, town, village
| |
boundary |
경계 유형 | OSM 태그 | 경계·장벽·관계 | 행정구역, 보호구역, 우편구역 등 관리되거나 정의된 경계의 종류를 나타냅니다. | administrative, national_park, protected_area
| |
barrier |
장벽·통제 시설 | OSM 태그 | 경계·장벽·관계 | 이동을 물리적으로 막거나 통제하는 울타리, 벽, 문과 경계 구조물을 분류합니다. | fence, wall, kerb
|
2. 공통 속성 Key
여러 종류의 객체에 이름·식별·운영·물리 정보를 폭넓게 추가합니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
name |
이름 | OSM 태그 | 이름·주소·운영 정보 | 지물에 현장에서 실제로 쓰이는 고유 이름을 기록합니다. 공식 명칭이 따로 있다면 official_name=*으로 나눕니다. | 광명역, 한강
| |
name:* |
언어별 이름 | OSM 태그 | 이름·주소·운영 정보 | name:ko, name:ja, name:zh처럼 언어 코드를 붙여 같은 지물의 언어별 이름을 기록합니다. | 서울역, ソウル駅, 首尔站
| |
alt_name |
대체 이름 | OSM 태그 | 이름·주소·운영 정보 | 공식 대표 이름은 아니지만 널리 쓰이는 다른 이름이나 표기를 기록합니다. 언어별 표기는 alt_name:*로 확장합니다. | 남산타워
| |
official_name |
공식 명칭 | OSM 태그 | 이름·주소·운영 정보 | name보다 길거나 일상적으로 덜 쓰이는 법정·공식 명칭을 기록합니다. | 대한민국 국회의사당
| |
old_name |
이전 이름 | OSM 태그 | 이름·주소·운영 정보 | 현재는 사용하지 않는 과거의 이름을 기록합니다. 언어별 표기는 old_name:*로 확장합니다. | 구 명칭
| |
ref |
참조 번호 | OSM 태그 | 이름·주소·운영 정보 | 도로 번호, 노선 번호, 출입구 번호처럼 대상에 부여된 공식 식별 번호를 기록합니다. | 1, 17
| |
operator |
운영 주체 | OSM 태그 | 이름·주소·운영 정보 | 시설이나 서비스를 실제로 운영하는 기관·회사·단체의 이름을 기록합니다. | 한국철도공사, 서울교통공사
| |
brand |
브랜드 | OSM 태그 | 생활시설과 POI | 주로 | 매장이나 시설이 속한 브랜드 이름을 기록하는 범용 OSM Key입니다. | 스타벅스
|
wikidata |
Wikidata 식별자 | OSM 태그 | 이름·주소·운영 정보 | 지물과 일치하는 Wikidata 항목의 Q 식별자를 기록합니다. | Q8684
| |
wikipedia |
Wikipedia 문서 | OSM 태그 | 이름·주소·운영 정보 | 지물을 직접 설명하는 Wikipedia 문서를 언어 코드와 문서 제목으로 연결합니다. | ko:서울역
| |
phone |
전화번호 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설의 대표 전화번호를 국제 표기 형식으로 기록하는 자유 입력 Key입니다. | +82-2-1234-5678
|
email |
이메일 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설·기관의 공개 연락용 이메일 주소를 기록하는 범용 OSM Key입니다. | info@example.com
|
website |
웹사이트 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설·기관의 공식 웹사이트 주소를 기록합니다. | https://example.com
|
opening_hours |
운영시간 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설이나 장소가 문을 여는 요일과 시간을 OSM 운영시간 문법으로 기록합니다. | Mo-Su 10:00-22:00, Mo-Sa 11:00-21:00; Su off, 24/7
|
start_date |
존재·사용 시작 시점 | OSM 태그 | 건물과 출입구 | 지물이 현재 형태로 존재하거나 사용되기 시작한 시점을 알려진 정밀도만큼 기록합니다. 건물 사용승인일은 그 시점을 나타내는 경우에만 사용합니다. | 1978-01-01, 1960
| |
height |
높이(미터) | OSM 태그 | 건물과 출입구 | 지물의 전체 높이를 기록합니다. 단위가 없으면 미터로 해석합니다. | 4, 4.5, 8
| |
width |
폭 | OSM 태그 | 교통과 길 | 도로·길·수로·구조물 등의 실제 폭을 기본적으로 미터 단위로 기록합니다. | 3, 1.5
| |
description |
보충 설명 | OSM 태그 | 이름·주소·운영 정보 | 다른 구조화된 태그만으로 설명하기 어려운 유용한 정보를 짧은 문장으로 기록합니다. | 보행자 전용 출입구
|
3. 조건부 공통 Key
여러 분야에서 사용할 수 있지만, 실제 대상과 적용 조건을 먼저 확인해야 합니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
access |
일반 접근 조건 | OSM 태그 | 접근성과 이용 조건 | 대상에 출입하거나 통행할 수 있는 이용자의 일반 범위를 기록합니다. | yes, no, private
| |
foot |
보행 접근 | OSM 태그 | 접근성과 이용 조건 | 주로 | 보행자의 통행 가능 여부와 지정 상태를 기록합니다. | yes, no, designated
|
bicycle |
자전거 접근 | OSM 태그 | 접근성과 이용 조건 | 주로 | 자전거의 통행 가능 여부와 지정 상태를 기록합니다. | yes, no, designated
|
bus |
버스 이용 지정 | OSM 태그 | 교통과 길 | 정류소·차로·노선 등이 버스 교통에 적용되는지 나타냅니다. | yes, designated
| |
wheelchair |
휠체어 접근성 | OSM 태그 | 접근성과 이용 조건 | 휠체어 이용자가 시설이나 경로를 이용할 수 있는 정도를 기록합니다. | yes, no, limited
| |
location |
위치 | OSM 태그 | 건물과 출입구 | 지물이 지하·지상·해상 등 어느 환경에 위치하는지 기록합니다. | underground, offshore
| |
level |
OSM 층 레벨 | OSM 태그 | 이름·주소·운영 정보 | 실내 시설이나 출입구의 층을 0 기준으로 기록합니다. 지상 기준층은 0, 그 위층은 1, 첫 지하층은 -1입니다. | 0, 1, -1
| |
layer |
레이어 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 교량·터널처럼 지물이 서로 교차할 때 상대적인 위아래 순서를 나타냅니다. 실제 층수나 높이를 뜻하지 않습니다. | 1, 0, -1
|
area |
면 해석 지정 | OSM 태그 | 건물과 출입구 | 닫힌 길을 선이 아니라 면으로 해석하거나, 반대로 선으로 해석하도록 명시합니다. | yes, no
| |
bridge |
교량 | OSM 태그 | 교통과 길 | 길·철도·수로가 다른 지물 위를 통과하는 교량 구간임을 나타냅니다. | yes, viaduct, boardwalk
| |
tunnel |
터널 | OSM 태그 | 교통과 길 | 길·철도·수로가 지하나 구조물 아래를 통과하는 구간임을 나타냅니다. | yes, culvert, building_passage
| |
surface |
표면 재질 | OSM 태그 | 교통과 길 | 주로 | 도로·길·공간의 표면 포장 재질을 기록합니다. | asphalt, concrete, unpaved
|
smoothness |
통행 가능 수준 | OSM 태그 | 교통과 길 | 주로 | 표면의 물리적 상태를 기준으로 어떤 차량이나 이동수단이 통행할 수 있는지 나타냅니다. | excellent, good, intermediate
|
lit |
조명 여부 | OSM 태그 | 교통과 길 | 길이나 공간이 야간에 조명되는지 기록합니다. | yes, no, automatic
| |
oneway |
일방통행 | OSM 태그 | 교통과 길 | 길의 진행 방향을 기준으로 통행 가능한 방향을 기록합니다. | yes, no, -1
| |
intermittent |
간헐성 | OSM 태그 | 토지·자연·수계 | 계절이나 강수 조건에 따라 물이 마르거나 흐름이 끊기는 지물인지 나타냅니다. | yes, no
| |
branch |
지점명 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 체인점·기관의 공통 name 또는 brand와 구분되는 개별 지점명을 기록합니다. | 강남역점, 본점
|
takeaway |
포장 | OSM 태그 | 접근성과 이용 조건 | 주로 | 주문한 음식이나 상품을 포장해 가져갈 수 있는지 기록합니다. | yes, no, only
|
delivery |
배달 | OSM 태그 | 접근성과 이용 조건 | 주로 | 음식점·상점이 배달 서비스를 제공하는지 기록합니다. | yes, no, only
|
drive_through |
드라이브스루 | OSM 태그 | 접근성과 이용 조건 | 주로 | 차량에서 내리지 않고 주문·수령할 수 있는 시설인지 기록합니다. | yes, no
|
reservation |
예약 | OSM 태그 | 접근성과 이용 조건 | 주로 | 시설이나 서비스의 사전 예약 가능 여부를 기록합니다. | yes, no, required
|
toilets |
화장실 제공 여부 | OSM 태그 | 접근성과 이용 조건 | 주로 | 시설 이용자를 위한 화장실이 있는지 기록합니다. 독립된 공중화장실은 amenity=toilets로 표현합니다. | yes, no
|
internet_access |
인터넷 이용 | OSM 태그 | 접근성과 이용 조건 | 주로 | 방문자가 이용할 수 있는 인터넷 접속 방식과 제공 여부를 기록합니다. | wlan, yes, no
|
waiting_area |
대기 공간 | K-OSM 태그 | POI 확장 Key | 주로 | 방문자를 위한 대기 공간이 있는지 나타내는 K-OSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. | yes, no
|
valet_parking |
발레파킹 | K-OSM 태그 | POI 확장 Key | 주로 | 발레파킹 서비스 제공 여부를 나타내는 K-OSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. | yes, no
|
group_friendly |
단체 이용 적합 | K-OSM 태그 | POI 확장 Key | 주로 | 단체 방문이나 모임에 적합한 장소인지 나타내는 K-OSM 자체 Key입니다. | yes, no
|
kids |
어린이 이용 조건 | K-OSM 태그 | POI 확장 Key | 주로 | 어린이 이용 가능 여부와 이용 정책을 나타내는 K-OSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. | yes, no
|
kids_area |
어린이 놀이 공간 | OSM 태그 | POI 확장 Key | 주로 | 시설에 어린이가 놀 수 있는 공간이 마련되어 있는지 나타냅니다. 공간의 정도에 따라 네 가지 Value로 나눕니다. | yes, designated, limited
|
highchair |
유아용 의자 | OSM 태그 | 접근성과 이용 조건 | 주로 | 어린이를 위한 유아용 높은 의자를 제공하는지 기록합니다. | yes, no
|
dog |
반려견 이용 조건 | OSM 태그 | 접근성과 이용 조건 | 반려견의 출입 가능 여부와 목줄 조건을 기록합니다. | yes, no, leashed
| |
check_date |
최근 확인일 | OSM 태그 | 이름·주소·운영 정보 | 해당 지물이나 특정 속성을 마지막으로 확인한 날짜를 기록합니다. | 2026-08-21
| |
fixme |
확인·수정 필요 | OSM 태그 | 이름·주소·운영 정보 | 현장 확인이나 후속 수정이 필요한 문제를 다른 편집자에게 알립니다. | 도로 연결 상태 현장 확인 필요
|
4. 지물 종속 Key
특정 지물 핵심 Key와 함께 사용할 때 의미가 분명해지는 세부 Key입니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
road:class |
국내 도로 구분 | K-OSM 태그 | 교통과 길 | 도로의 법적·행정적 구분과 이를 보완하는 도로 유형을 기록하는 K-OSM 자체 Key입니다. highway=*가 붙은 도로에만 함께 사용합니다. |
고속국도, 일반국도, 지방도
| |
service |
서비스 도로·철도 세부 유형 | OSM 태그 | 교통과 길 | highway=service 또는 철도 선로에 세부 용도를 덧붙입니다. | parking_aisle, alley, driveway
| |
tracktype |
작업로 노면 등급 | OSM 태그 | 교통과 길 | highway=track의 표면 견고성과 상태를 grade1부터 grade5까지 구분합니다. | grade1, grade2, grade3
| |
lanes |
차로 수 | OSM 태그 | 교통과 길 | 해당 도로 구간에서 일반 차량이 이용하는 전체 차로 수를 숫자로 기록합니다. | 1, 2, 3
| |
lanes:* |
방향·차종별 차로 | OSM 태그 | 교통과 길 | 진행 방향이나 버스·대중교통 차종별 차로 수와 조건을 기본 lanes Key에서 확장해 기록합니다. | 2, 1, 1
| |
sidewalk |
보도 배치 | OSM 태그 | 교통과 길 | 도로와 나란히 있는 보도의 위치 또는 별도 매핑 여부를 기록합니다. | both, left, right
| |
cycleway:* |
자전거도로 세부 속성 | OSM 태그 | 교통과 길 | 도로의 좌우·양측 자전거 통행 공간, 방향, 분리 여부와 표면을 세부 Key로 기록합니다. | lane, track, asphalt
| |
crossing |
횡단 시설 | OSM 태그 | 교통과 길 | 주로 | 보행자·자전거 이용자가 길을 건너는 지점의 통제 방식과 표시 상태를 나타냅니다. | marked, uncontrolled, traffic_signals
|
maxspeed |
최고 제한속도 | OSM 태그 | 교통과 길 | 법정 또는 표지로 지정된 최고 속도를 기록합니다. 단위가 없으면 일반적으로 km/h로 해석합니다. | 30, 50, 60
| |
destination:* |
방향별 목적지 안내 | OSM 태그 | 교통과 길 | 도로 표지에 표시된 목적지·도로번호·방향 정보를 진행 방향과 차로별로 기록합니다. | 서울, 1, airport
| |
gauge |
철도 궤간 | OSM 태그 | 교통과 길 | 두 레일 사이의 궤간을 밀리미터 단위로 기록합니다. | 1435, 1000
| |
electrified |
철도 전철화 방식 | OSM 태그 | 교통과 길 | 철도에 전력이 공급되는 방식과 전철화 여부를 나타냅니다. | contact_line, no
| |
voltage |
전압 | OSM 태그 | 교통과 길 | 전철화 선로나 전력 시설의 공칭 전압을 볼트 단위로 기록합니다. | 25000, 1500
| |
frequency |
전기 주파수 | OSM 태그 | 교통과 길 | 교류 전원의 주파수를 헤르츠 단위로 기록하며 직류는 0으로 표현합니다. | 60, 0
| |
building:use |
현재 건물 이용 방식 | OSM 태그 | 건물과 출입구 | 건물의 건축적 유형이나 원래 목적과 구분하여 현재 건물이 어떤 용도로 사용되는지 기록합니다. | residential, apartments, commercial
| |
building:main_use |
주용도 | K-OSM 태그 | 건물과 출입구 | 건축허가 또는 건축물대장에서 확인한 건축물의 공식 주용도 분류명을 한글로 기록하는 K-OSM 자체 Key입니다. | 단독주택, 공동주택, 제1종근린생활시설
| |
building:structure |
건축물 구조 형식 | OSM 태그 · K-OSM 태그 | 건물과 출입구 | 건물의 시공 구조를 나타내는 사용 중인 OSM Key입니다. 사용 지역이 제한적이고 구조가 겉으로 확인되지 않는 경우가 많아 K-OSM 원자료 대응표가 필요합니다. | unreinforced_masonry, reinforced_concrete, steel_frame
| |
building:levels |
지상층수 | OSM 태그 | 건물과 출입구 | 지표면 위에서 보이는 건물 층수를 숫자로 기록합니다. | 1, 2, 3
| |
building:levels:underground |
지하층수 | OSM 태그 | 건물과 출입구 | 지표면 아래에 있는 건물 층수를 양의 정수로 기록합니다. | 0, 1, 2
| |
building:area:total |
연면적 | K-OSM 태그 | 건물과 출입구 | 건축물의 전체 층 바닥면적 합계인 연면적을 기록하는 K-OSM 자체 Key입니다. | 198, 59.5
| |
building:area:ground |
건물 대지면적 | K-OSM 태그 | 건물과 출입구 | 건물대지면적을 기록하는 K-OSM 자체 Key입니다. | 198, 59.5
| |
building:bcr |
건폐율(%) | K-OSM 태그 | 건물과 출입구 | 대지면적에 대한 건축면적의 비율을 백분율로 기록하는 K-OSM 자체 Key입니다. | 59.88, 0
| |
building:far |
용적률(%) | K-OSM 태그 | 건물과 출입구 | 대지면적에 대한 연면적의 비율을 백분율로 기록하는 K-OSM 자체 Key입니다. | 100, 50
| |
eqb:name |
소속 건물부지 이름 | K-OSM 태그 | 건물과 출입구 | 건물이 속한 건물부지·건물군의 이름을 그 부지 안의 개별 건물에 기록하는 K-OSM 자체 Key입니다. 건물 자체의 이름을 담는 name=*과 구분합니다. |
한마음아파트, 예시산업단지, 예시대학교
| |
addr:city |
특별·광역·시도 | OSM 태그 의미 변형 | 이름·주소·운영 정보 | 주로 | OSM의 addr:city를 K-OSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다. | 서울특별시, 경기도
|
addr:district |
시·군·구 | OSM 태그 의미 변형 | 이름·주소·운영 정보 | 주로 | OSM의 addr:district를 K-OSM 주소 체계에서는 시·군·구 단위로 의미를 변형하여 적용합니다. | 서구, 제주시
|
addr:subdistrict |
읍·면·동 | OSM 태그 의미 변형 | 이름·주소·운영 정보 | 주로 | OSM의 addr:subdistrict를 K-OSM 주소 체계에서는 읍·면·동 단위로 의미를 변형하여 적용합니다. | 신림동, 애월읍
|
addr:plotarea |
리 | K-OSM 태그 | 이름·주소·운영 정보 | 주로 | 지번 주소가 속한 리 단위 지역명을 기록하는 K-OSM 자체 Key입니다. | 읍내리, 용산리
|
addr:plotnumber |
지번 | K-OSM 태그 | 이름·주소·운영 정보 | 주로 | 한국 지번 주소의 본번과 부번을 기록하는 K-OSM 자체 Key입니다. | 300, 313-173
|
addr:street |
도로명 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 주소가 속한 도로의 이름을 기록합니다. | 세종대로, 오리로
|
addr:housenumber |
건물번호 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 도로명주소의 건물번호를 기록합니다. | 110, 451-15
|
addr:unit |
건물 내부 단위 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 동·호처럼 하나의 주소 안에서 개별 점유 공간을 구분하는 단위를 기록합니다. 층은 level=* 또는 addr:floor=*로 따로 기록합니다. | 101호, 상가동
|
addr:postcode |
우편번호 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 해당 주소의 우편번호를 기록합니다. 대한민국은 2015년부터 5자리 국가기초구역번호를 사용합니다. | 04524, 14345
|
cuisine |
음식 종류 | OSM 태그 | 생활시설과 POI | 주로 | 음식점·카페가 주로 제공하는 음식의 종류를 기록합니다. Key는 OSM에서 널리 쓰이며, 현재 DB의 한국어 값 표준화 기준은 별도 확인이 필요합니다. | 한식, 중식당, 카페
|
sport |
스포츠 종목 | OSM 태그 | 생활시설과 POI | 체육시설에서 가능한 스포츠 종목을 기록하며 leisure 등의 주 분류 태그와 함께 사용합니다. | tennis, soccer, basketball
| |
opening_hours:kitchen |
주방 운영시간 | OSM 태그 | 이름·주소·운영 정보 | 시설 전체 영업시간과 다른 경우 음식 주문이나 주방 운영이 가능한 시간을 기록합니다. | Mo-Su 11:00-21:00
| |
parking:available |
주차 가능 여부 | K-OSM 태그 | POI 확장 Key | 주로 | 해당 장소에서 주차가 가능한지 나타내는 K-OSM 자체 Key입니다. | yes, no
|
award:michelin |
미쉐린 가이드 선정 | OSM 태그 | POI 확장 Key | 미쉐린 가이드가 준 등급을 기록합니다. 스타는 개수를 숫자로 적고, 빕 구르망과 셀렉티드는 각각 별도 값으로 구분합니다. | 1, 2, 3
| |
michelin:url |
미쉐린 선정 근거 주소 | K-OSM 태그 | POI 확장 Key | 주로 | 미쉐린 선정 결과를 확인할 수 있는 공식 페이지 주소를 기록하는 K-OSM 자체 Key입니다. | https://guide.michelin.com/ko/kr/restaurant/example
|
media:* |
매체 소개 이력 | K-OSM 태그 | POI 확장 Key | 주로 | 장소가 매체에 소개된 이력을 매체 종류별로 나누어 기록하는 K-OSM 자체 Key 묶음입니다. 방송은 media:tv:*처럼 매체 종류를 콜론 뒤에 두고 그 아래에서 세부 항목을 나눕니다. |
2TV생생정보, 2026-01-01, 대표메뉴
|
water |
수역 종류 | OSM 태그 | 토지·자연·수계 | natural=water로 표현한 수역의 구체적인 종류를 기록합니다. | reservoir, lake, pond
| |
wetland |
습지 유형 | OSM 태그 | 토지·자연·수계 | natural=wetland와 함께 갯벌·늪·갈대밭 등 습지의 유형을 나타냅니다. | tidalflat, swamp, marsh
| |
reservoir_type |
저수 시설 유형 | OSM 태그 | 토지·자연·수계 | 저수 시설의 용도를 나타내던 OSM Key입니다. 현재 DB 값은 폐기되어 새 입력에는 대체 태그를 사용해야 합니다. | water_storage, tailings
| |
leaf_type |
잎 형태 | OSM 태그 | 토지·자연·수계 | 나무·숲의 대표적인 잎 형태를 침엽수형과 활엽수형 등으로 구분합니다. | broadleaved, needleleaved
| |
leaf_cycle |
잎의 계절성 | OSM 태그 | 토지·자연·수계 | 식생이 상록성인지 낙엽성인지 기록합니다. | evergreen, deciduous
| |
admin_level |
행정 경계 단계 | OSM 태그 | 경계·장벽·관계 | 행정구역 경계의 위계 수준을 숫자로 기록합니다. 숫자가 작을수록 더 큰 행정 단위입니다. | 2, 4, 6
|
5. 관계·구조 Key
여러 요소를 묶거나 관계의 데이터 구조를 정의합니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
type |
관계 유형 | OSM 태그 | 경계·장벽·관계 | 관계가 노선·다중 영역·경계·통행 제한 중 어떤 구조인지 지정하는 OSM Key입니다. | multipolygon, boundary, route
| |
route |
노선 종류 | OSM 태그 | 경계·장벽·관계 | 버스·철도·도로·도보·자전거 등 여러 요소로 구성된 노선의 종류를 지정합니다. | hiking, bicycle, road
| |
route_master |
상위 노선 종류 | OSM 태그 | 경계·장벽·관계 | 같은 대중교통 노선의 방향별·운행 변형별 route 관계를 하나로 묶는 상위 관계에서 차량·노선 종류를 지정합니다. | bus, subway, train
| |
restriction |
통행 제한 종류 | OSM 태그 | 경계·장벽·관계 | 도로 교차부의 금지 또는 의무 통행 방향을 지정합니다. 관계 구성원에는 from·via·to 역할을 사용합니다. | no_left_turn, no_right_turn, no_u_turn
|
Key별 페이지는 이 색인의 표에서 열 수 있습니다. 세부 값과 적용 기준은 각 Key 문서의 편집 모드에서 계속 확장할 수 있습니다.