Key: ref

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
`ref`	참조 번호 — 도로 번호, 노선 번호, 출입구 번호처럼 대상에 부여된 공식 식별 번호를 기록합니다.	OSM 태그	모든 형태	`text`	OSM Wiki

어떻게 사용하나요?

ref=*는 대상에 공식적으로 부여된 짧은 식별자를 담습니다. 도로번호·노선번호·출입구번호처럼 사람이 이름 대신 부르는 번호입니다.

이름은 name=*이 담고, 내부 데이터베이스의 일련번호는 지도 데이터에 넣지 않습니다. 여러 번호가 공식 부여된 경우 그 분야의 구분 문법을 따릅니다.

적용 대상

ref=*는 일반적으로 모든 형태에 적용합니다.

공식 식별 번호가 부여된 도로·노선·역·출입구·시설 객체에 붙입니다. 번호가 가리키는 범위가 노선 전체인지 개별 승강장인지 구분합니다.

Value 선택

도로번호·노선번호·출입구번호처럼 대상에 공식적으로 부여된 짧은 식별자를 기록합니다. 사람이 부르는 이름이나 내부 데이터베이스 PK를 넣지 말고, 한 객체에 복수 번호가 공식 부여된 경우 해당 분야의 구분 문법을 따릅니다.

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

비슷한 Key와 구분하기

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

Key	무엇을 기록하나요?	예시·구분 기준
`name=*`	현지에서 일반적으로 사용하는 대상의 기본 이름	`name=서울역`
`official_name=*`	기본 이름과 다른 공식 명칭	법령·공식 문서상의 명칭
`alt_name=*`	현재 함께 쓰이는 다른 이름	별칭·대체 이름
`old_name=*`	지금은 쓰지 않는 이전 이름	개칭 전 이름
`branch=*`	체인·기관의 개별 지점명	`branch=강남점`
`brand=*`	시설이 사용하는 브랜드	운영 주체인 `operator=*`와 구분

주요 Value

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

Value	의미	언제·어떻게 사용하나요?	태그 구분	OSM Wiki
`ref=1`	1번 출입구·노선 등 대상 문맥에 따른 번호	표지·공식 체계에서 사용하는 참조 번호가 ‘1’일 때 기록합니다. 내부 데이터베이스 식별자나 설명문은 넣지 않습니다.	OSM 태그	Key 문서에서 확인
`ref=17`	도로·노선 참조 번호	표지·공식 체계에서 사용하는 참조 번호가 ‘17’일 때 기록합니다. 내부 데이터베이스 식별자나 설명문은 넣지 않습니다.	OSM 태그	Key 문서에서 확인

함께 사용하는 Key

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

관련 Key	역할	공식 문서
`name`	출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다.	OSM Wiki
`name:*`	같은 이름의 언어별 표기를 언어 코드와 함께 기록합니다.	OSM Wiki
`official_name`	일반적으로 부르는 이름과 다른 공식 명칭을 기록합니다.	OSM Wiki
`alt_name`	공식 명칭 외에 함께 사용되는 다른 이름을 기록합니다.	OSM Wiki
`old_name`	현재는 사용하지 않는 이전 이름을 기록합니다.	OSM Wiki
`branch`	체인점이나 기관에서 개별 지점을 구분하는 이름을 기록합니다.	OSM Wiki
`operator`	시설이나 서비스를 실제로 운영하는 기관 또는 사업자를 기록합니다.	OSM Wiki

참고 문서

이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 OSM Wiki — Key:ref에서 확인합니다.