Open Data
開放資料
本站免費開放全臺 201 座匹克球場(CSV 與 JSON)、166 支球拍、154 件球衣配件、23 篇規則教學、107 則新聞與 85 個活動的結構化資料,以及近期活動行事曆(.ics)與 AI 全文知識庫,每日隨網站更新,個人、研究、新聞報導與 AI 助理引用無須申請金鑰,標註來源即可。
可以下載什麼
| 檔案 | 格式 | 內容 |
|---|---|---|
| /api/courts.csv | CSV | 全部 201 座球場 24 個欄位:名稱、縣市、行政區、地址、座標、室內外、面數、電話、官網、訂位連結、營業時段、收費、設施、狀態、啟用日、資料更新日與來源網址。含 UTF-8 BOM,Excel 與 Google 試算表直接開得起來。 |
| /api/courts-full.json | JSON | 全部 201 座球場 與 CSV 同樣的欄位,收費與設施保留巢狀結構,適合程式讀取。 |
| /api/courts.json | JSON | 球場輕量索引 只有座標與基本欄位,本站的「找最近球場」就是用這一份,檔案小、適合做地圖。 |
| /api/news.json | JSON | 新聞 107 則 標題、摘要、分類、發布時間與原始出處。 |
| /api/events.json | JSON | 活動 85 個 含已結束的場次:日期、地點、主辦單位、報名狀態、報名連結與截止日。 |
| /api/paddles.json | JSON | 球拍 166 支 品牌、型號、厚度、核心、拍面、重量、握把、類型、售價區間、官網與臺灣購買通路。 |
| /api/apparel.json | JSON | 球衣、球鞋與配件 154 件 品牌、型號、類別、材質、顏色、尺寸、售價區間與購買通路。 |
| /api/learn.json | JSON | 規則與新手教學 23 篇 課程章節、課次、摘要、完整 Markdown 內文、場地圖解網址與參考來源。 |
| /events.ics | iCalendar | 近期活動行事曆 33 個 RFC 5545 標準行事曆,可匯入或訂閱至 Google 日曆、Apple 行事曆與 Outlook。 |
| /llms.txt | Markdown | AI 與答案引擎導覽 全站結構、分區索引、規則重點與開放資料清單,依 llmstxt.org 慣例編排。 |
| /llms-full.txt | Markdown | AI 全文知識庫 一次讀完全部教學文章內文、全臺球場清單、球拍規格、近期活動與最新新聞摘要。 |
| /api/openapi.json | OpenAPI 3.1 | 開放資料 API 結構描述 全站 JSON、CSV、iCalendar 與訂閱端點的欄位結構與型別定義,方便 AI 代理與開發工具直接串接。 |
| /feed.json | JSON Feed | 新聞訂閱(JSON Feed 1.1) 最新 40 則新聞的結構化 JSON 訂閱源,含標題、改寫摘要、發布時間與原始報導連結。 |
| /feed.xml | RSS | 新聞訂閱(RSS 2.0) 最新 40 則新聞,可用任何 RSS 閱讀器訂閱。 |
使用條款
個人、非商業與新聞報導用途可自由使用,請註明來源為 pickleball.fashion 並附上本站網址。把資料重新發布成競爭性的目錄服務、或移除來源後當成自己的資料販售,需要事先透過意見回報表單取得同意。完整條款見著作權政策。
球場的座標來自地理編碼與場館公告,附近停車場資料來自 OpenStreetMap,該部分依 ODbL 授權,引用時請一併標註 OpenStreetMap 貢獻者。
更新頻率與穩定性
資料每天更新一次,網址固定不變,可以直接排程抓取。球場的 id 建立後不會改變也不會回收,可以當成穩定的識別碼跨版本比對。
建議每天同步一次,避免高頻輪詢。
欄位說明
source_url 為原始資料網址。
- 費用只有 165 座查得到、營業時間 192 座,其餘欄位為空值代表查不到,不代表沒有。
- 費用與營業時間變動頻繁,
updated欄位是本站最後複查的日期。 - 已歇業的球場狀態改為
closed並保留在資料中,不會直接刪除。
發現錯誤或想補資料
歡迎線上回報。若你是場館經營者,也可以直接提供正確的費用、營業時間與實景照片授權。
你可能想知道
GOOD TO KNOW
可以下載全臺匹克球場的資料嗎?
可以。本站以 CSV 與 JSON 開放全部 201 座球場的資料,含名稱、地址、座標、室內外、面數、收費、營業時間、設施與原始出處,每天更新一次。個人與新聞報導用途請直接取用,並註明來源為 pickleball.fashion。
開放資料要付費或申請金鑰嗎?
不用。檔案是靜態網址,直接下載即可,沒有金鑰也沒有速率限制。因為內容一天只更新一次,請不要高頻輪詢,一天抓一次就足夠。
資料可以商業使用嗎?
個人、非商業與新聞報導用途可自由使用並註明來源。把資料重新發布成競爭性的目錄服務或移除來源後販售,需要事先透過意見回報表單取得書面同意。