Taiwan Address Parser

twaddr is a Go package for converting Traditional Chinese Taiwan addresses to standardized English address format.

Features

• Converts Taiwan Chinese addresses to standard English address format
• Supports complex address structures (lanes, alleys, sub-numbers, floors, rooms, etc.)
• Built-in Taiwan postal address dataset with complete city, district, village, and road name mappings
• Address normalization (number format standardization, traditional/simplified character conversion)
• High-performance address parsing algorithm

Installation

go get github.com/ddzero2c/twaddr

Usage

package main

import (
    "fmt"
    "github.com/ddzero2c/twaddr"
)

func main() {
    // Parse Taiwan Chinese address
    result, err := twaddr.Parse("台北市大安區信義路四段30巷12號")
    if err != nil {
        panic(err)
    }

    fmt.Println(result)
    // Output: No. 12, Ln. 30, Sec. 4, Xinyi Rd., Da'an Dist., Taipei City 106, Taiwan (R.O.C.)
}

Supported Address Formats

• Basic addresses: City + District + Road + Number
• Complex addresses: Including sections, lanes, alleys, sub-numbers, floors, rooms
• Village addresses: Addresses containing village names
• Special formats: Various Taiwan address representation styles

Data Sources

Address data is sourced from official Taiwan postal datasets, including:

• City and district mapping tables
• Village Chinese-English correspondence tables
• Street and road name Chinese-English correspondence tables

Testing

go test ./...