如何在自己的網頁裡使用 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 秒), 感謝你

免責聲明

網站所提供之資料, 僅供使用者參考, 如查詢結果與實際不同, 請以中華郵政(郵局)資料為準, 對於查詢結果錯誤, 本網站不負任何法律責任

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

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