dunji/address

Types

카카오 우편번호 서비스 oncomplete 콜백에서 반환되는 주소 데이터.

빈 문자열 가능 필드는 Option(String)으로 표현되며, 해당 주소에 적용되지 않는 경우 None이 된다. apartmentno_selected는 카카오 “Y”/“N” 문자열에서 Bool로 변환된다.

pub type Address {
  Address(
    zonecode: String,
    address: String,
    address_english: String,
    address_type: AddressType,
    user_selected_type: AddressType,
    query: String,
    road_address: String,
    road_address_english: option.Option(String),
    auto_road_address: option.Option(String),
    auto_road_address_english: option.Option(String),
    jibun_address: String,
    jibun_address_english: option.Option(String),
    auto_jibun_address: option.Option(String),
    auto_jibun_address_english: option.Option(String),
    roadname: option.Option(String),
    roadname_english: option.Option(String),
    roadname_code: option.Option(String),
    sido: String,
    sido_english: String,
    sigungu: String,
    sigungu_english: String,
    sigungu_code: String,
    bname: option.Option(String),
    bname_english: option.Option(String),
    bname1: option.Option(String),
    bname1_english: option.Option(String),
    bname2: option.Option(String),
    bname2_english: option.Option(String),
    hname: option.Option(String),
    building_code: option.Option(String),
    building_name: option.Option(String),
    apartment: Bool,
    bcode: String,
    no_selected: Bool,
    user_language_type: LanguageType,
  )
}

Constructors

  • Address(
      zonecode: String,
      address: String,
      address_english: String,
      address_type: AddressType,
      user_selected_type: AddressType,
      query: String,
      road_address: String,
      road_address_english: option.Option(String),
      auto_road_address: option.Option(String),
      auto_road_address_english: option.Option(String),
      jibun_address: String,
      jibun_address_english: option.Option(String),
      auto_jibun_address: option.Option(String),
      auto_jibun_address_english: option.Option(String),
      roadname: option.Option(String),
      roadname_english: option.Option(String),
      roadname_code: option.Option(String),
      sido: String,
      sido_english: String,
      sigungu: String,
      sigungu_english: String,
      sigungu_code: String,
      bname: option.Option(String),
      bname_english: option.Option(String),
      bname1: option.Option(String),
      bname1_english: option.Option(String),
      bname2: option.Option(String),
      bname2_english: option.Option(String),
      hname: option.Option(String),
      building_code: option.Option(String),
      building_name: option.Option(String),
      apartment: Bool,
      bcode: String,
      no_selected: Bool,
      user_language_type: LanguageType,
    )

    Arguments

    zonecode

    5자리 우편번호 (신우편번호).

    address

    기본 주소 (검색 결과 첫 줄).

    address_english

    기본 주소 영문.

    address_type

    기본 주소 필드의 주소 유형.

    user_selected_type

    사용자가 실제 선택한 주소 유형 (address_type과 다를 수 있음).

    query

    사용자가 입력한 검색어.

    road_address

    도로명주소 (한글).

    road_address_english

    도로명주소 (영문).

    auto_road_address

    1:N 매핑 시 시스템 추천 도로명주소.

    auto_road_address_english

    시스템 추천 도로명주소 영문.

    jibun_address

    지번주소 (한글).

    jibun_address_english

    지번주소 (영문).

    auto_jibun_address

    1:N 매핑 시 시스템 추천 지번주소.

    auto_jibun_address_english

    시스템 추천 지번주소 영문.

    roadname

    도로명 (건물번호 제외).

    roadname_english

    도로명 영문.

    roadname_code

    도로명 코드 (7자리).

    sido

    시/도명 (약칭 가능).

    sido_english

    시/도명 영문.

    sigungu

    시/군/구명.

    sigungu_english

    시/군/구명 영문.

    sigungu_code

    시/군/구 코드 (5자리).

    bname

    법정동/리명.

    bname_english

    법정동/리명 영문.

    bname1

    읍/면명 (동 지역은 빈 값).

    bname1_english

    읍/면명 영문.

    bname2

    법정동명.

    bname2_english

    법정동명 영문.

    hname

    행정동명 (법정동과 다를 때만 존재).

    building_code

    건물관리번호.

    building_name

    건물명.

    apartment

    공동주택 여부.

    bcode

    법정동/리 코드.

    no_selected

    사용자가 “선택 안함“을 클릭했는지 여부.

    user_language_type

    사용자가 검색 시 사용한 언어.

주소 유형: 도로명 또는 지번.

pub type AddressType {
  Road
  Jibun
}

Constructors

  • Road

    도로명주소 (카카오 API에서 “R”).

  • Jibun

    지번주소 (카카오 API에서 “J”).

사용자가 검색 시 선택한 언어.

pub type LanguageType {
  Korean
  English
}

Constructors

  • Korean

    한국어 (카카오 API에서 “K”).

  • English

    영어 (카카오 API에서 “E”).

Values

pub fn selected_address(address: Address) -> String

사용자가 선택한 주소 유형에 따라 적절한 주소를 반환한다.

도로명을 선택했으면 road_address, 지번을 선택했으면 jibun_address.

pub fn selected_address_english(
  address: Address,
) -> option.Option(String)

사용자가 선택한 주소 유형에 따라 영문 주소를 반환한다.

Search Document