Key: ref 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="참조 번호">ref</code> || '''참조 번호''' — 도로 번호, 노선 번호, 출입구 번호처럼 대상에 부여된 공식 식별 번호를 기록합니다. || '''OSM 태그''' || 모든 형태 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:ref OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="참조 번호">ref=*</code>는 '''대상에 공식적으로 부여된 짧은 식별자'''를 담습니다. 도로번호·노선번호·출입구번호처럼 사람이 이름 대신 부르는 번호입니다.

이름은 <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=*]]</code>이 담고, 내부 데이터베이스의 일련번호는 지도 데이터에 넣지 않습니다. 여러 번호가 공식 부여된 경우 그 분야의 구분 문법을 따릅니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="참조 번호">ref=*</code>는 일반적으로 '''모든 형태'''에 적용합니다.

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

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

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

=== 비슷한 Key와 구분하기 ===
비슷해 보이는 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: name|name=서울역]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="공식 명칭">[[Key: official_name|official_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: old_name|old_name=*]]</code> || 지금은 쓰지 않는 이전 이름 || 개칭 전 이름
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="지점명">[[Key: branch|branch=*]]</code> || 체인·기관의 개별 지점명 || <code class="kosm-tag-reference kosm-tag-reference--link" title="지점명">[[Key: branch|branch=강남점]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="브랜드">[[Key: brand|brand=*]]</code> || 시설이 사용하는 브랜드 || 운영 주체인 <code class="kosm-tag-reference kosm-tag-reference--link" title="운영 주체">[[Key: operator|operator=*]]</code>와 구분
|}

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="참조 번호">ref=1</code> || 1번 출입구·노선 등 대상 문맥에 따른 번호 || 표지·공식 체계에서 사용하는 참조 번호가 ‘1’일 때 기록합니다. 내부 데이터베이스 식별자나 설명문은 넣지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:ref Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="참조 번호">ref=17</code> || 도로·노선 참조 번호 || 표지·공식 체계에서 사용하는 참조 번호가 ‘17’일 때 기록합니다. 내부 데이터베이스 식별자나 설명문은 넣지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:ref Key 문서에서 확인]
|}

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <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 kosm-tag-reference--link" title="언어별 이름">[[Key: name:*|name:*]]</code> || 같은 이름의 언어별 표기를 언어 코드와 함께 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:name OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="공식 명칭">[[Key: official_name|official_name]]</code> || 일반적으로 부르는 이름과 다른 공식 명칭을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:official_name OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="대체 이름">[[Key: alt_name|alt_name]]</code> || 공식 명칭 외에 함께 사용되는 다른 이름을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:alt_name OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="이전 이름">[[Key: old_name|old_name]]</code> || 현재는 사용하지 않는 이전 이름을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:old_name OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="지점명">[[Key: branch|branch]]</code> || 체인점이나 기관에서 개별 지점을 구분하는 이름을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:branch 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]
|}

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

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