如何在自己的網頁裡使用 3+3 / 3+2郵遞區號 的 API 呢??

Q:
有提供什麼 API 可以讓我用在自己的網頁上呢 ??
A:
有提供 http://zip5.5432.tw/zip5json.py?adrs=xxxxxxxxxx
會傳回 json 格式的資料
              
                {
                  "adrs": "原輸入地址",
                  "new_adrs": "3+2郵遞區號" + "查詢後地址",
                  "new_adrs2": "3+2郵遞區號" + "原輸入地址",
                  "zipcode": "3+2郵遞區號",
                  "dataver": "3+2使用的資料版號"
                  "new_adrs6": "3+3郵遞區號" + "查詢後地址",
                  "new_adrs6_2": "3+3郵遞區號" + "原輸入地址",
                  "zipcode6": "3+3郵遞區號",
                  "dataver6": "3+3使用的資料版號"
                }
              
            
PS: 如果查不到 3+3 / 3+2 郵遞區號資料, new_adrs會傳回 原輸入的地址資料
PS: 2013-04-18, 增加輸出 new_adrs2 及 zipcode
PS: 2014-10-26, 增加輸出 dataver
PS: 2016-05-18, 支援https, https://zip5.5432.tw/zip5json.py?adrs=xxxxxxxxxx
PS: 2020-09-13 支援3+3郵遞區號查詢 Beta版
Q:
有沒有簡單的方法 ??
A:
你可以在自己的網頁 加上下列兩行
<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.2.6/jquery.min.js"></script>
<script type="text/javascript" src="http://zip5.5432.tw/js/zip5.js"></script>
然後在要做 3+3 / 3+2郵遞區號查詢的 地方, 要加上 id
ex:
  <input type='text' name='adrs'>
  改為
  <input type='text' name='adrs' id='my_adrs'>
後面加上 <input type='button' onclick='get_zip6_adrs("my_adrs")' value='查詢' />
PS: 注意:紅色字體的地方一定要 相同
PS: 要使用 https, 請改用 https://zip5.5432.tw/js/zip5.js
PS: 如果可以查到 3+3郵遞區號, 就使用3+3郵遞區號, 否則使用 3+2郵遞區號
PS: 如果只要使用 3+2郵遞區號, 就要使用 get_zip5_adrs()

這樣就可以了
範例網頁
Q:
注意事項
A:
  • 此3+3 / 3+2郵遞區號查詢, 只適用於 台灣
  • 本查詢是根據 中華郵政(郵局) 的資料為基礎
  • 支援六都, 輸入台北縣的地址會自動轉為新北市 (台中縣, 台南縣, 高雄縣, 桃園縣也相同)
  • 2015-01-05 改用 v3 版本, 支援 桃園縣升格桃園市, 等於六都都有支援
  • 2015-01-31 開始支援 郵政信箱
  • 請使用 utf-8
  • 如果查詢後傳回原輸入地址, 表示查不到3+2郵遞區號
  • 查詢出的3+3 / 3+2郵遞區號, 不一定完全正確, 有時會有錯誤的情形
  • 建議使用 Chrome, Firefox, 或 IE 8.0 以後版本 的瀏覽器
  • API 支援 CORS 及 jsonp
  • 撰寫程式使用API時, 請在查詢與下一個查詢間留一些緩衝時間, 避免系統 loading 衝高
  • 使用此 API, 請註明一下 API來源: https://zip5.5432.tw, 感謝
Q:
版本說明
A:
  • 2023-04-10 3+3郵遞區號 使用 11202 資料
  • 2023-04-10 3+2郵遞區號 使用 11112 資料
  • 2022-10-31 3+2郵遞區號 使用 11106 資料
  • 2022-05-09 3+3郵遞區號 使用 11104 資料
  • 2021-07-22 3+2郵遞區號 使用 11002 資料
  • 2020-09-13 加上 3+3郵遞區號 查詢功能 (使用 10907 資料)
  • 2020-08-02 API更換為 v9 版本 (使用 10907 資料)
  • 2020-03-17 API更換為 v8 版本 (使用 10903 資料)
  • 2019-04-18 API更換為 v7 版本 (使用 10804 資料)
  • 2018-03-13 API更換為 v6 版本 (使用 10612 資料)
  • 2017-05-10 API更換為 v5 版本 (使用 10603 資料)
  • 2016-08-22 API更換為 v4 版本 (使用 10508 資料)
  • 2015-01-05 API更換為 v3 版本 (使用 10312 資料)
  • v3版本有支援 桃園縣升格為桃園市
  • 2014-10-26 API更換為 v2 版本 (使用 10308 資料)
  • v2版本有支援 台中市 的 台灣大道 等等 這些新地址
  • API回傳的json資料多一個 dataver, 紀錄使用的資料版號
  • 預設使用最新的資料
Q:
有支援郵政信箱嗎?
A:
  • 2015-01-31 API開始支援
  • 支援格式為 台北郵局第○號信箱, 台北郵局第○之○號信箱
  • ○ 為數字, [之]可以用 - 或 ~ 代替, 使用其他字元會造成誤判
  • 目前網頁版尚未支援 郵政信箱 的郵遞區號查詢
  • 郵政信箱尚未支援 3+3郵遞區號
Q:
API使用特別說明
A:
  • 請加上緩衝時間 (建議 2 至 3 秒)
  • 請勿一直查詢相同的地址 (先整理要查詢的地址資料, 將重複的地址刪除)
  • 請勿連續長時間的查詢, 一天不要超過 2000 次查詢
最近有使用 API 的朋友, 撰寫程式直接使用 API 來查詢, 但是在查詢間沒有加上緩衝時間, 每分鐘查詢上百次, 造成 loading 太高, 請在查詢與下一個查詢間留一些緩衝時間 (建議 2 至 3 秒), 感謝你
免責聲明
  • 網站所提供之資料, 僅供使用者參考, 如查詢結果與實際不同, 請以中華郵政(郵局)資料為準, 對於查詢結果錯誤, 本網站不負任何法律責任