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

Q:
有提供什麼 API 可以讓我用在自己的網頁上呢 ??
A:
有提供 http://zip5.5432.tw/zip5json.py?adrs=xxxxxxxxxx
會傳回 json 格式的資料

		{
		  "adrs": "原輸入地址",
		  "new_adrs": "郵遞區號" + "查詢後地址",
		  "new_adrs2": "郵遞區號" + "原輸入地址",
		  "zipcode": "郵遞區號",
		  "dataver": "使用的資料版號"
		}
	    
PS: 如果查不到 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
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://tools.5432.tw/js/zip5.js"></script>
然後在要做 3+2郵遞區號查詢的 地方, 要加上 id
ex:
  <input type='text' name='adrs' width='50' size='50'>
  改為
  <input type='text' name='adrs' id='my_adrs' width='50' size='50'>
後面加上 <input type='button' onclick='get_zip5_adrs("my_adrs")' value='查詢' />
PS: 注意:紅色字體的地方一定要 相同
PS: 要使用 https, 請改用 https://zip5.5432.tw/js/zip5.js

這樣就可以了
範例網頁
Q:
注意事項
A:
  • 此3+2郵遞區號查詢, 只適用於 台灣
  • 本查詢是根據 中華郵政 的資料為基礎
  • 支援六都, 輸入台北縣的地址會自動轉為新北市 (台中縣, 台南縣, 高雄縣, 桃園縣也相同)
  • 2015-01-05 改用 v3 版本, 支援 桃園縣升格桃園市, 等於六都都有支援
  • 2015-01-31 開始支援 郵政信箱
  • 請使用 utf-8
  • 如果查詢後傳回原輸入地址, 表示查不到3+2郵遞區號
  • 查詢出的3+2郵遞區號, 不一定完全正確, 有時會有錯誤的情形
  • 建議使用 IE 8.0 以後版本
  • 撰寫程式使用API時, 請在查詢與下一個查詢間留一些緩衝時間, 避免系統 loading 衝高
  • 使用此 API, 請註明一下 API來源: http://tools.5432.tw, 感謝
  • 請勿連續長時間的查詢, 會超過 GAE 每日額度, 而使得所有人都無法使用
Q:
版本說明
A:
  • 2015-01-05 API更換為 v3 版本 (使用 10312 資料)
  • v3版本有支援 桃園縣升格為桃園市
  • 2014-10-26 API更換為 v2 版本 (使用 10308 資料)
  • v2版本有支援 台中市 的 台灣大道 等等 這些新地址
  • API回傳的json資料多一個 dataver, 紀錄使用的資料版號
  • 要使用 v1 版本可以使用 http://zip5.5432.tw/1/zip5json.py?adrs=xxxxxxxxxx (使用 09912 資料)
  • 要使用 v2 版本可以使用 http://zip5.5432.tw/2/zip5json.py?adrs=xxxxxxxxxx (使用 10308 資料)
  • 要使用 v3 版本可以使用 http://zip5.5432.tw/3/zip5json.py?adrs=xxxxxxxxxx (使用 10312 資料)
  • 預設使用 v3
Q:
有支援郵政信箱嗎?
A:
  • 2015-01-31 API開始支援
  • 支援格式為 台北郵局第○號信箱, 台北郵局第○之○號信箱
  • ○ 為數字, [之]可以用 - 或 ~ 代替, 使用其他字元會造成誤判
  • 目前網頁版尚未支援 郵政信箱 的郵遞區號查詢
Q:
API使用特別說明
A:
最近有使用 API 的朋友, 撰寫程式直接使用 API 來查詢, 但是在查詢間沒有加上緩衝時間, 每分鐘查詢500~600次以上, 造成 loading 太高, 請在查詢與下一個查詢間留一些緩衝時間 (建議 1 至 2 秒), 感謝你