K-OSM Key 사전
KOSM에서 사용하는 태그를 중심으로 정리한 색인입니다. Key는 지물의 속성이나 큰 분류를 정하고, Value는 그 안의 구체적인 종류나 값을 정합니다.
예를 들어 amenity Key 안에는 amenity=cafe, amenity=restaurant, amenity=parking 같은 태그가 있습니다. 아래 표에서 Key를 누르면 주요 Key=Value 목록과 사용 설명을 한 페이지에서 볼 수 있습니다.
태그 구분과 배지
이 사전은 각 Key가 OSM에서 사용하는 태그인지, 한국형 표현을 위해 KOSM에서 자체 정의한 태그인지 먼저 구분합니다. KOSM 태그도 OSM의 Key=Value 문법과 요소 구조를 따르지만, 의미와 Value 기준은 이 사전의 설명을 기준으로 확인합니다.
| 배지 | 구분 | 사용 기준 |
|---|---|---|
| OSM 태그 | OSM 사용 태그 | OSM Wiki에 문서화된 Key입니다. 승인·사실상 표준·사용 중 등 상태가 다를 수 있으므로 상세 페이지의 주의사항도 확인합니다. |
| OSM 태그 의미 변형 | OSM 기반·KOSM 적용 | OSM Key를 사용하되 한국 주소·행정 체계에 맞게 적용 의미를 구체화합니다. |
| K-OSM 태그 | KOSM 자체 | 한국형 데이터 표현을 위해 KOSM에서 별도로 정의한 Key입니다. |
태그가 데이터에서 어떤 역할을 하는지 먼저 이해하려면 Understanding Map Features를 참고합니다.
OSM 태그 체계 전체는 OSM Wiki의 Map Features를 참고합니다.
분류 원칙
KOSM에서는 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를 쉽게 찾을 수 있도록 구성했습니다.
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
| |
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
|
office |
사무 시설 | OSM 태그 | 생활시설과 POI | 주로 | 기업·전문 서비스·공공기관 사무소의 업무 분야를 분류합니다. | company, estate_agent, consulting
|
craft |
수리·제작업 | OSM 태그 | 생활시설과 POI | 주로 | 장인·기술자가 제작, 수리 또는 전문 작업을 제공하는 업종을 분류합니다. | signmaker, cleaning, electronics_repair
|
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
| |
man_made |
인공 구조물 | OSM 태그 | 토지·자연·수계 | 특정 기능을 위해 사람이 만든 구조물과 설비를 분류합니다. | clarifier, spoil_heap, reservoir_covered
| |
historic |
역사 지물 | OSM 태그 | 토지·자연·수계 | 역사적·문화적 의미가 있는 유적과 구조물을 분류합니다. | tomb, archaeological_site, monument
| |
aeroway |
항공 시설 | OSM 태그 | 토지·자연·수계 | 공항, 활주로, 헬리패드 등 항공 운항 시설을 분류합니다. | helipad, aerodrome, runway
| |
geological |
지질 지물 | OSM 태그 | 토지·자연·수계 | 주로 | 노두·단층·싱크홀처럼 지질학적으로 구분되는 자연 지물을 표현합니다. | outcrop, sinkhole
|
military |
군사 시설 | OSM 태그 | 토지·자연·수계 | 공개적으로 확인 가능한 군사 목적의 시설이나 구역 유형을 표현합니다. | base, danger_area
| |
boundary |
경계 유형 | OSM 태그 | 경계·장벽·관계 | 행정구역, 보호구역, 우편구역 등 관리되거나 정의된 경계의 종류를 나타냅니다. | administrative, national_park, protected_area
| |
barrier |
장벽·통제 시설 | OSM 태그 | 경계·장벽·관계 | 이동을 물리적으로 막거나 통제하는 울타리, 벽, 문과 경계 구조물을 분류합니다. | fence, wall, kerb
| |
place |
장소·정착지 | OSM 태그 | 경계·장벽·관계 | 도시·마을·섬·광장처럼 지리적으로 이름 붙은 장소의 유형을 나타냅니다. | city, town, village
|
2. 공통 속성 Key
여러 종류의 객체에 이름·식별·운영·물리 정보를 폭넓게 추가합니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
width |
폭 | OSM 태그 | 교통과 길 | 도로·길·수로·구조물 등의 실제 폭을 기본적으로 미터 단위로 기록합니다. | 3, 1.5
| |
height |
높이(미터) | OSM 태그 | 건물과 출입구 | 지물의 전체 높이를 기록합니다. 단위가 없으면 미터로 해석합니다. | 4, 4.5, 8
| |
start_date |
존재·사용 시작 시점 | OSM 태그 | 건물과 출입구 | 지물이 현재 형태로 존재하거나 사용되기 시작한 시점을 알려진 정밀도만큼 기록합니다. 건물 사용승인일은 그 시점을 나타내는 경우에만 사용합니다. | 1978-01-01, 1960
| |
brand |
브랜드 | OSM 태그 | 생활시설과 POI | 주로 | 매장이나 시설이 속한 브랜드 이름을 기록하는 범용 OSM Key입니다. | 스타벅스
|
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 태그 | 이름·주소·운영 정보 | 시설이나 서비스를 실제로 운영하는 기관·회사·단체의 이름을 기록합니다. | 한국철도공사, 서울교통공사
| |
opening_hours |
운영시간 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설이나 장소가 문을 여는 요일과 시간을 OSM 운영시간 문법으로 기록합니다. | Mo-Su 10:00-22:00, Mo-Sa 11:00-21:00; Su off, 24/7
|
phone |
전화번호 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설의 대표 전화번호를 국제 표기 형식으로 기록하는 자유 입력 Key입니다. | +82-2-1234-5678
|
website |
웹사이트 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설·기관의 공식 웹사이트 주소를 기록합니다. | https://example.com
|
email |
이메일 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 시설·기관의 공개 연락용 이메일 주소를 기록하는 범용 OSM Key입니다. | info@example.com
|
description |
보충 설명 | OSM 태그 | 이름·주소·운영 정보 | 다른 구조화된 태그만으로 설명하기 어려운 유용한 정보를 짧은 문장으로 기록합니다. | 보행자 전용 출입구
| |
wikidata |
Wikidata 식별자 | OSM 태그 | 이름·주소·운영 정보 | 지물과 일치하는 Wikidata 항목의 Q 식별자를 기록합니다. | Q8684
| |
wikipedia |
Wikipedia 문서 | OSM 태그 | 이름·주소·운영 정보 | 지물을 직접 설명하는 Wikipedia 문서를 언어 코드와 문서 제목으로 연결합니다. | ko:서울역
|
3. 조건부 공통 Key
여러 분야에서 사용할 수 있지만, 실제 대상과 적용 조건을 먼저 확인해야 합니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
bus |
버스 이용 지정 | OSM 태그 | 교통과 길 | 정류소·차로·노선 등이 버스 교통에 적용되는지 나타냅니다. | yes, designated
| |
surface |
표면 재질 | OSM 태그 | 교통과 길 | 주로 | 도로·길·공간의 표면 포장 재질을 기록합니다. | asphalt, concrete, unpaved
|
smoothness |
통행 가능 수준 | OSM 태그 | 교통과 길 | 주로 | 표면의 물리적 상태를 기준으로 어떤 차량이나 이동수단이 통행할 수 있는지 나타냅니다. | excellent, good, intermediate
|
bridge |
교량 | OSM 태그 | 교통과 길 | 길·철도·수로가 다른 지물 위를 통과하는 교량 구간임을 나타냅니다. | yes, viaduct, boardwalk
| |
tunnel |
터널 | OSM 태그 | 교통과 길 | 길·철도·수로가 지하나 구조물 아래를 통과하는 구간임을 나타냅니다. | yes, culvert, building_passage
| |
oneway |
일방통행 | OSM 태그 | 교통과 길 | 길의 진행 방향을 기준으로 통행 가능한 방향을 기록합니다. | yes, no, -1
| |
lit |
조명 여부 | OSM 태그 | 교통과 길 | 길이나 공간이 야간에 조명되는지 기록합니다. | yes, no, automatic
| |
location |
위치 | OSM 태그 | 건물과 출입구 | 지물이 지하·지상·해상 등 어느 환경에 위치하는지 기록합니다. | underground, offshore
| |
area |
면 해석 지정 | OSM 태그 | 건물과 출입구 | 닫힌 길을 선이 아니라 면으로 해석하거나, 반대로 선으로 해석하도록 명시합니다. | yes, no
| |
intermittent |
간헐성 | OSM 태그 | 토지·자연·수계 | 계절이나 강수 조건에 따라 물이 마르거나 흐름이 끊기는 지물인지 나타냅니다. | yes, no
| |
branch |
지점명 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 체인점·기관의 공통 name 또는 brand와 구분되는 개별 지점명을 기록합니다. | 강남역점, 본점
|
level |
OSM 층 레벨 | OSM 태그 | 이름·주소·운영 정보 | 실내 시설이나 출입구의 층을 0 기준으로 기록합니다. 지상 기준층은 0, 그 위층은 1, 첫 지하층은 -1입니다. | 0, 1, -1
| |
layer |
레이어 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 교량·터널처럼 지물이 서로 교차할 때 상대적인 위아래 순서를 나타냅니다. 실제 층수나 높이를 뜻하지 않습니다. | 1, 0, -1
|
fixme |
확인·수정 필요 | OSM 태그 | 이름·주소·운영 정보 | 현장 확인이나 후속 수정이 필요한 문제를 다른 편집자에게 알립니다. | 도로 연결 상태 현장 확인 필요
| |
check_date |
최근 확인일 | OSM 태그 | 이름·주소·운영 정보 | 해당 지물이나 특정 속성을 마지막으로 확인한 날짜를 기록합니다. | 2026-08-21
| |
access |
일반 접근 조건 | OSM 태그 | 접근성과 이용 조건 | 대상에 출입하거나 통행할 수 있는 이용자의 일반 범위를 기록합니다. | yes, no, private
| |
bicycle |
자전거 접근 | OSM 태그 | 접근성과 이용 조건 | 주로 | 자전거의 통행 가능 여부와 지정 상태를 기록합니다. | yes, no, designated
|
foot |
보행 접근 | OSM 태그 | 접근성과 이용 조건 | 주로 | 보행자의 통행 가능 여부와 지정 상태를 기록합니다. | yes, no, designated
|
wheelchair |
휠체어 접근성 | OSM 태그 | 접근성과 이용 조건 | 휠체어 이용자가 시설이나 경로를 이용할 수 있는 정도를 기록합니다. | yes, no, limited
| |
delivery |
배달 | OSM 태그 | 접근성과 이용 조건 | 주로 | 음식점·상점이 배달 서비스를 제공하는지 기록합니다. | yes, no, only
|
takeaway |
포장 | OSM 태그 | 접근성과 이용 조건 | 주로 | 주문한 음식이나 상품을 포장해 가져갈 수 있는지 기록합니다. | yes, no, only
|
reservation |
예약 | OSM 태그 | 접근성과 이용 조건 | 주로 | 시설이나 서비스의 사전 예약 가능 여부를 기록합니다. | yes, no, required
|
toilets |
화장실 제공 여부 | OSM 태그 | 접근성과 이용 조건 | 주로 | 시설 이용자를 위한 화장실이 있는지 기록합니다. 독립된 공중화장실은 amenity=toilets로 표현합니다. | yes, no
|
internet_access |
인터넷 이용 | OSM 태그 | 접근성과 이용 조건 | 주로 | 방문자가 이용할 수 있는 인터넷 접속 방식과 제공 여부를 기록합니다. | wlan, yes, no
|
drive_through |
드라이브스루 | OSM 태그 | 접근성과 이용 조건 | 주로 | 차량에서 내리지 않고 주문·수령할 수 있는 시설인지 기록합니다. | yes, no
|
highchair |
유아용 의자 | OSM 태그 | 접근성과 이용 조건 | 주로 | 어린이를 위한 유아용 높은 의자를 제공하는지 기록합니다. | yes, no
|
dog |
반려견 이용 조건 | OSM 태그 | 접근성과 이용 조건 | 반려견의 출입 가능 여부와 목줄 조건을 기록합니다. | yes, no, leashed
| |
group_friendly |
단체 이용 적합 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | 단체 방문이나 모임에 적합한 장소인지 나타내는 KOSM 자체 Key입니다. | yes, no
|
kids |
어린이 이용 조건 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | 어린이 이용 가능 여부와 이용 정책을 나타내는 KOSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. | yes, no
|
kids_area |
어린이 놀이 공간 | OSM 태그 | KOSM POI 확장 Key | 주로 | 시설에 어린이가 놀 수 있는 공간이 마련되어 있는지 나타냅니다. 공간의 정도에 따라 네 가지 Value로 나눕니다. | yes, designated, limited
|
waiting_area |
대기 공간 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | 방문자를 위한 대기 공간이 있는지 나타내는 KOSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. | yes, no
|
valet_parking |
발레파킹 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | 발레파킹 서비스 제공 여부를 나타내는 KOSM 자체 Key입니다. OSM Wiki에 문서는 없지만 같은 이름이 소수 사용되고 있어 값 해석은 이 문서를 기준으로 합니다. | yes, no
|
4. 지물 종속 Key
특정 지물 핵심 Key와 함께 사용할 때 의미가 분명해지는 세부 Key입니다.
| Key | 한글명 | 태그 구분 | 주요 지물 | 적용 형태 | 설명 | 대표 Value |
|---|---|---|---|---|---|---|
service |
서비스 도로·철도 세부 유형 | OSM 태그 | 교통과 길 | highway=service 또는 철도 선로에 세부 용도를 덧붙입니다. | parking_aisle, alley, driveway
| |
tracktype |
작업로 노면 등급 | OSM 태그 | 교통과 길 | highway=track의 표면 견고성과 상태를 grade1부터 grade5까지 구분합니다. | grade1, grade2, grade3
| |
lanes |
차로 수 | OSM 태그 | 교통과 길 | 해당 도로 구간에서 일반 차량이 이용하는 전체 차로 수를 숫자로 기록합니다. | 1, 2, 3
| |
maxspeed |
최고 제한속도 | OSM 태그 | 교통과 길 | 법정 또는 표지로 지정된 최고 속도를 기록합니다. 단위가 없으면 일반적으로 km/h로 해석합니다. | 30, 50, 60
| |
sidewalk |
보도 배치 | OSM 태그 | 교통과 길 | 도로와 나란히 있는 보도의 위치 또는 별도 매핑 여부를 기록합니다. | both, left, right
| |
crossing |
횡단 시설 | OSM 태그 | 교통과 길 | 주로 | 보행자·자전거 이용자가 길을 건너는 지점의 통제 방식과 표시 상태를 나타냅니다. | marked, uncontrolled, traffic_signals
|
cycleway:* |
자전거도로 세부 속성 | OSM 태그 | 교통과 길 | 도로의 좌우·양측 자전거 통행 공간, 방향, 분리 여부와 표면을 세부 Key로 기록합니다. | lane, track, asphalt
| |
lanes:* |
방향·차종별 차로 | OSM 태그 | 교통과 길 | 진행 방향이나 버스·대중교통 차종별 차로 수와 조건을 기본 lanes Key에서 확장해 기록합니다. | 2, 1, 1
| |
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:levels |
지상층수 | OSM 태그 | 건물과 출입구 | 지표면 위에서 보이는 건물 층수를 숫자로 기록합니다. | 1, 2, 3
| |
building:levels:underground |
지하층수 | OSM 태그 | 건물과 출입구 | 지표면 아래에 있는 건물 층수를 양의 정수로 기록합니다. | 0, 1, 2
| |
building:main_use |
주용도 | K-OSM 태그 | 건물과 출입구 | 건축허가 또는 건축물대장에서 확인한 건축물의 공식 주용도 분류명을 한글로 기록하는 KOSM 자체 Key입니다. | 단독주택, 공동주택, 제1종근린생활시설
| |
building:structure |
건축물 구조 형식 | OSM 태그 · K-OSM 태그 | 건물과 출입구 | 건물의 시공 구조를 나타내는 사용 중인 OSM Key입니다. 사용 지역이 제한적이고 구조가 겉으로 확인되지 않는 경우가 많아 KOSM 원자료 대응표가 필요합니다. | unreinforced_masonry, reinforced_concrete, steel_frame
| |
building:area:total |
연면적 | K-OSM 태그 | 건물과 출입구 | 건축물의 전체 층 바닥면적 합계인 연면적을 기록하는 KOSM 자체 Key입니다. | 198, 59.5
| |
building:area:ground |
건물 대지면적 | K-OSM 태그 | 건물과 출입구 | 건물대지면적을 기록하는 KOSM 자체 Key입니다. | 198, 59.5
| |
building:bcr |
건폐율(%) | K-OSM 태그 | 건물과 출입구 | 대지면적에 대한 건축면적의 비율을 백분율로 기록하는 KOSM 자체 Key입니다. | 59.88, 0
| |
building:far |
용적률(%) | K-OSM 태그 | 건물과 출입구 | 대지면적에 대한 연면적의 비율을 백분율로 기록하는 KOSM 자체 Key입니다. | 100, 50
| |
sport |
스포츠 종목 | OSM 태그 | 생활시설과 POI | 체육시설에서 가능한 스포츠 종목을 기록하며 leisure 등의 주 분류 태그와 함께 사용합니다. | tennis, soccer, basketball
| |
cuisine |
음식 종류 | OSM 태그 | 생활시설과 POI | 주로 | 음식점·카페가 주로 제공하는 음식의 종류를 기록합니다. Key는 OSM에서 널리 쓰이며, 현재 DB의 한국어 값 표준화 기준은 별도 확인이 필요합니다. | 한식, 중식당, 카페
|
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
| |
addr:city |
특별·광역·시도 | OSM 태그 의미 변형 | 이름·주소·운영 정보 | 주로 | OSM의 addr:city를 KOSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다. | 서울특별시, 경기도
|
addr:street |
도로명 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 주소가 속한 도로의 이름을 기록합니다. | 세종대로, 오리로
|
addr:housenumber |
건물번호 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 도로명주소의 건물번호를 기록합니다. | 110, 451-15
|
addr:postcode |
우편번호 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 해당 주소의 우편번호를 기록합니다. 대한민국은 2015년부터 5자리 국가기초구역번호를 사용합니다. | 04524, 14345
|
addr:unit |
건물 내부 단위 | OSM 태그 | 이름·주소·운영 정보 | 주로 | 동·호처럼 하나의 주소 안에서 개별 점유 공간을 구분하는 단위를 기록합니다. 층은 level=* 또는 addr:floor=*로 따로 기록합니다. | 101호, 상가동
|
opening_hours:kitchen |
주방 운영시간 | OSM 태그 | 이름·주소·운영 정보 | 시설 전체 영업시간과 다른 경우 음식 주문이나 주방 운영이 가능한 시간을 기록합니다. | Mo-Su 11:00-21:00
| |
addr:district |
시·군·구 | OSM 태그 의미 변형 | 이름·주소·운영 정보 | 주로 | OSM의 addr:district를 KOSM 주소 체계에서는 시·군·구 단위로 의미를 변형하여 적용합니다. | 서구, 제주시
|
addr:subdistrict |
읍·면·동 | OSM 태그 의미 변형 | 이름·주소·운영 정보 | 주로 | OSM의 addr:subdistrict를 KOSM 주소 체계에서는 읍·면·동 단위로 의미를 변형하여 적용합니다. | 신림동, 애월읍
|
addr:plotnumber |
지번 | K-OSM 태그 | 이름·주소·운영 정보 | 주로 | 한국 지번 주소의 본번과 부번을 기록하는 KOSM 자체 Key입니다. | 300, 313-173
|
addr:plotarea |
리 | K-OSM 태그 | 이름·주소·운영 정보 | 주로 | 지번 주소가 속한 리 단위 지역명을 기록하는 KOSM 자체 Key입니다. | 읍내리, 용산리
|
parking:available |
주차 가능 여부 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | 해당 장소에서 주차가 가능한지 나타내는 KOSM 자체 Key입니다. | yes, no
|
media:tv:* |
방송 소개 정보 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | 장소가 소개된 TV 프로그램·방영일·메뉴를 기록하는 KOSM 자체 하위 Key 묶음입니다. | 2TV생생정보, 2026-01-01, 대표메뉴
|
michelin |
미쉐린 선정 정보 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | 미쉐린 선정 여부를 기록하는 KOSM 자체 Key입니다. | yes, no
|
michelin:* |
미쉐린 세부 정보 | K-OSM 태그 | KOSM POI 확장 Key | 주로 | michelin:award, michelin:stars, michelin:year, michelin:url처럼 선정 결과의 세부 항목을 기록하는 KOSM 자체 Key 묶음입니다. | bib_gourmand, 1, 2026
|
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 문서의 편집 모드에서 계속 확장할 수 있습니다.