WIA Code & WIA Pin Code

WIA Code 가 무엇이고 QR 과 어떻게 다른지, 어떤 실루엣과 용량이 있는지 알려준다. 코드를 만들기 전에 이걸 먼저 불러 실루엣과 용량을 확인하면 실패를 줄일 수 있다.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

와이파이 접속 정보를 WIA Code 로 만든다. 스캔하면 비밀번호를 입력하지 않고 바로 접속된다. 카페·사무실·숙소 안내에 쓴다. 개방망이면 security 를 nopass 로 준다.

{
  "type": "object",
  "properties": {
    "ssid": {
      "type": "string",
      "minLength": 1,
      "description": "와이파이 이름(SSID)"
    },
    "password": {
      "description": "비밀번호. security 가 nopass 면 필요 없다.",
      "type": "string"
    },
    "security": {
      "description": "보안 방식(기본 WPA). nopass = 개방망",
      "type": "string",
      "enum": [
        "WPA",
        "WEP",
        "nopass"
      ]
    },
    "hidden": {
      "description": "SSID 를 숨긴 네트워크면 true",
      "type": "boolean"
    },
    "shape": {
      "description": "실루엣(기본 heart). 용량: square 1450 > bubble 1098 > round 1093 > hex 861 > heart 854 > clover 521 > star·boomerang 386 bytes",
      "type": "string",
      "enum": [
        "heart",
        "round",
        "clover",
        "star",
        "boomerang",
        "hex",
        "bubble",
        "square"
      ]
    }
  },
  "required": [
    "ssid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

연락처(명함)를 표준 vCard 로 담은 WIA Code 를 만든다. 스캔하면 폰이 연락처 저장을 제안한다.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "이름"
    },
    "org": {
      "description": "회사·소속",
      "type": "string"
    },
    "tel": {
      "description": "전화번호",
      "type": "string"
    },
    "email": {
      "description": "이메일",
      "type": "string"
    },
    "shape": {
      "description": "실루엣(기본 heart). 용량: square 1450 > bubble 1098 > round 1093 > hex 861 > heart 854 > clover 521 > star·boomerang 386 bytes",
      "type": "string",
      "enum": [
        "heart",
        "round",
        "clover",
        "star",
        "boomerang",
        "hex",
        "bubble",
        "square"
      ]
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

일정을 표준 iCalendar 로 담은 WIA Code 를 만든다. 스캔하면 캘린더에 추가된다. 시각은 "2026-09-01 19:00" 형식으로 준다.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "일정 제목"
    },
    "start": {
      "type": "string",
      "minLength": 1,
      "description": "시작 시각 — \"2026-09-01 19:00\" 형식"
    },
    "end": {
      "description": "끝 시각 — 같은 형식",
      "type": "string"
    },
    "location": {
      "description": "장소",
      "type": "string"
    },
    "desc": {
      "description": "설명",
      "type": "string"
    },
    "shape": {
      "description": "실루엣(기본 heart). 용량: square 1450 > bubble 1098 > round 1093 > hex 861 > heart 854 > clover 521 > star·boomerang 386 bytes",
      "type": "string",
      "enum": [
        "heart",
        "round",
        "clover",
        "star",
        "boomerang",
        "hex",
        "bubble",
        "square"
      ]
    }
  },
  "required": [
    "title",
    "start"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

텍스트나 링크를 WIA Code 이미지(PNG)로 만든다. 실루엣마다 용량이 다르므로 긴 내용은 square(가장 큼) 를, 짧은 링크는 아무 실루엣이나 쓰면 된다. 용량을 넘으면 어떤 실루엣이 가능한지 알려준다.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "코드에 담을 텍스트 또는 URL. 긴 URL 은 먼저 줄이는 편이 좋다."
    },
    "shape": {
      "description": "실루엣(기본 heart). 용량: square 1450 > bubble 1098 > round 1093 > hex 861 > heart 854 > clover 521 > star·boomerang 386 bytes",
      "type": "string",
      "enum": [
        "heart",
        "round",
        "clover",
        "star",
        "boomerang",
        "hex",
        "bubble",
        "square"
      ]
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn a latitude/longitude into a WIA Pin Code (12 digits, e.g. 708-702-851-863 for central Seoul). Also returns the 9-digit v1 code, which is always the first 9 digits of the v2 code. Works offline-style: pure calculation, no lookup.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude (WGS84, decimal degrees)"
    },
    "lng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude (WGS84, decimal degrees)"
    }
  },
  "required": [
    "lat",
    "lng"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn a WIA Pin Code (12-digit v2 or 9-digit v1, dashes optional, a leading country calling code such as 082- is ignored) into latitude/longitude. v2 returns the cell centre (error within about ±10 m lat / ±20 m lng); v1 is a coarser legacy code.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "minLength": 9,
      "maxLength": 40,
      "description": "e.g. 708-702-851-863"
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the WIA Pin Code cells around a point or a code, nearest first, with distance and direction. Useful for "which codes cover this building/plaza". Give either code, or lat+lng. Radius 10–200 m.

{
  "type": "object",
  "properties": {
    "code": {
      "description": "A WIA Pin Code to start from",
      "type": "string",
      "maxLength": 40
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude (WGS84, decimal degrees)"
    },
    "lng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude (WGS84, decimal degrees)"
    },
    "radius_m": {
      "description": "Search radius in metres (default 50)",
      "type": "number",
      "minimum": 10,
      "maximum": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}