香港天文台開放數據應用程式介面說明書 ·...

香港天文台

開放數據應用程式介面說明書

版本 : 1.3

日期 : 二零二零年九月

香港天文台

© 香港特別行政區政府

香港特別行政區政府保留本文件內容的所有權，未經香港天文台明確批准，不得

翻印文件的全部或部分內容。

香港天文台開放數據應用程式介面說明書

修改記錄

修改

次數修改詳情

經修改

頁數

版本

編號日期

1 香港天文台開放數據應用程

式介面說明書發佈全部 1.0

2019 年

6 月

2 更新應用程式介面請求參數 14 - 16 1.1 2020 年

4 月

3 更新應用程式介面請求參數 16 - 23 1.2 2020 年

6 月

4 新增數據集 13,

24 - 28 1.2

2020 年

6 月

5 更新應用程式介面傳回細節 5 – 19 1.3 2020 年

9 月

6 新增傳回例子到有可能傳回

空白 (null) 的數據集 9 - 17 1.3

2020 年

9 月


2

目錄

1. 天氣資訊應用程式介面 ................................................................................. 4

數據集

- 九天天氣預報 ........................................................................................................... 4

- 本港地區天氣報告 ................................................................................................... 4

- 本港地區天氣預報 ................................................................................................... 4

- 詳細天氣警告資訊 ................................................................................................... 4

- 天氣警告一覽 ........................................................................................................... 4

- 特別天氣提示 ........................................................................................................... 4

應用程式介面位置........................................................................................................ 4

HTTP請求方法.............................................................................................................. 4

傳回類型........................................................................................................................ 4

REQUEST例子.............................................................................................................. 4

REQUEST...................................................................................................................... 4

RESPONSE.................................................................................................................... 5

2. 地震資訊應用程式介面 ............................................................................... 18

數據集

- 地震速報 ................................................................................................................. 18

- 本地有感地震報告 ................................................................................................. 18

應用程式介面位置...................................................................................................... 18

HTTP請求方法............................................................................................................ 18

傳回類型...................................................................................................................... 18

REQUEST例子............................................................................................................ 18

REQUEST.................................................................................................................... 18

RESPONSE.................................................................................................................. 18

3. 開放數據（氣象及天氣資訊）應用程式介面 ........................................... 20

數據集

- 每小時潮汐高度 ..................................................................................................... 20

- 漲潮和退潮的時間和高度 ..................................................................................... 20

- 日出、日中天、日落時間 ..................................................................................... 20

- 月出、月中天、月落時間 ..................................................................................... 20

- 雲對地及雲間閃電次數 ......................................................................................... 20

- 最新十分鐘平均能見度 ......................................................................................... 20

- 日平均氣溫 ............................................................................................................. 20


3

- 日最高氣溫 ............................................................................................................. 20

- 日最低氣溫 ............................................................................................................. 20

- 天氣及輻射水平資料 ............................................................................................. 20

應用程式介面位置...................................................................................................... 20

HTTP請求方法............................................................................................................ 20

傳回類型...................................................................................................................... 20

REQUEST例子............................................................................................................ 20

REQUEST.................................................................................................................... 20

RESPONSE.................................................................................................................. 32


4

1. 天氣資訊應用程式介面

數據集

- 九天天氣預報

- 本港地區天氣報告

- 本港地區天氣預報

- 詳細天氣警告資訊

- 天氣警告一覽

- 特別天氣提示

應用程式介面位置

https://data.weather.gov.hk/weatherAPI/opendata/weather.php

請在應用程式介面請求中提供有效的參數。有關有效的參數，請參閱此部分的 Request

參數表。

HTTP 請求方法

GET

傳回類型

JSON

Request 例子

https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=flw&lang=tc

Request

參數可接受的數值說明

dataType flw

fnd

rhrread

warnsum

warningInfo

swt

flw: 本港地區天氣預報

fnd: 九天天氣預報

rhrread: 本港地區天氣報告

warnsum: 天氣警告一覽

warningInfo: 詳細天氣警告資訊

swt: 特別天氣提示

lang en

tc

sc

en: 英文

tc: 繁體中文

sc: 簡體中文

預設語言: en

https://data.weather.gov.hk/weatherAPI/opendata/weather.php

https://data.weather.gov.hk/weatherAPI/opendata/weather.php?dataType=flw&lang=tc


5

Response

本港地區天氣預報 (flw)

參數說明細節

generalSituation 概況

tcInfo 熱帶氣旋資訊

fireDangerWarning 火災危險警告信息

forecastPeriod 預測時段

forecastDesc 預測內容

outlook 展望

updateTime 更新時間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00

九天天氣預報 (fnd)

參數說明細節

weatherForecast 天氣預報以陣列表示

forecastDate 預報日期 YYYYMMDD

forecastWeather 預測天氣

forecastMaxtemp 預測最高溫度

forecastMintemp 預測最低溫度

week 星期天數

forecastWind 預測風向風速

forecastMaxrh 預測最高相對

濕度

forecastMinrh 預測最低相對

濕度

ForecastIcon 預測天氣圖示天氣圖示列表:

https://www.hko.gov.hk/textonly/v

2/explain/wxicon_c.htm

soilTemp 土壤溫度 place 地點

value 值

unit 量度單位

recordTime 紀錄時間

YYYY-MM-

DD'T'hh:mm:ssZ

https://www.hko.gov.hk/textonly/v2/explain/wxicon_c.htm



6

例子:

2020-09-

01T08:19:00+08:00

depth unit: 量度單位

value: 深度值

seaTemp 海面溫度 place 地點

value 值

unit 量度單位


YYYY-MM-

DD'T'hh:mm:ssZ

例子:

2020-09-

01T08:19:00+08:00

本港地區天氣報告 (rhrread)

參數說明細節

lightning1 閃電 data place: 發生地點

occur: true

startTime 紀錄開始時間

YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-

01T08:19:00+08:00

endTime 紀錄完結時間


例子:

2020-09-

01T08:19:00+08:00

rainfall 雨量 data unit: 量度單位

place: 資料位置

max1: 最高雨量紀錄

min1: 最低雨量紀錄

Main: 分區站是否維修中

(TRUE/FALSE)

startTime 紀錄開始時間


7


例子:

2020-09-

01T08:19:00+08:00

endTime 紀錄完結時間


例子:

2020-09-

01T08:19:00+08:00

icon 圖示以陣列表示

天氣圖示列表:

https://www.hko.gov.hk/textonly/v2/expl

ain/wxicon_c.htm

iconUpdateTime 圖示更新時間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00

uvindex 紫外線指數 data place: 位置

value: 值

desc: 強度

message1: 信息

recordDesc 資料詳情


例子:

2020-09-01T08:19:00+08:00

warningMessage 警告信息以陣列表示。如果沒有警告信息的數

據，將傳回空白字串

rainstormReminder1 暴雨警告提醒

specialWxTips1 特別天氣提示以陣列表示

tcmessage1 熱帶氣旋位置

的消息

以陣列表示

mintempFrom00To0

91

午夜至上午九

時的最低溫度

rainfallFrom00To121 香港天文台從

午夜至中午累

計降雨量

rainfallLastMonth1 上個月降雨量




8

rainfallJanuaryToLas

tMonth1

一月至上月累

計降雨量

temperature 分區氣溫 data place: 資料位置

value: 值

unit: 量度單位



例子:

2020-09-

01T08:19:00+08:00

humidity 濕度 data unit: 量度單位

value: 值

place: 資料位置



例子:

2020-09-

01T08:19:00+08:00

1. 數值為 null 或不適用時，有可能缺少傳回的參數。


9

天氣警告一覽 (warnsum)

參數說明細節

{屬性名稱} 警告說明代號 WFIRE: 火災危險警告

WFROST: 霜凍警告

WHOT: 酷熱天氣警告

WCOLD: 寒冷天氣警告

WMSGNL: 強烈季候風信號

WRAIN: 暴雨警告信號

WFNTSA: 新界北部水浸特別報告

WL: 山泥傾瀉警告

WTCSGNL: 熱帶氣旋警告信號

WTMW: 海嘯警告

WTS: 雷暴警告

name 警告名稱

code 警告代號 WFIRE

WFIREY

WFIRER

WFROST WFROST

WHOT WHOT

WCOLD WCOLD

WMSGNL WMSGNL

WRAIN WRAINA

WRAINR

WRAINB

WFNTSA WFNTSA

WL WL

WTCSGNL TC1

TC3

TC8NE

TC8SE


10

TC8NW

TC8SW

TC9

TC10

WTMW WTMW

WTS WTS

actionCode 行動代號 ISSUE,

REISSUE (WCOLD, WHOT 及 WFNTSA),

CANCEL,

EXTEND(WTS)

UPDATE (WTS)

issueTime 發放時間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00

expireTime1 到期时間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00


例子:

2020-09-01T08:19:00+08:00

1. 數值為 null 或不適用時，有可能缺少傳回的參數。關於傳回的格式，請參閱以下的

傳回例子。

天氣警告一覽 (warnsum) 的傳回例子:

以下的傳回例子僅是示例，並不是真實數據。

{

"WFROST": {

"name": "霜凍警告",

"code": "WFROST",

"actionCode": "ISSUE",

"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

},

"WHOT": {


11

"name": "酷熱天氣警告",

"code": "WHOT",


"issueTime": "2020-09-24T07:00:00+08:00",

"updateTime": "2020-09-24T07:00:00+08:00"

},

"WCOLD": {

"name": "寒冷天氣警告",

"code": "WCOLD",


"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

},

"WFNTSA": {

"name": "新界北部水浸特別報告",

"code": "WFNTSA",


"issueTime": "2020-09-24T11:40:00+08:00",

"updateTime": "2020-09-24T11:40:00+08:00"

},

"WMSGNL": {

"name": "強烈季候風信號",

"code": "WMSGNL",


"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

},

"WL": {

"name": "山泥傾瀉警告",

"code": "WL",


"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

},

"WRAIN": {

"name": "暴雨警告信號",

"code": "WRAINR",


12

"type": "紅色",


"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

},

"WTMW": {

"name": "海嘯警告",

"code": "WTMW",


"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

},

"WTS": {

"name": "雷暴警告",

"code": "WTS",

"actionCode": "EXTEND",

"issueTime": "2020-09-24T11:40:00+08:00",

"expireTime": "2020-09-24T19:30:00+08:00",

"updateTime": "2020-09-24T05:00:00+08:00"

},

"WTCSGNL": {

"name": "熱帶氣旋警告信號",

"code": "TC3",


"type": "三號強風信號",

"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

},

"WFIRE": {

"name": "火災危險警告",

"code": "WFIRER",

"type": "紅色",


"issueTime": "2020-09-24T11:15:00+08:00",

"updateTime": "2020-09-24T11:15:00+08:00"

}

}


13

詳細天氣警告資訊 (warningInfo)

參數說明細節

details1 詳細內容以陣列表示

contents1 內容以陣列表示

warningStatementCode 警告說明

代號

WFIRE: 火災危險警告

WFROST: 霜凍警告

WHOT: 酷熱天氣警告

WCOLD: 寒冷天氣警告

WMSGNL: 強烈季候風信號

WTCPRE8: 預警八號熱帶氣旋警告信號

之特別報告

WRAIN: 暴雨警告信號

WFNTSA: 新界北部水浸特別報告

WL: 山泥傾瀉警告

WTCSGNL: 熱帶氣旋警告信號

WTMW: 海嘯警告

WTS: 雷暴警告

subtype 警告的子

類型

只有

"火災危險警告"

"熱帶氣旋警告信號"

"暴雨警告信號"

有子類型

WFIRE:

WFIREY(黃色火災危險警告),

WFIRER(紅色火災危險警告)

WRAIN:

WRAINA(黃色暴雨警告信號),

WRAINR(紅色暴雨警告信號),

WRAINB(黑色暴雨警告信號)

WTCSGNL:

TC1(一號戒備信號),

TC3(三號強風信號),

TC8NE(八號東北烈風或暴風信號),

TC8SE(八號東南烈風或暴風信號),

TC8SW(八號西南烈風或暴風信號),

TC8NW(八號西北烈風或暴風信號),

TC9(九號烈風或暴風風力增強信號),


14

TC10(十號颶風信號)


例子:

2020-09-01T08:19:00+08:00


傳回例子。

詳細天氣警告資訊 (warningInfo) 的傳回例子:


{

"details": [{

"contents": ["雷暴警告", "天文台在 9 月 24 日上午 11 時 40 分發

出之雷暴警告，有效時間延長至今日下午 7 時 30 分，預料香港有雷暴。", "

雷暴發生時，請採取以下預防措施：", "1. 留在室內。在室外的人士應躲入建

築物內。", "2. 切勿站立於高地或接近導電的物體、樹木或桅杆。"],

"warningStatementCode": "WTS",

"updateTime": "2020-09-24T05:00:00+08:00"

}, {

"contents": ["強烈季候風信號在 11 時 15 分發出。"],

"warningStatementCode": "WMSGNL",

"updateTime": "2020-09-24T11:15:00+08:00"

}, {

"contents": ["山泥傾瀉警告：\n\n 天文台在 11:15 發出山泥傾瀉

警告。"],

"warningStatementCode": "WL",

"updateTime": "2020-09-24T11:15:00+08:00"

}, {

"contents": ["香港天文台在 07 時 00 分發出酷熱天氣警告。", "

天文台預料今日本港天氣酷熱，加上風勢輕微，市民應提高警惕，以防中

暑。", "在戶外工作或活動的人士，應多喝水和不要過度勞累。於感覺不適

時，應盡快到陰涼的地方休息。", "在沒有空調設備室內的人士，應盡量打開

窗戶以保持空氣流通。", "避免長時間在陽光下曝曬，以免受太陽紫外線曬

傷。應穿上鬆身衣服以及配戴適當帽子和能阻隔紫外線的太陽眼鏡。", "泳客

或在戶外遊玩的人士應重複塗抹防曬系數 15 或以上的太陽油。", "請關注長

者或慢性病患者的健康狀況。如認識他們，請間中致電或探訪他們，看看是

否需要提供幫助。"],

"warningStatementCode": "WHOT",


15

"updateTime": "2020-09-24T07:00:00+08:00"

}, {

"contents": ["香港天文台在上午 11 時 15 分發出寒冷天氣警告。

", "天文台預測本港今明兩日早晚天氣寒冷。", "晚間市區最低氣溫約在 9 度左

右或以下，新界北部地區及高地會再低一兩度。", "市民應注意保暖，多穿禦

寒衣物，並應保持室內空氣流通。", "由於部分地區風勢相當大，風寒效應明

顯，身體感覺的溫度比實際氣溫要低，長時間在寒風中有機會導致體溫過

低。", "如你認識獨居的長者或慢性病患者，請間中致電或探訪他們，看看是

否需要提供幫助。", "大帽山的路面會結冰，市民、駕駛人士及騎單車者需提

防路滑帶來的危險。", "市民使用暖爐或暖風機時，請注意消防安全，遠離易

燃物件，及避免電力負荷過重，並切勿於室內生火取暖。", "當使用舊式氣體

燃料熱水爐時，需確保室內有大量清新空氣。"],

"warningStatementCode": "WCOLD",

"updateTime": "2020-09-24T11:15:00+08:00"

}, {

"contents": ["Frost Warning", "天文台提醒農友及有關人士，明日

清晨在新界北部可能出現地面霜。"],

"warningStatementCode": "WFROST",

"updateTime": "2020-09-24T11:15:00+08:00"

}, {

"contents": ["天文台在上午 11 時 15 分發出紅色暴雨警告信號。

"],

"subtype": "WRAINR",

"warningStatementCode": "WRAIN",

"updateTime": "2020-09-24T11:15:00+08:00"

}, {

"contents": ["香港天文台在 9 月 24 日 11:40 發出之新界北部水

浸特別報告。", "新界北部，尤其是八鄉及錦田一帶，正受大雨影響。在過去

1 小時，該區錄得超過 70 毫米雨量。", "新界北部可能受大雨影響之市民，應

採取適當的預防措施，以防止水浸可能引致的損失。大雨可能引致山洪暴

發，市民應遠離河道。鄉村附近若有防洪警鐘，村民亦應留意。"],

"warningStatementCode": "WFNTSA",

"updateTime": "2020-09-24T11:40:00+08:00"

}, {

"contents": ["三號強風信號在上午 11 時 15 分發出。"],

"subtype": "TC3",

"warningStatementCode": "WTCSGNL",


16

"updateTime": "2020-09-24T11:15:00+08:00"

}, {

"contents": ["香港天文台宣布預計在今天（9 月 24 日）下午 4

時 07 分或以前發出八號熱帶氣旋警告信號，本港風勢將會加強。", "政府提

醒返家路程偏遠、轉折或居住離島的市民，現應啟程回家。政府已通知屬下

此類員工下班。", "教育局宣布：", "所有日校今日停課。假如夜校需要停課，

該局會於稍後公布。"],

"warningStatementCode": "WTCPRE8",

"updateTime": "2020-09-24T14:10:00+08:00"

}, {

"contents": ["香港天文台在 2020 年 9 月 24 日上午 11 時 15 分發

出海嘯警告。", "2020 年 9 月 24 日上午 11 時 10 分，在菲律賓棉蘭老島發生

6 級的猛烈地震。", "暫時未能確定有沒有海嘯產生，但為確保安全，市民應

採取預防措施。", "今天的正常潮水是：", "高水位：3.5 米於下午 6 時正", "低

水位：2.5 米於下午 4 時正", "1. 遠離岸邊、海灘及沿岸低窪地區。如身處這

些地點，應前往內陸地方或地勢較高的地面。如沒有時間迅速前往內陸地方

或地勢較高的地面，可棲身於以鋼筋混凝土建造的多層高建築物的較高樓

層，以策安全。", "2. 切勿進行水上活動。", "3. 船隻應遠離岸邊或淺水水

域。如船隻繼續繫泊於避風塘，應使用雙倍的繫泊用具，而所有人員均應離

開船隻，前往地勢較高的地面。", "4. 請遵照這些預防措施，直至天文台取消

海嘯警告。", "5. 請留意電台或電視台廣播的進一步資料。"],

"warningStatementCode": "WTMW",

"updateTime": "2020-09-24T11:15:00+08:00"

}, {

"contents": ["現時之火災危險警告為紅色，表示火災危險性極

高。"],

"warningStatementCode": "WFIRE",

"subtype": "WFIRER",

"updateTime": "2020-09-24T11:15:00+08:00"

}

]

}


17

特別天氣提示 (swt)

參數說明細節

desc1 提示內容 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00

updateTime1 提示更新時間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00


傳回例子。

特別天氣提示 (swt) 的傳回例子:


{

"swt": [{

"desc": "香港天文台宣布預計在今天（9 月 24 日）下午 4 時 07

分或以前發出八號熱帶氣旋警告信號，本港風勢將會加強。政府提醒返家路

程偏遠、轉折或居住離島的市民，現應啟程回家。政府已通知屬下此類員工

下班。教育局宣布：所有日校今日停課。假如夜校需要停課，該局會於稍後

公布。",

"updateTime": "2020-09-24T14:10:00+08:00"

}, {

"desc": "局部地區大雨報告：屯門區在下午 5 時正的過去一小時

錄得超過 70 毫米雨量，有可能出現嚴重水浸。",

"updateTime": "2020-09-10T16:40:00+08:00"

}

]

}


18

2. 地震資訊應用程式介面

數據集

- 地震速報

- 本地有感地震報告


https://data.weather.gov.hk/weatherAPI/opendata/earthquake.php


參數表。

HTTP 請求方法

GET

傳回類型

JSON

Request 例子

https://data.weather.gov.hk/weatherAPI/opendata/earthquake.php?dataType=qem

&lang=tc

Request


dataType qem

feltearthquake

qem: 地震速報

feltearthquake: 本地有感地震報告

lang en

tc

sc

en: 英文

tc: 繁體中文

sc: 簡體中文

預設語言: en

Response

本地有感地震報告


updateTime 上次更新時間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00

https://data.weather.gov.hk/weatherAPI/opendata/earthquake.php

https://data.weather.gov.hk/weatherAPI/opendata/earthquake.php?dataType=qem&lang=tc

https://data.weather.gov.hk/weatherAPI/opendata/earthquake.php?dataType=qem&lang=tc


19

mag 芮氏地震規模

region 地震地區

intensity 地震強度

lat 緯度

lon 經度

details 地震詳情

ptime 地震發生日期及時間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00

地震速報

參數說明細節

lat 緯度

lon 經度

mag 芮氏地震規模

region 地區

ptime 地震發生日期及時間 YYYY-MM-DD'T'hh:mm:ssZ

例子:

2020-09-01T08:19:00+08:00


例子:

2020-09-01T08:19:00+08:00


20

3. 開放數據（氣象及天氣資訊）應用程式介面

數據集

- 每小時潮汐高度

- 漲潮和退潮的時間和高度

- 日出、日中天、日落時間

- 月出、月中天、月落時間

- 雲對地及雲間閃電次數

- 最新十分鐘平均能見度

- 日平均氣溫

- 日最高氣溫

- 日最低氣溫

- 天氣及輻射水平資料


https://data.weather.gov.hk/weatherAPI/opendata/opendata.php


參數表。

HTTP 請求方法

GET

傳回類型

JSON 或 CSV

Request 例子

https://data.weather.gov.hk/weatherAPI/opendata/opendata.php?dataType=LTMV

&lang=tc&rformat=csv

Request

每小時潮汐高度


dataType HHOT HHOT: 每小時潮汐高度

rformat json

csv

傳回數據格式

預設傳回類型: CSV

https://data.weather.gov.hk/weatherAPI/opendata/opendata.php

https://data.weather.gov.hk/weatherAPI/opendata/opendata.php?dataType=LTMV&lang=tc&rformat=csv

https://data.weather.gov.hk/weatherAPI/opendata/opendata.php?dataType=LTMV&lang=tc&rformat=csv


21

station CCH

CLK

CMW

KCT

KLW

LOP

MWC

QUB

SPW

TAO

TBT

TMW

TPK

WAG

分區站代號:

CCH: 長洲

CLK: 赤鱲角

CMW: 芝麻灣

KCT: 葵涌

KLW: 高流灣

LOP: 樂安排

MWC: 馬灣

QUB: 鰂魚涌

SPW: 石壁

TAO: 大澳

TBT: 尖鼻咀

TMW: 大廟灣

TPK: 大埔滘

WAG: 橫瀾島

year 2020 - 2022 年份

month 1 - 12 非必要。傳遞此參數時請提供參

數「year」

day 1 - 31 非必要。傳遞此參數時請提供參

數「year」「month」

hour 1 - 24 非必要。傳遞此參數時請提供參

數「year」「month」「day」

漲潮和退潮的時間和高度


dataType HLT HLT: 漲潮和退潮的時間和高度

rformat json

csv

傳回數據格式



22

station CCH

CLK

CMW

KCT

KLW

LOP

MWC

QUB

SPW

TAO

TBT

TMW

TPK

WAG

分區站代號:

CCH: 長洲

CLK: 赤鱲角

CMW: 芝麻灣

KCT: 葵涌

KLW: 高流灣

LOP: 樂安排

MWC: 馬灣

QUB: 鰂魚涌

SPW: 石壁

TAO: 大澳

TBT: 尖鼻咀

TMW: 大廟灣

TPK: 大埔滘

WAG: 橫瀾島

year 2020 - 2022 年份

month 1 - 12 非必要。傳遞此參數時請提供參數

「year」

day 1 - 31 非必要。傳遞此參數時請提供參數

「year」「month」

hour 1 - 24 非必要。傳遞此參數時請提供參數

「year」「month」「day」

日出、日中天、日落時間


dataType SRS SRS: 日出、日中天、日落時間

rformat json

csv

傳回數據格式


year 2018 - 2022 年份


「year」




23

月出、月中天、月落時間


dataType MRS MRS: 月出、月中天、月落時間

rformat json

csv

傳回數據格式


year 2018 - 2022 年份


「year」



雲對地及雲間閃電次數


dataType LHL LHL: 雲對地及雲間閃電次數

rformat json

csv

傳回數據格式


lang en

tc

sc

en: 英文

tc: 繁體中文

sc: 簡體中文

最新十分鐘平均能見度


dataType LTMV LTMV: 最新十分鐘平均能見度

rformat json

csv

傳回數據格式


lang en

tc

sc

en: 英文

tc: 繁體中文

sc: 簡體中文

日平均氣溫


dataType CLMTEMP CLMTEMP: 日平均氣溫

rformat json

csv

傳回數據格式


station CCH CCH: 長洲


24

CWB

HKA

HKO

HKP

HKS

HPV

JKB

KLT

KP

KSC

KTG

LFS

NGP

PEN

PLC

SE1

SEK

SHA

SKG

SKW

SSH

SSP

STY

TC

TKL

TMS

TPO

TU1

TW

TWN

TY1

TYW

VP1

WGL

WLP

WTS

YLP

CWB: 清水灣

HKA: 香港國際機場

HKO: 香港天文台

HKP: 香港公園

HKS: 黃竹坑

HPV: 跑馬地

JKB: 將軍澳

KLT: 九龍城

KP: 京士柏

KSC: 滘西洲

KTG: 觀塘

LFS: 流浮山

NGP: 昂坪

PEN: 坪洲

PLC: 大美督

SE1: 啟德跑道公園

SEK: 石崗

SHA: 沙田

SKG: 西貢

SKW: 筲箕灣

SSH: 上水

SSP: 深水埗

STY: 赤柱

TC: 大老山

TKL: 打鼓嶺

TMS: 大帽山

TPO: 大埔

TU1: 屯門兒童及青少年院

TW: 荃灣城門谷

TWN: 荃灣

TY1: 新青衣站

TYW: 北潭涌(鯽魚湖)

VP1: 山頂

WGL: 橫瀾島

WLP: 濕地公園

WTS: 黃大仙

YLP: 元朗公園


25

year 1884 - 本年 1 年份範圍:

CCH: 1992 至本年

CWB: 2018 至本年

HKA: 1997 至本年

HKO: 1884 至本年（不包括 1940 至

1946）

HKP: 2007 至本年

HKS: 1989 至本年

HPV: 2008 至本年

JKB: 1991 至本年

KLT: 2008 至本年

KP: 1992 至本年

KSC: 2008 至本年

KTG: 2009 至本年

LFS: 1985 至本年

NGP: 2003 至本年

PEN: 2004 至本年

PLC: 1993 至本年

SE1: 2014 至本年

SEK: 1996 至本年

SHA: 1984 至本年

SKG: 1993 至本年

SKW: 2007 至本年

SSH: 2004 至本年

SSP: 2010 至本年

STY: 2009 至本年

TC: 1997 至本年

TKL: 1988 至本年

TMS: 1997 至本年

TPO: 1999 至本年

TU1: 2007 至本年

TW: 2010 至本年

TWN: 2006 至本年

TY1: 2010 至本年

TYW: 1995 至本年

VP1: 2003 至本年

WGL: 1989 至本年


26

WLP: 2005 至本年

WTS: 2009 至本年

YLP: 2015 至本年

預設傳回數據: 所有年份


「year」

1. 每個站有不同的年份範圍。請查看說明以了解詳情。

日最高氣溫


dataType CLMMAXT CLMMAXT: 日最高氣溫

rformat json

csv

傳回數據格式


station CCH

CWB

HKA

HKO

HKP

HKS

HPV

JKB

KLT

KP

KSC

KTG

LFS

NGP

PEN

PLC

SE1

SEK

SHA

SKG

SKW

SSH

SSP

CCH: 長洲

CWB: 清水灣



HKP: 香港公園

HKS: 黃竹坑

HPV: 跑馬地

JKB: 將軍澳

KLT: 九龍城

KP: 京士柏

KSC: 滘西洲

KTG: 觀塘

LFS: 流浮山

NGP: 昂坪

PEN: 坪洲

PLC: 大美督


SEK: 石崗

SHA: 沙田

SKG: 西貢

SKW: 筲箕灣

SSH: 上水

SSP: 深水埗


27

STY

TC

TKL

TMS

TPO

TU1

TW

TWN

TY1

TYW

VP1

WGL

WLP

WTS

YLP

STY: 赤柱

TC: 大老山

TKL: 打鼓嶺

TMS: 大帽山

TPO: 大埔


TW: 荃灣城門谷

TWN: 荃灣

TY1: 新青衣站


VP1: 山頂

WGL: 橫瀾島

WLP: 濕地公園

WTS: 黃大仙

YLP: 元朗公園


CCH: 1992 至本年

CWB: 2018 至本年

HKA: 1997 至本年

HKO: 1884 至本年（不包括 1940

至 1946）

HKP: 2007 至本年

HKS: 1989 至本年

HPV: 2008 至本年

JKB: 1991 至本年

KLT: 2008 至本年

KP: 1992 至本年

KSC: 2008 至本年

KTG: 2009 至本年

LFS: 1985 至本年

NGP: 2003 至本年

PEN: 2004 至本年

PLC: 1993 至本年

SE1: 2014 至本年

SEK: 1996 至本年

SHA: 1984 至本年

SKG: 1993 至本年


28

SKW: 2007 至本年

SSH: 2004 至本年

SSP: 2010 至本年

STY: 2009 至本年

TC: 1997 至本年

TKL: 1988 至本年

TMS: 1997 至本年

TPO: 1999 至本年

TU1: 2007 至本年

TW: 2010 至本年

TWN: 2006 至本年

TY1: 2010 至本年

TYW: 1995 至本年

VP1: 2003 至本年

WGL: 1989 至本年

WLP: 2005 至本年

WTS: 2009 至本年

YLP: 2015 至本年


month 1 - 12 非必要。傳遞此參數時請提供參

數「year」


日最低氣溫


dataType CLMMINT CLMMINT: 日最低氣溫

rformat json

csv

傳回數據格式


station CCH

CWB

HKA

HKO

HKP

HKS

HPV

JKB

CCH: 長洲

CWB: 清水灣



HKP: 香港公園

HKS: 黃竹坑

HPV: 跑馬地

JKB: 將軍澳


29

KLT

KP

KSC

KTG

LFS

NGP

PEN

PLC

SE1

SEK

SHA

SKG

SKW

SSH

SSP

STY

TC

TKL

TMS

TPO

TU1

TW

TWN

TY1

TYW

VP1

WGL

WLP

WTS

YLP

KLT: 九龍城

KP: 京士柏

KSC: 滘西洲

KTG: 觀塘

LFS: 流浮山

NGP: 昂坪

PEN: 坪洲

PLC: 大美督


SEK: 石崗

SHA: 沙田

SKG: 西貢

SKW: 筲箕灣

SSH: 上水

SSP: 深水埗

STY: 赤柱

TC: 大老山

TKL: 打鼓嶺

TMS: 大帽山

TPO: 大埔


TW: 荃灣城門谷

TWN: 荃灣

TY1: 新青衣站


VP1: 山頂

WGL: 橫瀾島

WLP: 濕地公園

WTS: 黃大仙

YLP: 元朗公園


CCH: 1992 至本年

CWB: 2018 至本年

HKA: 1997 至本年

HKO: 1884 至本年（不包括 1940 至

1946）

HKP: 2007 至本年


30

HKS: 1989 至本年

HPV: 2008 至本年

JKB: 1991 至本年

KLT: 2008 至本年

KP: 1992 至本年

KSC: 2008 至本年

KTG: 2009 至本年

LFS: 1985 至本年

NGP: 2003 至本年

PEN: 2004 至本年

PLC: 1993 至本年

SE1: 2014 至本年

SEK: 1996 至本年

SHA: 1984 至本年

SKG: 1993 至本年

SKW: 2007 至本年

SSH: 2004 至本年

SSP: 2010 至本年

STY: 2009 至本年

TC: 1997 至本年

TKL: 1988 至本年

TMS: 1997 至本年

TPO: 1999 至本年

TU1: 2007 至本年

TW: 2010 至本年

TWN: 2006 至本年

TY1: 2010 至本年

TYW: 1995 至本年

VP1: 2003 至本年

WGL: 1989 至本年

WLP: 2005 至本年

WTS: 2009 至本年

YLP: 2015 至本年



「year」



31

天氣及輻射水平資料


dataType RYES RYES: 天氣及輻射水平資料

date 20190910 - 昨天 1 天氣及輻射水平資料日期

lang en

tc

sc

en: 英文

tc: 繁體中文

sc: 簡體中文

預設語言: en

station CLK

CCH

HKO

HPV

HKP

SE1

KAT

KP

KLT

KTG

LFS

EPC

SKG

SWH

STK

SHA

SSP

SKW

SEK

STY

TKL

PLC

TPO

TAP

JKB

TBT

TY1

CCH: 長洲

CLK: 赤鱲角

EPC: 平洲


HKP: 香港公園

HKS: 黃竹坑

HPV: 跑馬地

JKB: 將軍澳

KAT: 吉澳

KLT: 九龍城

KP: 京士柏

KTG: 觀塘

LFS: 流浮山

PLC: 大美督


SEK: 石崗

SHA: 沙田

SKG: 西貢

SKW: 筲箕灣

SSP: 深水埗

STK: 沙頭角

STY: 赤柱

SWH: 西灣河

TAP: 塔門

TBT: 尖鼻咀

TKL: 打鼓嶺

TPO: 大埔


32

TWN

TW

TUN

HKS

WTS

YLP

YNF

TUN: 屯門

TW: 荃灣城門谷

TWN: 荃灣可觀

TY1: 青衣

WTS: 黃大仙

YLP: 元朗公園

YNF: 元五墳

1. 數據將於第二天的 01:30 GMT+0800 後提供。

Response

CSV

數據集數據類型說明

每小時潮汐高度 HHOT 第 1 行: 標題

第 2 行到結尾: 數據漲潮和退潮的時間和高度 HLT

日出、日中天、日落時間 SRS

月出、月中天、月落時間 MRS

雲對地及雲間閃電次數 LHL

最新十分鐘平均能見度 LTMV

日平均氣溫 CLMTEMP 第 1,2 行: 類型

第 3 行: 標題

第 4 行到尾段空白行: 數據

空白行之後: 示例

日最高氣溫 CLMMAXT

日最低氣溫 CLMMINT

JSON

數據集數據類型說明

每小時潮汐高度 HHOT {

"fields' : ["...", "...", ...],

"data" : [["...", "...", ...], ["...", "...", ...], ...]

}

漲潮和退潮的時間和高度 HLT

日出、日中天、日落時間 SRS


33

月出、月中天、月落時間 MRS

雲對地及雲間閃電次數 LHL

最新十分鐘平均能見度 LTMV

日平均氣溫 CLMTEMP {

"type" : ["...", "..."],

"fields' : ["...", "...", ...],

"data" : [["...", "...", ...], ["...", "...", ...], ...],

"legend" : ["...", "...", ...]

}

日最高氣溫 CLMMAXT

日最低氣溫 CLMMINT

天氣及輻射水平資料 RYES {

type: data,

type: data,

...

type: data,

}

“type”格式:

{氣象站} + {屬性}1

{其他屬性}

{氣象站} 列表:

CheungChau: 長洲

ChekLapKok: 赤鱲角

PingChau: 平洲


HongKongPark: 香港公園

WongChukHang: 黃竹坑

HappyValley: 跑馬地

TseungKwanO: 將軍澳

KatO: 吉澳

KowloonCity: 九龍城

KingsPark: 京士柏

KwunTong: 觀塘


34

LauFauShan: 流浮山

TaiMeiTuk: 大美督

KaiTakRunwayPark: 啟德跑道公園

ShekKong: 石崗

ShaTin: 沙田

SaiKung: 西貢

ShauKeiWan: 筲箕灣

ShamShuiPo: 深水埗

ShaTauKok: 沙頭角

Stanley: 赤柱

SaiWanHo: 西灣河

TapMun: 塔門

TsimBeiTsui: 尖鼻咀

TaKwuLing: 打鼓嶺

TaiPo: 大埔

TuenMun: 屯門

TsuenWanShingMunValley: 荃灣城門谷

TsuenWanHoKoon: 荃灣可觀

TsingYi: 青衣

WongTaiSin: 黃大仙

YuenLongPark: 元朗公園

YuenNgFan: 元五墳

{屬性} 列表:

LocationName: 氣象站

MaxTemp: 最高氣溫 (攝氏)

ReadingsMaxTemp: 最高氣溫 (攝氏)

ReadingsMaxRH: 最高相對濕度 (%)

ReadingsAvgRainfall: 平均雨量 (毫米)

ReadingsAccumRainfall: 由本年一月一日起之

總雨量 (毫米)

Microsieverts: 平均環境伽瑪輻射劑量率(微希

沃特 / 小時)

MinTemp: 最低氣溫 (攝氏)

ReadingsMaxUVIndex: 最高的紫外線指數

ReadingsMinGrassTemp: 最低草溫 (攝氏)

ReadingsMinRH: 最低相對濕度 (%)


35

ReadingsRainfall: 雨量(毫米)

ReadingsMeanUVIndex: 平均紫外線指數

ReadingsSunShine: 日照時間(小時)

ReadingsMinTemp: 最低氣溫 (攝氏)

{其他屬性} 列表:

BulletinDate: 資料發出日期 (YYYYMMDD)

BulletinTime: 資料發出時間 (HHMM)

HongKongDesc: 香港所錄得的平均戶外環境

伽瑪輻射劑量率的描述

NoteDesc: 註釋

NoteDesc1: 註釋 1

NoteDesc2: 註釋 2

NoteDesc3: 註釋 3

ReportTimeInfoDate: 資料日期 (YYYYMMDD)

1. 只有適用的屬性會包括在個別氣象站的傳回的參數。屬性為 null 或不適用

時，有可能缺少傳回的參數。或者將傳回空白字串。

香港天文台 開放數據應用程式介面說明書 ·...

Documents

香港天文台開放數據應用程式介面說明書 ·...