@agentgo-tw/app-sdk 0.0.0-stage → 2.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +552 -2
- package/dist/browser.cjs +335 -0
- package/dist/browser.d.cts +22 -0
- package/dist/browser.d.ts +22 -0
- package/dist/browser.js +66 -0
- package/dist/chunk-4KBWZDXW.js +208 -0
- package/dist/chunk-VCZOS6GJ.js +61 -0
- package/dist/client.cjs +283 -0
- package/dist/client.d.cts +76 -0
- package/dist/client.d.ts +76 -0
- package/dist/client.js +205 -0
- package/dist/index.cjs +634 -0
- package/dist/index.d.cts +145 -0
- package/dist/index.d.ts +145 -0
- package/dist/index.js +364 -0
- package/dist/od-BVdmZf1t.d.cts +2331 -0
- package/dist/od-sGQixHat.d.ts +2331 -0
- package/dist/version-ClrVQNzw.d.cts +214 -0
- package/dist/version-ClrVQNzw.d.ts +214 -0
- package/package.json +67 -4
|
@@ -0,0 +1,2331 @@
|
|
|
1
|
+
import { q as ChatCompletionRequest, o as ChatCompletion, p as ChatCompletionChunk, I as ImageGenerateRequest, t as ImageGenerateResponse, v as SpeechRequest, w as SpeechResponse } from './version-ClrVQNzw.js';
|
|
2
|
+
|
|
3
|
+
interface AcademyAI {
|
|
4
|
+
chat: {
|
|
5
|
+
completions: {
|
|
6
|
+
create(body: ChatCompletionRequest & {
|
|
7
|
+
stream?: false;
|
|
8
|
+
}): Promise<ChatCompletion>;
|
|
9
|
+
create(body: ChatCompletionRequest & {
|
|
10
|
+
stream: true;
|
|
11
|
+
}): Promise<AsyncIterable<ChatCompletionChunk>>;
|
|
12
|
+
};
|
|
13
|
+
};
|
|
14
|
+
images: {
|
|
15
|
+
generate(body: ImageGenerateRequest): Promise<ImageGenerateResponse>;
|
|
16
|
+
};
|
|
17
|
+
audio: {
|
|
18
|
+
speech: {
|
|
19
|
+
create(body: SpeechRequest): Promise<SpeechResponse>;
|
|
20
|
+
};
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** 查詢參數:與研究所 MCP 的開放資料工具相同(中文縣市名、萬元/坪、坪),陣列以逗號送出 */
|
|
25
|
+
type OdQuery = Record<string, string | number | boolean | Array<string | number> | undefined | null>;
|
|
26
|
+
type OdResult = Record<string, unknown>;
|
|
27
|
+
/** 位置:`address`(地址原文)或 `lat`+`lng`(WGS84)二擇一。門牌資料尚未涵蓋全部縣市,未涵蓋或查無門牌時回 `INVALID_REQUEST` */
|
|
28
|
+
interface OdLocation {
|
|
29
|
+
/** 地址原文(最長 200 字);要是完整門牌才定位得到 */
|
|
30
|
+
address?: string;
|
|
31
|
+
/** 緯度(WGS84),與 lng 成對 */
|
|
32
|
+
lat?: number;
|
|
33
|
+
/** 經度(WGS84),與 lat 成對 */
|
|
34
|
+
lng?: number;
|
|
35
|
+
}
|
|
36
|
+
/** 以地址定位時回應附帶的中心點 */
|
|
37
|
+
interface OdCenter {
|
|
38
|
+
lat: number;
|
|
39
|
+
lng: number;
|
|
40
|
+
resolved_from: 'coordinates' | 'address';
|
|
41
|
+
/** 由地址定位時是正規化後的門牌,直接給座標時為 null */
|
|
42
|
+
address: string | null;
|
|
43
|
+
}
|
|
44
|
+
/** 社區價格:該建案「預售成交歷史」的統計,已扣車位;不是目前的中古行情 */
|
|
45
|
+
interface OdCommunityPrice {
|
|
46
|
+
/** available=有價格/insufficient_sample=樣本少於 5 筆/empty=沒有有效樣本/no_data=沒有價格資料 */
|
|
47
|
+
status_code: 'available' | 'insufficient_sample' | 'empty' | 'no_data' | (string & {});
|
|
48
|
+
/** 狀態的中文說明(沒有價格時說明原因) */
|
|
49
|
+
status: string;
|
|
50
|
+
/** 平均單價(萬元/坪);status_code 不是 available 時為 null */
|
|
51
|
+
avg_price_wan_per_ping: number | null;
|
|
52
|
+
/** 單價中位數(萬元/坪);status_code 不是 available 時為 null */
|
|
53
|
+
median_price_wan_per_ping: number | null;
|
|
54
|
+
/** 有效成交樣本數 */
|
|
55
|
+
sample_count: number | null;
|
|
56
|
+
/** 樣本期間(YYYY-MM-DD) */
|
|
57
|
+
period_from: string | null;
|
|
58
|
+
period_to: string | null;
|
|
59
|
+
/** 其中車位價為推估的筆數 */
|
|
60
|
+
parking_estimated_count: number | null;
|
|
61
|
+
}
|
|
62
|
+
interface OdCommunity {
|
|
63
|
+
id: number;
|
|
64
|
+
name: string;
|
|
65
|
+
city: string | null;
|
|
66
|
+
/** 鄉鎮市區 */
|
|
67
|
+
district: string | null;
|
|
68
|
+
address: string | null;
|
|
69
|
+
lat: number | null;
|
|
70
|
+
lng: number | null;
|
|
71
|
+
/** 建檔來源(中文):預售成交聚合/公寓大廈報備清冊/民間社區清單 */
|
|
72
|
+
origin: string | null;
|
|
73
|
+
origin_code: 'presale' | 'registry' | 'listing' | (string & {}) | null;
|
|
74
|
+
/** 總戶數;null=未查得,不得推算 */
|
|
75
|
+
total_units: number | null;
|
|
76
|
+
/** 建設公司;null=未查得 */
|
|
77
|
+
builder: string | null;
|
|
78
|
+
/** 預售成交筆數;清冊與民間清單建檔的社區為 null */
|
|
79
|
+
transaction_count: number | null;
|
|
80
|
+
price: OdCommunityPrice;
|
|
81
|
+
/** 與查詢位置的直線距離(公尺);只有 nearby 有 */
|
|
82
|
+
distance_m?: number | null;
|
|
83
|
+
}
|
|
84
|
+
interface OdCommunityListResult {
|
|
85
|
+
items: OdCommunity[];
|
|
86
|
+
count: number;
|
|
87
|
+
/** 查無時的說明 */
|
|
88
|
+
message: string | null;
|
|
89
|
+
/** 固定提醒:社區名單不完整(老社區可能缺席)、null 表示未查得 */
|
|
90
|
+
notice: string;
|
|
91
|
+
/** 價格口徑的固定提醒 */
|
|
92
|
+
price_notice: string;
|
|
93
|
+
attribution: string;
|
|
94
|
+
[key: string]: unknown;
|
|
95
|
+
}
|
|
96
|
+
interface OdCommunitySuggestQuery {
|
|
97
|
+
/** 社區名稱關鍵字(名稱任一段都會比對),最長 200 字 */
|
|
98
|
+
keyword: string;
|
|
99
|
+
/** 縣市名(中文,台/臺皆可);不帶就不限縣市 */
|
|
100
|
+
city?: string;
|
|
101
|
+
/** 回傳筆數上限,1~20,預設 10 */
|
|
102
|
+
limit?: number;
|
|
103
|
+
}
|
|
104
|
+
interface OdCommunityMatchQuery {
|
|
105
|
+
/** 要比對的社區名稱,最長 200 字 */
|
|
106
|
+
name: string;
|
|
107
|
+
/** 縣市名(中文,台/臺皆可) */
|
|
108
|
+
city?: string;
|
|
109
|
+
}
|
|
110
|
+
interface OdCommunityMatchItem {
|
|
111
|
+
id: number;
|
|
112
|
+
name: string;
|
|
113
|
+
aliases: string[];
|
|
114
|
+
city: string | null;
|
|
115
|
+
district: string | null;
|
|
116
|
+
address: string | null;
|
|
117
|
+
origin: string | null;
|
|
118
|
+
origin_code: string | null;
|
|
119
|
+
total_units: number | null;
|
|
120
|
+
builder: string | null;
|
|
121
|
+
/** 建築年份(官方紀錄);未完工或未查得為 null */
|
|
122
|
+
build_year_range: string | null;
|
|
123
|
+
/** 預售交易年份區間,例如「2019-2022」 */
|
|
124
|
+
sale_year_range: string | null;
|
|
125
|
+
transaction_count: number | null;
|
|
126
|
+
/** 只有模糊比對有:相似度(對中文不可靠) */
|
|
127
|
+
similarity?: number | null;
|
|
128
|
+
}
|
|
129
|
+
interface OdCommunityMatchResult {
|
|
130
|
+
/** 命中的比對層級(中文) */
|
|
131
|
+
level: string;
|
|
132
|
+
/** exact=名稱完全相同/alias=別名/prefix=開頭相符/fuzzy=模糊比對 */
|
|
133
|
+
level_code: 'exact' | 'alias' | 'prefix' | 'fuzzy';
|
|
134
|
+
/** false=模糊比對:對中文名稱幾乎是隨機的,**結果不可當成正確答案** */
|
|
135
|
+
reliable: boolean;
|
|
136
|
+
/** 每一級最多 10 筆;不含價格(價格以 id 查 `communities.get`) */
|
|
137
|
+
items: OdCommunityMatchItem[];
|
|
138
|
+
count: number;
|
|
139
|
+
message: string | null;
|
|
140
|
+
notice: string;
|
|
141
|
+
attribution: string;
|
|
142
|
+
[key: string]: unknown;
|
|
143
|
+
}
|
|
144
|
+
interface OdCommunityNearbyQuery extends OdLocation {
|
|
145
|
+
/** 搜尋半徑(公尺),50~2000,預設 500 */
|
|
146
|
+
radius?: number;
|
|
147
|
+
/** 回傳筆數上限,1~20,預設 5 */
|
|
148
|
+
limit?: number;
|
|
149
|
+
}
|
|
150
|
+
interface OdCommunityInBoundsQuery {
|
|
151
|
+
/** 西南角緯度(要小於 ne_lat) */
|
|
152
|
+
sw_lat: number;
|
|
153
|
+
/** 西南角經度(要小於 ne_lng) */
|
|
154
|
+
sw_lng: number;
|
|
155
|
+
/** 東北角緯度 */
|
|
156
|
+
ne_lat: number;
|
|
157
|
+
/** 東北角經度 */
|
|
158
|
+
ne_lng: number;
|
|
159
|
+
/** 最少成交筆數門檻,0~10000,預設 0;大於 0 會排除沒有交易的清冊社區 */
|
|
160
|
+
min_transactions?: number;
|
|
161
|
+
/** 回傳筆數上限,1~500,預設 200 */
|
|
162
|
+
limit?: number;
|
|
163
|
+
}
|
|
164
|
+
interface OdCommunityByAreaQuery {
|
|
165
|
+
/** 縣市名(中文,台/臺皆可) */
|
|
166
|
+
city: string;
|
|
167
|
+
/** 鄉鎮市區名,例如「北屯區」 */
|
|
168
|
+
district: string;
|
|
169
|
+
/** 回傳筆數上限,1~100,預設 30 */
|
|
170
|
+
limit?: number;
|
|
171
|
+
}
|
|
172
|
+
interface OdCommunityByAreaResult {
|
|
173
|
+
city: string;
|
|
174
|
+
district: string;
|
|
175
|
+
/** 只有名稱與別名(不含價格與座標) */
|
|
176
|
+
items: Array<{
|
|
177
|
+
id: number;
|
|
178
|
+
name: string;
|
|
179
|
+
aliases: string[];
|
|
180
|
+
}>;
|
|
181
|
+
count: number;
|
|
182
|
+
message: string | null;
|
|
183
|
+
notice: string;
|
|
184
|
+
attribution: string;
|
|
185
|
+
}
|
|
186
|
+
/** 公開資料的一項事實:來源不一致時 value 為 null,各來源的值列在 alternatives */
|
|
187
|
+
interface OdPublicFact<T = unknown> {
|
|
188
|
+
/** 已查得/未查得/來源不一致 */
|
|
189
|
+
state: string;
|
|
190
|
+
state_code: 'known' | 'unknown' | 'conflict' | (string & {});
|
|
191
|
+
value: T | null;
|
|
192
|
+
sources: OdPublicSource[];
|
|
193
|
+
alternatives?: Array<{
|
|
194
|
+
value: T | null;
|
|
195
|
+
sources: OdPublicSource[];
|
|
196
|
+
}>;
|
|
197
|
+
}
|
|
198
|
+
interface OdPublicSource {
|
|
199
|
+
source: string | null;
|
|
200
|
+
source_url: string | null;
|
|
201
|
+
/** 官方標示的更新時間;官方沒標示為 null */
|
|
202
|
+
source_updated_at: string | null;
|
|
203
|
+
/** 平台取得資料的時間 */
|
|
204
|
+
fetched_at: string | null;
|
|
205
|
+
}
|
|
206
|
+
interface OdCommunityDetail extends OdCommunity {
|
|
207
|
+
/** false=來源最新一期沒有收錄(歷史資料),不代表社區不存在 */
|
|
208
|
+
is_active: boolean;
|
|
209
|
+
last_seen_at: string | null;
|
|
210
|
+
/** 建築年份(保存登記或使照竣工的官方紀錄);未完工或未查得為 null,不得推算 */
|
|
211
|
+
build_year_range: string | null;
|
|
212
|
+
/** 建照核發日期 */
|
|
213
|
+
permit_date: string | null;
|
|
214
|
+
sale_year_range: string | null;
|
|
215
|
+
/** 建物型態(中文):大樓/華廈/公寓/透天/別墅 */
|
|
216
|
+
building_type: string | null;
|
|
217
|
+
building_type_code: string | null;
|
|
218
|
+
/** 民間清單屋齡換算的完工年(**推估值**),不可與 build_year_range 混用 */
|
|
219
|
+
estimated_build_year: number | null;
|
|
220
|
+
/** 公開資料狀態(中文) */
|
|
221
|
+
public_profile_status: string;
|
|
222
|
+
/** available=有公開資料/not_collected=尚未蒐集到/unavailable=這次查詢失敗(主檔照常提供) */
|
|
223
|
+
public_profile_status_code: 'available' | 'not_collected' | 'unavailable' | (string & {});
|
|
224
|
+
/** 官方清冊與使用執照整理的公開資料;status 不是 available 時為 null */
|
|
225
|
+
public_profile: {
|
|
226
|
+
/** 整個社區範圍的事實(total_units、building_count、floors_above、floors_below、structure、completed_on) */
|
|
227
|
+
building: Record<string, OdPublicFact>;
|
|
228
|
+
management_registration: Record<string, OdPublicFact>;
|
|
229
|
+
/** 逐張使用執照自己的數字(一張使照的戶數不等於社區總戶數) */
|
|
230
|
+
use_permits: Array<{
|
|
231
|
+
permit_no: string | null;
|
|
232
|
+
} & Record<string, unknown>>;
|
|
233
|
+
/** 已查得的一部分地址,不是完整門牌 */
|
|
234
|
+
addresses: Array<{
|
|
235
|
+
address: string | null;
|
|
236
|
+
building_label: string | null;
|
|
237
|
+
kind: string | null;
|
|
238
|
+
match_status: string | null;
|
|
239
|
+
sources: OdPublicSource[];
|
|
240
|
+
}>;
|
|
241
|
+
notice: string;
|
|
242
|
+
} | null;
|
|
243
|
+
}
|
|
244
|
+
interface OdCommunityDetailResult {
|
|
245
|
+
/** 查無此 id 為 null */
|
|
246
|
+
item: OdCommunityDetail | null;
|
|
247
|
+
message: string | null;
|
|
248
|
+
notice: string;
|
|
249
|
+
price_notice: string;
|
|
250
|
+
attribution: string;
|
|
251
|
+
}
|
|
252
|
+
type OdSchoolLevel = 'elementary' | 'junior_high';
|
|
253
|
+
interface OdSchool {
|
|
254
|
+
id: string;
|
|
255
|
+
name: string;
|
|
256
|
+
/** 學制(依校名判斷):國小/國中/高中職;判斷不出來為空陣列 */
|
|
257
|
+
levels: string[];
|
|
258
|
+
city: string | null;
|
|
259
|
+
district: string | null;
|
|
260
|
+
address: string | null;
|
|
261
|
+
phone: string | null;
|
|
262
|
+
website: string | null;
|
|
263
|
+
student_count: number | null;
|
|
264
|
+
/** 公私立別(來源原文;未填為 null) */
|
|
265
|
+
ownership: string | null;
|
|
266
|
+
academic_year: string | number | null;
|
|
267
|
+
school_code: string | null;
|
|
268
|
+
/** 校地位置(質心),不是學區範圍 */
|
|
269
|
+
lat: number | null;
|
|
270
|
+
lng: number | null;
|
|
271
|
+
/** 到校地的直線距離(公尺);落在校地內為 0。只有 nearby 有 */
|
|
272
|
+
distance_m?: number | null;
|
|
273
|
+
}
|
|
274
|
+
interface OdSchoolsNearbyQuery extends OdLocation {
|
|
275
|
+
/** 只看哪些學制:elementary(國小)、junior_high(國中);不帶就不篩選。座標須在台灣範圍(緯度 21~26、經度 118~123) */
|
|
276
|
+
level?: OdSchoolLevel | OdSchoolLevel[];
|
|
277
|
+
}
|
|
278
|
+
interface OdSchoolsNearbyResult {
|
|
279
|
+
center: OdCenter;
|
|
280
|
+
/** 這次結果的性質(中文) */
|
|
281
|
+
match: string;
|
|
282
|
+
/** on_campus=位置落在校地內/nearest=2 公里內最近的學校(最多 5 所)/none=2 公里內沒有學校 */
|
|
283
|
+
match_code: 'on_campus' | 'nearest' | 'none';
|
|
284
|
+
level_filter: string[] | null;
|
|
285
|
+
items: OdSchool[];
|
|
286
|
+
count: number;
|
|
287
|
+
message: string | null;
|
|
288
|
+
notice: string;
|
|
289
|
+
/** 固定提醒:這是鄰近學校,不是學區劃分。**請顯示給使用者** */
|
|
290
|
+
disclaimer: string;
|
|
291
|
+
attribution: string;
|
|
292
|
+
}
|
|
293
|
+
interface OdSchoolsSearchQuery {
|
|
294
|
+
/** 校名關鍵字(名稱任一段),最長 100 字 */
|
|
295
|
+
keyword: string;
|
|
296
|
+
/** 縣市名(中文,台/臺皆可) */
|
|
297
|
+
city?: string;
|
|
298
|
+
}
|
|
299
|
+
interface OdSchoolsSearchResult {
|
|
300
|
+
/** 最多 50 所;校地位置尚未建檔的學校查不到 */
|
|
301
|
+
items: OdSchool[];
|
|
302
|
+
count: number;
|
|
303
|
+
/** true=達到 50 所上限,可能還有其他學校 */
|
|
304
|
+
truncated: boolean;
|
|
305
|
+
message: string | null;
|
|
306
|
+
notice: string;
|
|
307
|
+
disclaimer: string;
|
|
308
|
+
attribution: string;
|
|
309
|
+
[key: string]: unknown;
|
|
310
|
+
}
|
|
311
|
+
/** 批次查詢的一個座標 */
|
|
312
|
+
interface OdPoint {
|
|
313
|
+
lat: number;
|
|
314
|
+
lng: number;
|
|
315
|
+
}
|
|
316
|
+
interface OdSchoolsNearbyBatchResult {
|
|
317
|
+
/** 與送入的座標同順序;on_campus 為 false 表示該座標不在任何校地內 */
|
|
318
|
+
results: Array<{
|
|
319
|
+
index: number;
|
|
320
|
+
lat: number;
|
|
321
|
+
lng: number;
|
|
322
|
+
on_campus: boolean;
|
|
323
|
+
schools: Array<{
|
|
324
|
+
id: string;
|
|
325
|
+
name: string;
|
|
326
|
+
levels: string[];
|
|
327
|
+
}>;
|
|
328
|
+
}>;
|
|
329
|
+
point_count: number;
|
|
330
|
+
matched_count: number;
|
|
331
|
+
max_points: number;
|
|
332
|
+
message: string | null;
|
|
333
|
+
/** 批次只判斷「落在校地內」,不會找附近的學校 */
|
|
334
|
+
notice: string;
|
|
335
|
+
disclaimer: string;
|
|
336
|
+
attribution: string;
|
|
337
|
+
}
|
|
338
|
+
interface OdPopulationVillageResult {
|
|
339
|
+
center: OdCenter;
|
|
340
|
+
/** 所在村里;code 是 11 碼村里代碼(可帶去 `stats.villages`)。座標不在任何村里時為 null */
|
|
341
|
+
village: {
|
|
342
|
+
code: string;
|
|
343
|
+
name: string;
|
|
344
|
+
city: string | null;
|
|
345
|
+
district: string | null;
|
|
346
|
+
} | null;
|
|
347
|
+
/** 最新一期人口;該村里沒有人口資料時為 null */
|
|
348
|
+
population: {
|
|
349
|
+
/** 資料月份(YYYY-MM) */
|
|
350
|
+
year_month: string;
|
|
351
|
+
population: number | null;
|
|
352
|
+
households: number | null;
|
|
353
|
+
male: number | null;
|
|
354
|
+
female: number | null;
|
|
355
|
+
/** young=0~14 歲、working=15~64 歲、elder=65 歲以上(人數) */
|
|
356
|
+
age: {
|
|
357
|
+
young: number | null;
|
|
358
|
+
working: number | null;
|
|
359
|
+
elder: number | null;
|
|
360
|
+
};
|
|
361
|
+
/** 老年人口占比(%)=65 歲以上 ÷ 總人口;**不是老化指數** */
|
|
362
|
+
elder_pct: number | null;
|
|
363
|
+
/** 與前一期(上個月)相比的人口增減率(%);沒有前一期為 null */
|
|
364
|
+
growth_pct: number | null;
|
|
365
|
+
/** 當月戶籍動態(不是全年累計) */
|
|
366
|
+
dynamics: {
|
|
367
|
+
births: number | null;
|
|
368
|
+
deaths: number | null;
|
|
369
|
+
marriages: number | null;
|
|
370
|
+
divorces: number | null;
|
|
371
|
+
};
|
|
372
|
+
} | null;
|
|
373
|
+
message: string | null;
|
|
374
|
+
notice: string;
|
|
375
|
+
attribution: string;
|
|
376
|
+
}
|
|
377
|
+
type OdVillageStatsItem = 'population' | 'income' | 'density';
|
|
378
|
+
interface OdStatsVillagesQuery {
|
|
379
|
+
/** 村里代碼(11 碼純數字),一次最多 500 個;重複的會自動去除 */
|
|
380
|
+
codes: string[];
|
|
381
|
+
/** 要哪些項目:population(人口)、income(所得)、density(所屬鄉鎮市區人口密度與全國房貸數據);不帶就全給 */
|
|
382
|
+
items?: OdVillageStatsItem[];
|
|
383
|
+
}
|
|
384
|
+
interface OdStatsVillagesResult {
|
|
385
|
+
items: OdVillageStatsItem[];
|
|
386
|
+
requested_count: number;
|
|
387
|
+
max_codes: number;
|
|
388
|
+
/** 要求的項目全部查無資料的代碼 */
|
|
389
|
+
not_found: string[];
|
|
390
|
+
missing: {
|
|
391
|
+
population: string[];
|
|
392
|
+
income: string[];
|
|
393
|
+
density: string[];
|
|
394
|
+
};
|
|
395
|
+
/** 整批加總;所得單位千元/年(欄位名以 `_thousand_twd` 結尾);aging_index 是老化指數(老年 ÷ 幼年 × 100) */
|
|
396
|
+
summary: {
|
|
397
|
+
population: Record<string, unknown> | null;
|
|
398
|
+
income: Record<string, unknown> | null;
|
|
399
|
+
district_density: Array<Record<string, unknown>> | null;
|
|
400
|
+
};
|
|
401
|
+
/** 逐村里明細,順序同送入的代碼;查無的代碼 found 為 false */
|
|
402
|
+
villages: Array<{
|
|
403
|
+
code: string;
|
|
404
|
+
village: string | null;
|
|
405
|
+
district: string | null;
|
|
406
|
+
city: string | null;
|
|
407
|
+
district_code: string | null;
|
|
408
|
+
found: boolean;
|
|
409
|
+
population?: Record<string, unknown> | null;
|
|
410
|
+
income?: Record<string, unknown> | null;
|
|
411
|
+
district_density?: Record<string, unknown> | null;
|
|
412
|
+
}>;
|
|
413
|
+
/** 全國新承做購屋貸款利率與新增購屋貸款核貸成數(有要求 density 時才有) */
|
|
414
|
+
national_finance: {
|
|
415
|
+
mortgage_rate: Record<string, unknown> | null;
|
|
416
|
+
housing_loan: Record<string, unknown> | null;
|
|
417
|
+
} | null;
|
|
418
|
+
message: string | null;
|
|
419
|
+
notice: string;
|
|
420
|
+
sources: Array<{
|
|
421
|
+
agency: string | null;
|
|
422
|
+
name: string | null;
|
|
423
|
+
}>;
|
|
424
|
+
attribution: string;
|
|
425
|
+
}
|
|
426
|
+
type OdAreaSeriesItem = 'population' | 'income' | 'density' | 'mortgage';
|
|
427
|
+
/** 區域的給法二擇一:address 或 lat+lng(以所在村里為單位);city+district(以鄉鎮市區為單位) */
|
|
428
|
+
interface OdAreaSeriesQuery extends OdLocation {
|
|
429
|
+
/** 縣市名(中文,台/臺皆可),與 district 成對 */
|
|
430
|
+
city?: string;
|
|
431
|
+
/** 鄉鎮市區名,與 city 成對 */
|
|
432
|
+
district?: string;
|
|
433
|
+
/** 要哪些序列;不帶就全給。mortgage 是全國序列,不隨區域改變 */
|
|
434
|
+
items?: OdAreaSeriesItem[];
|
|
435
|
+
/** 人口序列最多幾期(月),1~60,預設 60;不影響利率 */
|
|
436
|
+
months?: number;
|
|
437
|
+
/** 所得與人口密度序列最多幾期(年),1~15,預設 15 */
|
|
438
|
+
years?: number;
|
|
439
|
+
}
|
|
440
|
+
/** 序列共通:points 由舊到新;truncated 為 true 表示實際期數(total_available)超過上限 */
|
|
441
|
+
interface OdSeries<P> {
|
|
442
|
+
points: P[];
|
|
443
|
+
truncated: boolean;
|
|
444
|
+
total_available?: number | null;
|
|
445
|
+
[key: string]: unknown;
|
|
446
|
+
}
|
|
447
|
+
interface OdAreaSeriesResult {
|
|
448
|
+
center?: OdCenter;
|
|
449
|
+
/** 統計單位(中文):村里/鄉鎮市區;定位不到為 null */
|
|
450
|
+
level: string | null;
|
|
451
|
+
level_code: 'village' | 'area' | null;
|
|
452
|
+
city: string | null;
|
|
453
|
+
district: string | null;
|
|
454
|
+
village: {
|
|
455
|
+
code: string;
|
|
456
|
+
name: string;
|
|
457
|
+
} | null;
|
|
458
|
+
/** 人口月序列(year_month 為西元 YYYY-MM);net_migration_estimated 是估算值 */
|
|
459
|
+
population: OdSeries<{
|
|
460
|
+
year_month: string;
|
|
461
|
+
population: number | null;
|
|
462
|
+
households: number | null;
|
|
463
|
+
elder_pct: number | null;
|
|
464
|
+
aging_index: number | null;
|
|
465
|
+
net_migration_estimated: number | null;
|
|
466
|
+
[key: string]: unknown;
|
|
467
|
+
}> | null;
|
|
468
|
+
/** 所得年序列:year 是**民國年字串**(例如「111」),單位千元/年;basis 說明口徑(鄉鎮市區層級是各村里中位數的中位數) */
|
|
469
|
+
income: OdSeries<{
|
|
470
|
+
year: string;
|
|
471
|
+
village_count: number | null;
|
|
472
|
+
household_count: number | null;
|
|
473
|
+
income_median_thousand_twd: number | null;
|
|
474
|
+
}> | null;
|
|
475
|
+
/** 鄉鎮市區人口密度年序列:year 是民國年字串,單位人/平方公里 */
|
|
476
|
+
density: OdSeries<{
|
|
477
|
+
year: string;
|
|
478
|
+
density_per_km2: number | null;
|
|
479
|
+
population: number | null;
|
|
480
|
+
}> | null;
|
|
481
|
+
/** 全國五大銀行新承做購屋貸款利率月序列(%) */
|
|
482
|
+
mortgage: OdSeries<{
|
|
483
|
+
year_month: string;
|
|
484
|
+
rate_pct: number | null;
|
|
485
|
+
}> | null;
|
|
486
|
+
message: string | null;
|
|
487
|
+
notice: string;
|
|
488
|
+
sources: Array<{
|
|
489
|
+
agency: string | null;
|
|
490
|
+
name: string | null;
|
|
491
|
+
}>;
|
|
492
|
+
attribution: string;
|
|
493
|
+
}
|
|
494
|
+
interface OdAddressSuggestQuery {
|
|
495
|
+
/** 已輸入的地址**開頭**(不是關鍵字;可不含縣市,例如「松山區長春路426」),最長 120 字;門牌號用阿拉伯數字 */
|
|
496
|
+
q: string;
|
|
497
|
+
/** 縣市名(中文,台/臺皆可);q 沒有寫縣市時用來限縮 */
|
|
498
|
+
city?: string;
|
|
499
|
+
/** 回傳筆數上限,1~20,預設 10 */
|
|
500
|
+
limit?: number;
|
|
501
|
+
}
|
|
502
|
+
interface OdAddressSuggestResult {
|
|
503
|
+
items: Array<{
|
|
504
|
+
address: string;
|
|
505
|
+
city: string | null;
|
|
506
|
+
district: string | null;
|
|
507
|
+
village: string | null;
|
|
508
|
+
lat: number | null;
|
|
509
|
+
lng: number | null;
|
|
510
|
+
}>;
|
|
511
|
+
count: number;
|
|
512
|
+
/** 門牌資料目前收錄的縣市;未收錄縣市查不到**不代表地址不存在** */
|
|
513
|
+
covered_cities: string[];
|
|
514
|
+
message: string | null;
|
|
515
|
+
notice: string;
|
|
516
|
+
attribution: string;
|
|
517
|
+
[key: string]: unknown;
|
|
518
|
+
}
|
|
519
|
+
interface OdAddressGeocodeQuery {
|
|
520
|
+
/** 地址原文,1~500 字(可含樓層,伺服器端會正規化) */
|
|
521
|
+
address: string;
|
|
522
|
+
}
|
|
523
|
+
/** found=有座標/no_result=明確查無/low_quality=只到行政區或縣市中心,不給座標 */
|
|
524
|
+
type OdGeocodeStatus = 'found' | 'no_result' | 'low_quality';
|
|
525
|
+
/** doorplate=門牌/interpolated=門牌內插/road=路段中心/area=行政區或縣市中心(只出現在 low_quality)/unknown=精度不明 */
|
|
526
|
+
type OdGeocodePrecision = 'doorplate' | 'interpolated' | 'road' | 'area' | 'unknown';
|
|
527
|
+
/** official_doorplate=官方門牌/external_map=外部圖資(平台付費)/legacy_cache=舊快取 */
|
|
528
|
+
type OdGeocodeSource = 'official_doorplate' | 'external_map' | 'legacy_cache';
|
|
529
|
+
interface OdAddressGeocodeResult {
|
|
530
|
+
query: {
|
|
531
|
+
address: string;
|
|
532
|
+
};
|
|
533
|
+
/** 有座標時為 true */
|
|
534
|
+
found: boolean;
|
|
535
|
+
/** 狀態(中文) */
|
|
536
|
+
status: string;
|
|
537
|
+
status_code: OdGeocodeStatus;
|
|
538
|
+
lat: number | null;
|
|
539
|
+
lng: number | null;
|
|
540
|
+
/** 精度(中文);no_result 時為 null */
|
|
541
|
+
precision: string | null;
|
|
542
|
+
/** doorplate 以外只適合顯示,不適合當成精確位置 */
|
|
543
|
+
precision_code: OdGeocodePrecision | null;
|
|
544
|
+
/** 座標來源(中文);沒有座標時為 null */
|
|
545
|
+
source: string | null;
|
|
546
|
+
source_code: OdGeocodeSource | null;
|
|
547
|
+
/** 精確門牌(可當成精確位置)時為 true */
|
|
548
|
+
is_exact_doorplate: boolean;
|
|
549
|
+
/** 整理後的門牌;不是可辨識的單一門牌時為 null */
|
|
550
|
+
canonical_address: string | null;
|
|
551
|
+
/** 地址沒寫行政區、由官方門牌推得(目前只有新竹市) */
|
|
552
|
+
district_inferred: boolean;
|
|
553
|
+
message: string | null;
|
|
554
|
+
notice: string;
|
|
555
|
+
attribution: string;
|
|
556
|
+
[key: string]: unknown;
|
|
557
|
+
}
|
|
558
|
+
/** 成交型態:sale=買賣(預設)/rent=租賃/presale=預售屋 */
|
|
559
|
+
type OdLvrTransactionType = 'sale' | 'rent' | 'presale';
|
|
560
|
+
/** 交易標的:house=房地(預設)/building=建物(沒有土地持分)/land=土地/parking=車位。不同標的的單價不可互相比較 */
|
|
561
|
+
type OdLvrTarget = 'house' | 'building' | 'land' | 'parking';
|
|
562
|
+
/** 實登整理版回應的共同欄位 */
|
|
563
|
+
interface OdLvrBase {
|
|
564
|
+
/** 單價口徑:adjusted=車位拆算後/rent_over_building_area=月租金 ÷ 建物面積(沒有車位拆算)/none=沒有單價 */
|
|
565
|
+
unit_price_basis: 'adjusted' | 'rent_over_building_area' | 'none';
|
|
566
|
+
/** 口徑與限制的說明;轉述數字時請一併帶出 */
|
|
567
|
+
notice: string;
|
|
568
|
+
/** 查無時的說明 */
|
|
569
|
+
message: string | null;
|
|
570
|
+
attribution: string;
|
|
571
|
+
}
|
|
572
|
+
/**
|
|
573
|
+
* 逐筆的金額欄位。買賣與預售給 `total_price_wan`/`unit_price_wan_per_ping`;
|
|
574
|
+
* 租賃給 `monthly_rent_twd`/`rent_per_ping_month_twd`(月租金,不是房價),兩組不會同時出現。
|
|
575
|
+
*/
|
|
576
|
+
interface OdLvrDealMoney {
|
|
577
|
+
/** 總價(萬元);買賣與預售才有 */
|
|
578
|
+
total_price_wan?: number | null;
|
|
579
|
+
/** 單價(萬元/坪):車位拆算後;無法拆算時是政府原始值(見 unit_price_note) */
|
|
580
|
+
unit_price_wan_per_ping?: number | null;
|
|
581
|
+
/** 政府原始單價(萬元/坪)=總價 ÷ 含車位的建物面積 */
|
|
582
|
+
unit_price_raw_wan_per_ping?: number | null;
|
|
583
|
+
/** 月租金(元);租賃才有 */
|
|
584
|
+
monthly_rent_twd?: number | null;
|
|
585
|
+
/** 每坪月租(元/坪/月):車位拆算後 */
|
|
586
|
+
rent_per_ping_month_twd?: number | null;
|
|
587
|
+
/** 政府原始的每坪月租(元/坪/月) */
|
|
588
|
+
rent_per_ping_month_raw_twd?: number | null;
|
|
589
|
+
/** 「車位價推估」=車位價以同區同年行情推估扣除/「含車位未拆算」=無法拆算,主值是政府原始值/null=不需要註記 */
|
|
590
|
+
unit_price_note: '車位價推估' | '含車位未拆算' | null;
|
|
591
|
+
}
|
|
592
|
+
interface OdLvrDeal extends OdLvrDealMoney {
|
|
593
|
+
id: string;
|
|
594
|
+
/** 成交型態(中文):買賣/租賃/預售 */
|
|
595
|
+
transaction_type: string | null;
|
|
596
|
+
transaction_type_code: OdLvrTransactionType | (string & {}) | null;
|
|
597
|
+
/** 成交日(YYYY-MM-DD) */
|
|
598
|
+
transaction_date: string | null;
|
|
599
|
+
city: string | null;
|
|
600
|
+
district: string | null;
|
|
601
|
+
address: string | null;
|
|
602
|
+
/** 交易標的(政府登錄原文,例如「房地(土地+建物)+車位」) */
|
|
603
|
+
transaction_target: string | null;
|
|
604
|
+
/** 交易筆棟數(原文,例如「土地1建物1車位1」) */
|
|
605
|
+
transaction_count: string | null;
|
|
606
|
+
/** 建物型態(原文全名,例如「住宅大樓(11層含以上有電梯)」) */
|
|
607
|
+
building_type: string | null;
|
|
608
|
+
main_use: string | null;
|
|
609
|
+
main_material: string | null;
|
|
610
|
+
/** 建物移轉總面積(坪,含車位面積) */
|
|
611
|
+
building_area_ping: number | null;
|
|
612
|
+
main_building_area_ping: number | null;
|
|
613
|
+
auxiliary_area_ping: number | null;
|
|
614
|
+
balcony_area_ping: number | null;
|
|
615
|
+
land_area_ping: number | null;
|
|
616
|
+
room_count: number | null;
|
|
617
|
+
hall_count: number | null;
|
|
618
|
+
bath_count: number | null;
|
|
619
|
+
/** 有無隔間(原文) */
|
|
620
|
+
compartment: string | null;
|
|
621
|
+
/** 移轉層次(原文,例如「五層」) */
|
|
622
|
+
transfer_floor: string | null;
|
|
623
|
+
total_floors: string | null;
|
|
624
|
+
/** 屋齡(年):取建物明細的最大值。與 construction_date 來源不同,數字可能對不上 */
|
|
625
|
+
building_age: number | null;
|
|
626
|
+
/** 建築完成年月(民國年月日字串,例如「0870420」) */
|
|
627
|
+
construction_date: string | null;
|
|
628
|
+
/** 建築完成年月的中文寫法(例如「民國 87 年 4 月」) */
|
|
629
|
+
construction_date_text: string | null;
|
|
630
|
+
/** 有無電梯(原文「有」「無」;沒有登錄為 null) */
|
|
631
|
+
has_elevator: string | null;
|
|
632
|
+
has_management: string | null;
|
|
633
|
+
urban_land_use: string | null;
|
|
634
|
+
non_urban_land_use: string | null;
|
|
635
|
+
non_urban_land_code: string | null;
|
|
636
|
+
/** 備註(原文) */
|
|
637
|
+
note: string | null;
|
|
638
|
+
parking: {
|
|
639
|
+
type: string | null;
|
|
640
|
+
area_ping: number | null;
|
|
641
|
+
/** 政府登錄的車位總價(萬元);0 或 null 表示沒有拆出車位價 */
|
|
642
|
+
price_wan: number | null;
|
|
643
|
+
/** 計算拆算單價時實際扣除的車位價(萬元);未拆價的是推估值 */
|
|
644
|
+
price_used_wan: number | null;
|
|
645
|
+
/** 有車位但政府資料沒有拆出車位價 */
|
|
646
|
+
is_bundled: boolean;
|
|
647
|
+
/** 拆算單價用的是推估的車位價 */
|
|
648
|
+
is_estimated: boolean;
|
|
649
|
+
/** 推估基準的層級:同行政區/同縣市/全國;不是推估為 null */
|
|
650
|
+
estimate_level: string | null;
|
|
651
|
+
};
|
|
652
|
+
/** 預售屋才有:建案名稱、棟及號、解約情形 */
|
|
653
|
+
project_name: string | null;
|
|
654
|
+
building_number: string | null;
|
|
655
|
+
termination_status: string | null;
|
|
656
|
+
/** 租賃才有的登錄內容(原文) */
|
|
657
|
+
rental: {
|
|
658
|
+
rental_type: string | null;
|
|
659
|
+
rental_period: string | null;
|
|
660
|
+
has_furniture: string | null;
|
|
661
|
+
has_manager: string | null;
|
|
662
|
+
equipment: string | null;
|
|
663
|
+
rental_service: string | null;
|
|
664
|
+
};
|
|
665
|
+
buildings: Array<{
|
|
666
|
+
building_age: number | null;
|
|
667
|
+
area_ping: number | null;
|
|
668
|
+
main_use: string | null;
|
|
669
|
+
main_material: string | null;
|
|
670
|
+
construction_date: string | null;
|
|
671
|
+
total_floors: string | null;
|
|
672
|
+
floor_level: string | null;
|
|
673
|
+
transfer_status: string | null;
|
|
674
|
+
}>;
|
|
675
|
+
lands: Array<{
|
|
676
|
+
location: string | null;
|
|
677
|
+
land_number: string | null;
|
|
678
|
+
area_ping: number | null;
|
|
679
|
+
use_zone: string | null;
|
|
680
|
+
share_numerator: number | null;
|
|
681
|
+
share_denominator: number | null;
|
|
682
|
+
transfer_status: string | null;
|
|
683
|
+
}>;
|
|
684
|
+
parkings: Array<{
|
|
685
|
+
type: string | null;
|
|
686
|
+
price_wan: number | null;
|
|
687
|
+
area_ping: number | null;
|
|
688
|
+
floor: string | null;
|
|
689
|
+
}>;
|
|
690
|
+
}
|
|
691
|
+
interface OdLvrDealResult extends OdLvrBase {
|
|
692
|
+
/** 查無此 id 為 null */
|
|
693
|
+
item: OdLvrDeal | null;
|
|
694
|
+
}
|
|
695
|
+
interface OdLvrSimilarQuery {
|
|
696
|
+
/** 縣市名(中文,台/臺皆可) */
|
|
697
|
+
city: string;
|
|
698
|
+
/** 鄉鎮市區名,例如「大安區」 */
|
|
699
|
+
district: string;
|
|
700
|
+
/** 建物型態關鍵字(部分相符),例如「住宅大樓」;逗號分隔可複選 */
|
|
701
|
+
building_type?: string;
|
|
702
|
+
/** 交易標的,預設 house */
|
|
703
|
+
transaction_target?: OdLvrTarget[];
|
|
704
|
+
/** 回溯月數,1~120,預設 6 */
|
|
705
|
+
months?: number;
|
|
706
|
+
/** 回傳筆數上限,1~100,預設 5 */
|
|
707
|
+
limit?: number;
|
|
708
|
+
}
|
|
709
|
+
interface OdLvrSimilarItem extends OdLvrDealMoney {
|
|
710
|
+
/** 成交 id;帶去 `lvr.deal(id)` 查完整內容 */
|
|
711
|
+
id: string;
|
|
712
|
+
transaction_date: string | null;
|
|
713
|
+
address: string | null;
|
|
714
|
+
/** 建物移轉總面積(坪,含車位面積) */
|
|
715
|
+
building_area_ping: number | null;
|
|
716
|
+
}
|
|
717
|
+
interface OdLvrSimilarResult extends OdLvrBase {
|
|
718
|
+
query: Record<string, unknown>;
|
|
719
|
+
/** 只含買賣、成交日新到舊;count 是這次回傳的筆數,不是符合條件的總筆數 */
|
|
720
|
+
items: OdLvrSimilarItem[];
|
|
721
|
+
count: number;
|
|
722
|
+
}
|
|
723
|
+
interface OdLvrSummaryQuery {
|
|
724
|
+
/** 縣市名(中文,台/臺皆可);不帶就是全國。有帶 district 或 keyword 時必填 */
|
|
725
|
+
city?: string;
|
|
726
|
+
district?: string;
|
|
727
|
+
/** 社區名或路名關鍵字(比對地址與建案名);沒有同時帶 district 時期間最長 24 個月(超過會自動縮短,見回應的 period.clamped) */
|
|
728
|
+
keyword?: string;
|
|
729
|
+
/** 預設 sale */
|
|
730
|
+
transaction_type?: OdLvrTransactionType;
|
|
731
|
+
/** 預設 house */
|
|
732
|
+
transaction_target?: OdLvrTarget[];
|
|
733
|
+
/** 建物型態關鍵字(部分相符);逗號分隔可複選 */
|
|
734
|
+
building_type?: string;
|
|
735
|
+
/** 成交日下界 YYYY-MM-DD;沒帶就是上界往前 12 個月 */
|
|
736
|
+
date_start?: string;
|
|
737
|
+
/** 成交日上界 YYYY-MM-DD;沒帶就是今天 */
|
|
738
|
+
date_end?: string;
|
|
739
|
+
/** 總價下限(**萬元**;租賃時是月租金下限,同樣以萬元計) */
|
|
740
|
+
total_price_min_wan?: number;
|
|
741
|
+
total_price_max_wan?: number;
|
|
742
|
+
/** 單價下限(萬元/坪,比對車位拆算後單價) */
|
|
743
|
+
unit_price_min?: number;
|
|
744
|
+
unit_price_max?: number;
|
|
745
|
+
/** 建物面積下限(坪) */
|
|
746
|
+
area_min?: number;
|
|
747
|
+
area_max?: number;
|
|
748
|
+
/** 土地面積下限(坪) */
|
|
749
|
+
land_area_min?: number;
|
|
750
|
+
land_area_max?: number;
|
|
751
|
+
room_count_min?: number;
|
|
752
|
+
room_count_max?: number;
|
|
753
|
+
hall_count_min?: number;
|
|
754
|
+
hall_count_max?: number;
|
|
755
|
+
bath_count_min?: number;
|
|
756
|
+
bath_count_max?: number;
|
|
757
|
+
/** 有無電梯(沒有登錄的成交 true/false 都不會命中) */
|
|
758
|
+
has_elevator?: boolean;
|
|
759
|
+
has_management?: boolean;
|
|
760
|
+
/** 主要用途關鍵字(部分相符) */
|
|
761
|
+
main_use?: string;
|
|
762
|
+
/** 都市土地使用分區關鍵字(部分相符) */
|
|
763
|
+
urban_land_use?: string;
|
|
764
|
+
}
|
|
765
|
+
interface OdLvrSummaryResult extends OdLvrBase {
|
|
766
|
+
query: Record<string, unknown>;
|
|
767
|
+
/** 實際採用的期間;defaulted=起訖日期由平台補上、clamped=因關鍵字沒有搭配行政區而縮短 */
|
|
768
|
+
period: {
|
|
769
|
+
date_start: string;
|
|
770
|
+
date_end: string;
|
|
771
|
+
defaulted: boolean;
|
|
772
|
+
clamped: boolean;
|
|
773
|
+
};
|
|
774
|
+
/** 符合條件的完整筆數(全樣本;不受 lvr.deals 的 1000 筆上限影響) */
|
|
775
|
+
count: number;
|
|
776
|
+
/** 實際有資料的月份範圍(YYYY-MM) */
|
|
777
|
+
data_month_start: string | null;
|
|
778
|
+
data_month_end: string | null;
|
|
779
|
+
/** 平均值(不是中位數)。買賣與預售給 `*_wan`/`*_wan_per_ping`,租賃給 `*_rent_*`;查無為 null */
|
|
780
|
+
stats: {
|
|
781
|
+
avg_total_price_wan?: number | null;
|
|
782
|
+
avg_unit_price_wan_per_ping?: number | null;
|
|
783
|
+
min_total_price_wan?: number | null;
|
|
784
|
+
max_total_price_wan?: number | null;
|
|
785
|
+
avg_monthly_rent_twd?: number | null;
|
|
786
|
+
avg_rent_per_ping_month_twd?: number | null;
|
|
787
|
+
min_monthly_rent_twd?: number | null;
|
|
788
|
+
max_monthly_rent_twd?: number | null;
|
|
789
|
+
avg_building_area_ping: number | null;
|
|
790
|
+
} | null;
|
|
791
|
+
/** 單價由車位價推估扣除的筆數 */
|
|
792
|
+
parking_estimated_count: number;
|
|
793
|
+
/** 有車位但無法拆算、不計入平均單價的筆數 */
|
|
794
|
+
parking_unpriced_count: number;
|
|
795
|
+
}
|
|
796
|
+
interface OdLvrStatsByAreaQuery {
|
|
797
|
+
/** 縣市名(中文,台/臺皆可);不帶就是全國每個行政區 */
|
|
798
|
+
city?: string;
|
|
799
|
+
transaction_type?: OdLvrTransactionType;
|
|
800
|
+
transaction_target?: OdLvrTarget[];
|
|
801
|
+
/** 建物型態:**要與政府登錄的全名完全相同**(例如「住宅大樓(11層含以上有電梯)」);帶了就不提供漲跌幅 */
|
|
802
|
+
building_type?: string;
|
|
803
|
+
/** 沒帶就是上界往前 12 個月 */
|
|
804
|
+
date_start?: string;
|
|
805
|
+
date_end?: string;
|
|
806
|
+
}
|
|
807
|
+
interface OdLvrStatsByAreaResult extends OdLvrBase {
|
|
808
|
+
query: Record<string, unknown>;
|
|
809
|
+
period: {
|
|
810
|
+
date_start: string;
|
|
811
|
+
date_end: string;
|
|
812
|
+
defaulted: boolean;
|
|
813
|
+
};
|
|
814
|
+
/** 平均單價高到低。transaction_count 只算有拆算單價的成交 */
|
|
815
|
+
items: Array<{
|
|
816
|
+
city: string | null;
|
|
817
|
+
district: string | null;
|
|
818
|
+
/** 平均單價(萬元/坪,車位拆算後);買賣與預售才有 */
|
|
819
|
+
avg_unit_price_wan_per_ping?: number | null;
|
|
820
|
+
/** 平均每坪月租(元/坪/月);租賃才有 */
|
|
821
|
+
avg_rent_per_ping_month_twd?: number | null;
|
|
822
|
+
transaction_count: number | null;
|
|
823
|
+
avg_building_area_ping: number | null;
|
|
824
|
+
/** 與前一個等長期間相比的漲跌幅(%);前期沒有成交、或有帶 building_type 時為 null */
|
|
825
|
+
price_change_pct: number | null;
|
|
826
|
+
parking_estimated_count: number;
|
|
827
|
+
}>;
|
|
828
|
+
count: number;
|
|
829
|
+
/** false=這次不提供漲跌幅(有帶 building_type) */
|
|
830
|
+
price_change_available: boolean;
|
|
831
|
+
}
|
|
832
|
+
interface OdLvrMonthlyTrendQuery {
|
|
833
|
+
city: string;
|
|
834
|
+
/** 不帶就是整個縣市 */
|
|
835
|
+
district?: string;
|
|
836
|
+
transaction_type?: OdLvrTransactionType;
|
|
837
|
+
transaction_target?: OdLvrTarget[];
|
|
838
|
+
/** 建物型態關鍵字(部分相符);逗號分隔可複選 */
|
|
839
|
+
building_type?: string;
|
|
840
|
+
/** 回溯月數,1~120,預設 12 */
|
|
841
|
+
months?: number;
|
|
842
|
+
/** 件數低於這個數字的月份標 is_partial(1~1000);不帶就自動採各月件數中位數的 30% */
|
|
843
|
+
min_sample?: number;
|
|
844
|
+
}
|
|
845
|
+
interface OdLvrMonthlyTrendResult extends OdLvrBase {
|
|
846
|
+
query: Record<string, unknown>;
|
|
847
|
+
/** 由舊到新;沒有成交的月份不會出現 */
|
|
848
|
+
items: Array<{
|
|
849
|
+
/** YYYY-MM */
|
|
850
|
+
month: string | null;
|
|
851
|
+
/** 平均單價(萬元/坪,車位拆算後;平均值不是中位數);買賣與預售才有 */
|
|
852
|
+
avg_unit_price_wan_per_ping?: number | null;
|
|
853
|
+
/** 平均每坪月租(元/坪/月);租賃才有 */
|
|
854
|
+
avg_rent_per_ping_month_twd?: number | null;
|
|
855
|
+
transaction_count: number | null;
|
|
856
|
+
/** true=件數明顯偏少(多半是資料還沒揭露完),畫圖時請弱化或註記 */
|
|
857
|
+
is_partial: boolean;
|
|
858
|
+
parking_estimated_count: number;
|
|
859
|
+
}>;
|
|
860
|
+
count: number;
|
|
861
|
+
}
|
|
862
|
+
interface OdLvrRentalStatsQuery {
|
|
863
|
+
city: string;
|
|
864
|
+
district: string;
|
|
865
|
+
/** 建物型態:要與政府登錄的全名完全相同 */
|
|
866
|
+
building_type?: string;
|
|
867
|
+
transaction_target?: OdLvrTarget[];
|
|
868
|
+
/** 回溯月數,1~120,預設 12 */
|
|
869
|
+
months?: number;
|
|
870
|
+
}
|
|
871
|
+
interface OdLvrRentalStatsResult extends OdLvrBase {
|
|
872
|
+
query: Record<string, unknown>;
|
|
873
|
+
sample_count: number;
|
|
874
|
+
/** 平均月租金(元);查無為 null */
|
|
875
|
+
avg_monthly_rent_twd: number | null;
|
|
876
|
+
/** 平均每坪月租(元/坪/月)=月租金 ÷ 建物面積,**沒有車位拆算**;查無為 null */
|
|
877
|
+
avg_rent_per_ping_month_twd: number | null;
|
|
878
|
+
}
|
|
879
|
+
interface OdLvrMonthlyByRegionQuery {
|
|
880
|
+
/** 期間起日 YYYY-MM-DD;以月為單位,所在的月份整月計入 */
|
|
881
|
+
date_start: string;
|
|
882
|
+
/** 期間迄日 YYYY-MM-DD;晚於今天時以今天為準 */
|
|
883
|
+
date_end: string;
|
|
884
|
+
transaction_type?: OdLvrTransactionType;
|
|
885
|
+
/** 不帶就是全國(期間最長 24 個月);帶了最長 120 個月 */
|
|
886
|
+
city?: string;
|
|
887
|
+
/** 要搭配 city */
|
|
888
|
+
district?: string;
|
|
889
|
+
}
|
|
890
|
+
interface OdLvrMonthlyByRegionResult extends OdLvrBase {
|
|
891
|
+
query: Record<string, unknown>;
|
|
892
|
+
/** 實際計入的月份範圍(YYYY-MM) */
|
|
893
|
+
period: {
|
|
894
|
+
month_start: string;
|
|
895
|
+
month_end: string;
|
|
896
|
+
};
|
|
897
|
+
/** 每列是一個行政區的一個月;**不分交易標的**(土地、車位也算) */
|
|
898
|
+
items: Array<{
|
|
899
|
+
city: string | null;
|
|
900
|
+
/** 來源沒有填行政區的成交為 null */
|
|
901
|
+
district: string | null;
|
|
902
|
+
month: string | null;
|
|
903
|
+
transaction_count: number;
|
|
904
|
+
/** 成交總價合計(萬元);買賣與預售才有 */
|
|
905
|
+
total_amount_wan?: number | null;
|
|
906
|
+
/** 月租金合計(元);租賃才有 */
|
|
907
|
+
total_monthly_rent_twd?: number | null;
|
|
908
|
+
}>;
|
|
909
|
+
count: number;
|
|
910
|
+
/** 彙總的計算時間(沒有時區標記);之後才入庫的成交不在內 */
|
|
911
|
+
computed_at: string | null;
|
|
912
|
+
}
|
|
913
|
+
/** 期別:daily 日報(預設)/weekly 週報/monthly 月報 */
|
|
914
|
+
type OdPeriodType = 'daily' | 'weekly' | 'monthly';
|
|
915
|
+
/**
|
|
916
|
+
* 授權政策(實際套用的):open=政府資料,全部欄位;summary=媒體,只有標題與來源摘要;
|
|
917
|
+
* title_only=部分媒體與公會,只有標題、機關、日期、連結。來源回報的值認不得時一律以 title_only 處理。
|
|
918
|
+
*/
|
|
919
|
+
type OdUsagePolicy = 'open' | 'summary' | 'title_only';
|
|
920
|
+
/** 依授權裁切後的公告或報導。`content_withheld` 為 true 表示有內容因授權沒有提供,請引導使用者點 `url` 看原文 */
|
|
921
|
+
interface OdBulletin {
|
|
922
|
+
id: number | null;
|
|
923
|
+
title: string | null;
|
|
924
|
+
agency: string | null;
|
|
925
|
+
published_at: string | null;
|
|
926
|
+
url: string | null;
|
|
927
|
+
/** 授權的中文說明(為什麼沒有內文) */
|
|
928
|
+
usage_policy: string;
|
|
929
|
+
usage_policy_code: OdUsagePolicy;
|
|
930
|
+
content_withheld: boolean;
|
|
931
|
+
/** 類型(中文):政府新聞稿/政府公告/政府公報/法規異動/媒體報導/研究報告 */
|
|
932
|
+
kind: string | null;
|
|
933
|
+
kind_code: string | null;
|
|
934
|
+
level?: string | null;
|
|
935
|
+
level_code?: 'central' | 'local' | (string & {}) | null;
|
|
936
|
+
/** 發布機關所在縣市(地方公告) */
|
|
937
|
+
city?: string | null;
|
|
938
|
+
/** 中央條目內文提及的縣市:只代表提及,不代表適用 */
|
|
939
|
+
mentioned_cities?: string[];
|
|
940
|
+
categories?: string[];
|
|
941
|
+
category_codes?: string[];
|
|
942
|
+
/** 平台的相關度分數(0~100) */
|
|
943
|
+
relevance?: number | null;
|
|
944
|
+
/** 期別摘要的條目才有:地方機關公告/只提及單一縣市的媒體報導/全國 */
|
|
945
|
+
region_scope?: string | null;
|
|
946
|
+
region_scope_code?: 'local' | 'regional' | 'national' | (string & {}) | null;
|
|
947
|
+
/** 期別摘要的條目才有:發布日早於本期(晚到) */
|
|
948
|
+
late?: boolean;
|
|
949
|
+
is_backfill?: boolean;
|
|
950
|
+
first_seen_at?: string | null;
|
|
951
|
+
/** 期別摘要的條目才有:同一事件被合併的其他條目 id */
|
|
952
|
+
related_ids?: number[];
|
|
953
|
+
/** 來源摘要;title_only 為 null */
|
|
954
|
+
summary: string | null;
|
|
955
|
+
keywords: string[];
|
|
956
|
+
/** 期別摘要的條目才有:內文節錄(≤ 1,500 字,只有 open) */
|
|
957
|
+
body_excerpt?: string | null;
|
|
958
|
+
/** 有沒有內文(只有 open 可能為 true) */
|
|
959
|
+
has_body?: boolean;
|
|
960
|
+
/** 可讀附件份數(非 open 恆為 0) */
|
|
961
|
+
document_count?: number;
|
|
962
|
+
}
|
|
963
|
+
interface OdBulletinDetail extends OdBulletin {
|
|
964
|
+
/** 內文(≤ 6,000 字);非 open 為 null */
|
|
965
|
+
body: string | null;
|
|
966
|
+
body_fetched_at: string | null;
|
|
967
|
+
attachments: Array<{
|
|
968
|
+
name: string | null;
|
|
969
|
+
url: string | null;
|
|
970
|
+
ext: string | null;
|
|
971
|
+
}>;
|
|
972
|
+
}
|
|
973
|
+
interface OdBulletinsListQuery {
|
|
974
|
+
/** 發布層級:central=中央/local=地方 */
|
|
975
|
+
level?: 'central' | 'local';
|
|
976
|
+
/** 發布機關所在縣市(中文,台/臺皆可) */
|
|
977
|
+
city?: string;
|
|
978
|
+
/** 中央條目提及的縣市(中文);只代表提及,不代表適用 */
|
|
979
|
+
mentions?: string;
|
|
980
|
+
kind?: 'gov_press' | 'gov_bulletin' | 'gov_gazette' | 'law_change' | 'media' | 'research';
|
|
981
|
+
category?: 'credit' | 'tax' | 'market' | 'urban_plan' | 'urban_renewal' | 'housing_supply' | 'rent' | 'land' | 'transport' | 'law' | 'other';
|
|
982
|
+
/** 日期下界 YYYY-MM-DD(台灣日,含當天) */
|
|
983
|
+
from?: string;
|
|
984
|
+
to?: string;
|
|
985
|
+
/** 標題關鍵字(最長 100 字) */
|
|
986
|
+
q?: string;
|
|
987
|
+
/** 是否包含回填的舊條目(預設否) */
|
|
988
|
+
include_backfill?: boolean;
|
|
989
|
+
/** 1~200,預設 50 */
|
|
990
|
+
limit?: number;
|
|
991
|
+
/** 0~10000,預設 0;翻頁每頁各扣一次 */
|
|
992
|
+
offset?: number;
|
|
993
|
+
}
|
|
994
|
+
/** 公告類回應的共同欄位 */
|
|
995
|
+
interface OdNoticeBase {
|
|
996
|
+
message: string | null;
|
|
997
|
+
notice: string;
|
|
998
|
+
attribution: string;
|
|
999
|
+
/** 上游要求揭露的免責文字,請一併顯示 */
|
|
1000
|
+
disclaimer: string | null;
|
|
1001
|
+
}
|
|
1002
|
+
interface OdBulletinsListResult extends OdNoticeBase {
|
|
1003
|
+
items: OdBulletin[];
|
|
1004
|
+
/** 符合條件的總筆數 */
|
|
1005
|
+
total: number;
|
|
1006
|
+
limit: number;
|
|
1007
|
+
offset: number;
|
|
1008
|
+
/** 授權裁切的說明 */
|
|
1009
|
+
usage_policy_notice: string;
|
|
1010
|
+
}
|
|
1011
|
+
interface OdBulletinDetailResult extends OdNoticeBase {
|
|
1012
|
+
/** 查無此 id 為 null */
|
|
1013
|
+
item: OdBulletinDetail | null;
|
|
1014
|
+
usage_policy_notice: string;
|
|
1015
|
+
}
|
|
1016
|
+
interface OdBulletinDocumentsQuery {
|
|
1017
|
+
/** 只取這個時間(含)以前讀到的附件版本(ISO 8601);不帶=現在 */
|
|
1018
|
+
as_of?: string;
|
|
1019
|
+
}
|
|
1020
|
+
interface OdBulletinDocumentsResult {
|
|
1021
|
+
/** 查無此 id 為 null */
|
|
1022
|
+
bulletin_id: number | null;
|
|
1023
|
+
usage_policy: string | null;
|
|
1024
|
+
usage_policy_code: OdUsagePolicy | null;
|
|
1025
|
+
/** true=媒體報導(或授權無法確認),依授權不提供附件 */
|
|
1026
|
+
content_withheld: boolean;
|
|
1027
|
+
as_of: string | null;
|
|
1028
|
+
/** 可讀的附件;method_code 為 ocr/mixed 的頁面是 AI 看圖辨識,可能看錯 */
|
|
1029
|
+
documents: Array<{
|
|
1030
|
+
id: number | null;
|
|
1031
|
+
name: string | null;
|
|
1032
|
+
url: string | null;
|
|
1033
|
+
status: string | null;
|
|
1034
|
+
status_code: 'ready' | 'partial' | (string & {}) | null;
|
|
1035
|
+
method: string | null;
|
|
1036
|
+
method_code: 'pdf' | 'ocr' | 'mixed' | (string & {}) | null;
|
|
1037
|
+
pages: Array<{
|
|
1038
|
+
page: number | null;
|
|
1039
|
+
text: string;
|
|
1040
|
+
method: string | null;
|
|
1041
|
+
method_code: string | null;
|
|
1042
|
+
}>;
|
|
1043
|
+
page_count: number | null;
|
|
1044
|
+
truncated: boolean;
|
|
1045
|
+
fetched_at: string | null;
|
|
1046
|
+
}>;
|
|
1047
|
+
/** 有附件但讀不到(不要當成沒有附件) */
|
|
1048
|
+
failures: Array<{
|
|
1049
|
+
name: string | null;
|
|
1050
|
+
url: string | null;
|
|
1051
|
+
status: string | null;
|
|
1052
|
+
status_code: string | null;
|
|
1053
|
+
error: string | null;
|
|
1054
|
+
error_code: string | null;
|
|
1055
|
+
fetched_at: string | null;
|
|
1056
|
+
}>;
|
|
1057
|
+
message: string | null;
|
|
1058
|
+
notice: string;
|
|
1059
|
+
attribution: string;
|
|
1060
|
+
}
|
|
1061
|
+
/** 期別視角:不給 city=全國 */
|
|
1062
|
+
interface OdPeriodViewQuery {
|
|
1063
|
+
period_type?: OdPeriodType;
|
|
1064
|
+
/** 縣市名(中文,台/臺皆可)看該縣市視角;不給=全國 */
|
|
1065
|
+
city?: string;
|
|
1066
|
+
}
|
|
1067
|
+
interface OdPeriodGetQuery extends OdPeriodViewQuery {
|
|
1068
|
+
/** 期別鍵:日 2026-09-28/週 2026-W39(ISO 週)/月 2026-09,須與 period_type 相符 */
|
|
1069
|
+
period_key: string;
|
|
1070
|
+
/** 版本;不帶=最新版 */
|
|
1071
|
+
version?: number;
|
|
1072
|
+
}
|
|
1073
|
+
interface OdPeriodListQuery extends OdPeriodViewQuery {
|
|
1074
|
+
/** 最多幾期,1~120,預設 30 */
|
|
1075
|
+
limit?: number;
|
|
1076
|
+
}
|
|
1077
|
+
/** 指標比較:只有 reason_code 為 comparable 時可寫成漲跌;level_only 只看百分點差 */
|
|
1078
|
+
interface OdIndicatorComparison {
|
|
1079
|
+
period: string | null;
|
|
1080
|
+
value: number | null;
|
|
1081
|
+
delta_pct: number | null;
|
|
1082
|
+
delta_pp: number | null;
|
|
1083
|
+
reason: string | null;
|
|
1084
|
+
reason_code: 'comparable' | 'level_only' | 'definition_changed' | 'period_mismatch' | 'missing_value' | 'invalid_baseline' | 'insufficient_samples' | 'provisional' | (string & {}) | null;
|
|
1085
|
+
}
|
|
1086
|
+
interface OdBriefIndicator {
|
|
1087
|
+
indicator: string | null;
|
|
1088
|
+
indicator_code: string | null;
|
|
1089
|
+
unit: string | null;
|
|
1090
|
+
/** 縣市名或「全國」 */
|
|
1091
|
+
city: string | null;
|
|
1092
|
+
period: string | null;
|
|
1093
|
+
value: number | null;
|
|
1094
|
+
prev: OdIndicatorComparison | null;
|
|
1095
|
+
yoy: OdIndicatorComparison | null;
|
|
1096
|
+
revised: boolean;
|
|
1097
|
+
prev_value: number | null;
|
|
1098
|
+
extra: Record<string, unknown>;
|
|
1099
|
+
source: {
|
|
1100
|
+
agency: string | null;
|
|
1101
|
+
url: string | null;
|
|
1102
|
+
revised_at: string | null;
|
|
1103
|
+
};
|
|
1104
|
+
}
|
|
1105
|
+
interface OdBriefResult extends OdNoticeBase {
|
|
1106
|
+
/** false=這一期還沒產出或不存在(照常扣點),其餘內容欄位不會出現 */
|
|
1107
|
+
available: boolean;
|
|
1108
|
+
id?: number | null;
|
|
1109
|
+
period_type: OdPeriodType | null;
|
|
1110
|
+
period_label: string | null;
|
|
1111
|
+
period_key: string | null;
|
|
1112
|
+
/** 縣市視角的縣市名;全國為 null */
|
|
1113
|
+
city: string | null;
|
|
1114
|
+
view: '全國' | '縣市';
|
|
1115
|
+
version?: number | null;
|
|
1116
|
+
status?: string | null;
|
|
1117
|
+
status_code?: 'complete' | 'partial' | 'unavailable' | (string & {}) | null;
|
|
1118
|
+
window_start?: string | null;
|
|
1119
|
+
window_end?: string | null;
|
|
1120
|
+
built_at?: string | null;
|
|
1121
|
+
bulletin_count?: number;
|
|
1122
|
+
indicator_count?: number;
|
|
1123
|
+
bulletins?: {
|
|
1124
|
+
total: number;
|
|
1125
|
+
top: OdBulletin[];
|
|
1126
|
+
by_category: Array<{
|
|
1127
|
+
category: string | null;
|
|
1128
|
+
category_code: string | null;
|
|
1129
|
+
count: number;
|
|
1130
|
+
items: OdBulletin[];
|
|
1131
|
+
}>;
|
|
1132
|
+
};
|
|
1133
|
+
/** 縣市視角才有:中央官方條目提及本縣市(只是提及,不宣稱適用) */
|
|
1134
|
+
central_related?: OdBulletin[];
|
|
1135
|
+
/** 全國視角才有:只提及單一縣市的媒體報導 */
|
|
1136
|
+
regional_media?: OdBulletin[];
|
|
1137
|
+
law_changes?: OdBulletin[];
|
|
1138
|
+
law_modified?: Array<{
|
|
1139
|
+
name: string | null;
|
|
1140
|
+
modified_date: string | null;
|
|
1141
|
+
}>;
|
|
1142
|
+
indicators?: OdBriefIndicator[];
|
|
1143
|
+
/** 週報、月報才有:各指標最新一期 */
|
|
1144
|
+
indicators_snapshot?: OdBriefIndicator[];
|
|
1145
|
+
counts?: Record<string, unknown>;
|
|
1146
|
+
/** 本期來源取得狀況:status_code 不是 complete 時「沒有公告」可能是缺漏 */
|
|
1147
|
+
coverage?: {
|
|
1148
|
+
status: string | null;
|
|
1149
|
+
status_code: string | null;
|
|
1150
|
+
notice: string | null;
|
|
1151
|
+
sources_total: number;
|
|
1152
|
+
sources_ok: number;
|
|
1153
|
+
};
|
|
1154
|
+
sources?: Array<{
|
|
1155
|
+
agency: string | null;
|
|
1156
|
+
name: string | null;
|
|
1157
|
+
url: string | null;
|
|
1158
|
+
license: string | null;
|
|
1159
|
+
usage_policy: string;
|
|
1160
|
+
usage_policy_code: OdUsagePolicy;
|
|
1161
|
+
content_withheld: boolean;
|
|
1162
|
+
}>;
|
|
1163
|
+
usage_policy_notice: string;
|
|
1164
|
+
}
|
|
1165
|
+
interface OdBriefListResult {
|
|
1166
|
+
period_type: OdPeriodType;
|
|
1167
|
+
city: string | null;
|
|
1168
|
+
items: Array<{
|
|
1169
|
+
period_key: string | null;
|
|
1170
|
+
version: number | null;
|
|
1171
|
+
status: string | null;
|
|
1172
|
+
status_code: string | null;
|
|
1173
|
+
bulletin_count: number;
|
|
1174
|
+
indicator_count: number;
|
|
1175
|
+
built_at: string | null;
|
|
1176
|
+
}>;
|
|
1177
|
+
count: number;
|
|
1178
|
+
message: string | null;
|
|
1179
|
+
notice: string;
|
|
1180
|
+
disclaimer: string | null;
|
|
1181
|
+
}
|
|
1182
|
+
interface OdBriefCoverageResult {
|
|
1183
|
+
/** 這份資料的用途說明:平台取得公告來源的狀況,不是公告內容 */
|
|
1184
|
+
purpose: string;
|
|
1185
|
+
period_type: OdPeriodType;
|
|
1186
|
+
/** 最新一期;還沒產出過為 null */
|
|
1187
|
+
period_key: string | null;
|
|
1188
|
+
built_at: string | null;
|
|
1189
|
+
views_total: number;
|
|
1190
|
+
/** 只列有狀況的視角 */
|
|
1191
|
+
items: Array<{
|
|
1192
|
+
city: string | null;
|
|
1193
|
+
view: '全國' | '縣市';
|
|
1194
|
+
status: string | null;
|
|
1195
|
+
status_code: string | null;
|
|
1196
|
+
notice: string | null;
|
|
1197
|
+
sources_total: number;
|
|
1198
|
+
sources_ok: number;
|
|
1199
|
+
failed: Array<{
|
|
1200
|
+
agency: string | null;
|
|
1201
|
+
since: string | null;
|
|
1202
|
+
}>;
|
|
1203
|
+
unstable: Array<{
|
|
1204
|
+
agency: string | null;
|
|
1205
|
+
since: string | null;
|
|
1206
|
+
last_ok_at: string | null;
|
|
1207
|
+
}>;
|
|
1208
|
+
not_run: Array<{
|
|
1209
|
+
agency: string | null;
|
|
1210
|
+
since: string | null;
|
|
1211
|
+
}>;
|
|
1212
|
+
}>;
|
|
1213
|
+
message: string | null;
|
|
1214
|
+
}
|
|
1215
|
+
/** 事實的逐字引文:quote_withheld 為 true 表示引文出自依授權不能提供的內容,請只顯示來源與連結 */
|
|
1216
|
+
interface OdReportQuote {
|
|
1217
|
+
quote: string | null;
|
|
1218
|
+
quote_withheld: boolean;
|
|
1219
|
+
source_type: 'bulletin' | 'document' | 'indicator' | null;
|
|
1220
|
+
bulletin_id: number | null;
|
|
1221
|
+
agency: string | null;
|
|
1222
|
+
title: string | null;
|
|
1223
|
+
url: string | null;
|
|
1224
|
+
published_at: string | null;
|
|
1225
|
+
location: string | null;
|
|
1226
|
+
/** 引文出處(中文):標題/來源摘要/內文/附件(掃描頁經 AI 辨識,可能看錯)… */
|
|
1227
|
+
extraction: string | null;
|
|
1228
|
+
usage_policy_code: OdUsagePolicy | null;
|
|
1229
|
+
}
|
|
1230
|
+
interface OdReportEvent {
|
|
1231
|
+
title: string | null;
|
|
1232
|
+
national: boolean;
|
|
1233
|
+
cities: string[];
|
|
1234
|
+
lifecycle: string | null;
|
|
1235
|
+
lifecycle_code: string | null;
|
|
1236
|
+
facts: Array<{
|
|
1237
|
+
text: string | null;
|
|
1238
|
+
areas: string[];
|
|
1239
|
+
quotes: OdReportQuote[];
|
|
1240
|
+
}>;
|
|
1241
|
+
impacts: Array<{
|
|
1242
|
+
text: string | null;
|
|
1243
|
+
dimension: string | null;
|
|
1244
|
+
dimension_code: string | null;
|
|
1245
|
+
audience: string[];
|
|
1246
|
+
horizon: string | null;
|
|
1247
|
+
conditions: string[];
|
|
1248
|
+
counterpoints: string[];
|
|
1249
|
+
}>;
|
|
1250
|
+
actions: Array<{
|
|
1251
|
+
task: string | null;
|
|
1252
|
+
done_when: string | null;
|
|
1253
|
+
due_date: string | null;
|
|
1254
|
+
audience: string[];
|
|
1255
|
+
}>;
|
|
1256
|
+
questions: Array<{
|
|
1257
|
+
question: string | null;
|
|
1258
|
+
answer: string | null;
|
|
1259
|
+
}>;
|
|
1260
|
+
watch: Array<{
|
|
1261
|
+
item: string | null;
|
|
1262
|
+
trigger: string | null;
|
|
1263
|
+
}>;
|
|
1264
|
+
dont_say: string[];
|
|
1265
|
+
topic: {
|
|
1266
|
+
title: string | null;
|
|
1267
|
+
stage: string | null;
|
|
1268
|
+
stage_code: string | null;
|
|
1269
|
+
text: string | null;
|
|
1270
|
+
} | null;
|
|
1271
|
+
policy_flag: {
|
|
1272
|
+
topic: string | null;
|
|
1273
|
+
topic_code: string | null;
|
|
1274
|
+
reason: string | null;
|
|
1275
|
+
} | null;
|
|
1276
|
+
unknowns: string[];
|
|
1277
|
+
changed_since_previous: string | null;
|
|
1278
|
+
}
|
|
1279
|
+
interface OdNewsReportResult extends OdNoticeBase {
|
|
1280
|
+
/** false=這一期還沒產出或不存在(照常扣點) */
|
|
1281
|
+
available: boolean;
|
|
1282
|
+
id?: number | null;
|
|
1283
|
+
period_type: OdPeriodType | null;
|
|
1284
|
+
period_label: string | null;
|
|
1285
|
+
period_key: string | null;
|
|
1286
|
+
city: string | null;
|
|
1287
|
+
view: '全國' | '縣市';
|
|
1288
|
+
version?: number | null;
|
|
1289
|
+
generation_state?: string | null;
|
|
1290
|
+
/** complete/partial(部分新聞只有標題)/rules_only(AI 還沒分析完,只列標題)/empty(本期沒有新消息) */
|
|
1291
|
+
generation_state_code?: 'complete' | 'partial' | 'rules_only' | 'empty' | (string & {}) | null;
|
|
1292
|
+
confidence?: string | null;
|
|
1293
|
+
/** degraded=本期部分來源沒有取得 */
|
|
1294
|
+
confidence_code?: 'normal' | 'degraded' | (string & {}) | null;
|
|
1295
|
+
event_count?: number;
|
|
1296
|
+
built_at?: string | null;
|
|
1297
|
+
knowledge_cutoff?: string | null;
|
|
1298
|
+
headline?: string | null;
|
|
1299
|
+
overview?: string | null;
|
|
1300
|
+
key_points?: string[];
|
|
1301
|
+
impacts?: string[];
|
|
1302
|
+
actions?: string[];
|
|
1303
|
+
for_agents?: string[];
|
|
1304
|
+
dont_say?: string[];
|
|
1305
|
+
watch?: string[];
|
|
1306
|
+
unknowns?: string[];
|
|
1307
|
+
sections?: Array<{
|
|
1308
|
+
key: string | null;
|
|
1309
|
+
title: string | null;
|
|
1310
|
+
items: Array<{
|
|
1311
|
+
kind: string | null;
|
|
1312
|
+
text: string | null;
|
|
1313
|
+
note: string | null;
|
|
1314
|
+
audience: string[];
|
|
1315
|
+
areas: string[];
|
|
1316
|
+
refs: Array<Record<string, unknown>>;
|
|
1317
|
+
}>;
|
|
1318
|
+
}>;
|
|
1319
|
+
events?: OdReportEvent[];
|
|
1320
|
+
policy_review_flags?: Array<Record<string, unknown>>;
|
|
1321
|
+
/** 引用的公告與報導(已依授權裁切) */
|
|
1322
|
+
sources?: OdBulletin[];
|
|
1323
|
+
/** 這份報告用的期別摘要版本:可用 briefs.get 帶相同 period_key 與 version 取回 */
|
|
1324
|
+
brief_versions?: {
|
|
1325
|
+
central: number | null;
|
|
1326
|
+
local: number | null;
|
|
1327
|
+
};
|
|
1328
|
+
/** AI 整理內容的固定提醒(不是價格預測),請原文顯示 */
|
|
1329
|
+
ai_notice: string;
|
|
1330
|
+
usage_policy_notice: string;
|
|
1331
|
+
}
|
|
1332
|
+
interface OdReportListResult {
|
|
1333
|
+
period_type: OdPeriodType;
|
|
1334
|
+
city: string | null;
|
|
1335
|
+
items: Array<{
|
|
1336
|
+
period_key: string | null;
|
|
1337
|
+
version: number | null;
|
|
1338
|
+
generation_state: string | null;
|
|
1339
|
+
generation_state_code: string | null;
|
|
1340
|
+
headline: string | null;
|
|
1341
|
+
event_count: number;
|
|
1342
|
+
built_at: string | null;
|
|
1343
|
+
/** 只有 marketBriefs.list 有 */
|
|
1344
|
+
confidence?: string | null;
|
|
1345
|
+
confidence_code?: string | null;
|
|
1346
|
+
key_point_count?: number;
|
|
1347
|
+
}>;
|
|
1348
|
+
count: number;
|
|
1349
|
+
message: string | null;
|
|
1350
|
+
ai_notice: string;
|
|
1351
|
+
disclaimer: string | null;
|
|
1352
|
+
}
|
|
1353
|
+
interface OdNewsTopicsQuery {
|
|
1354
|
+
/** 縣市名(中文);不帶=只有全國議題,帶了=該縣市+全國 */
|
|
1355
|
+
city?: string;
|
|
1356
|
+
/** 1~30,預設 8 */
|
|
1357
|
+
limit?: number;
|
|
1358
|
+
}
|
|
1359
|
+
interface OdNewsTopicsResult {
|
|
1360
|
+
city: string | null;
|
|
1361
|
+
items: Array<{
|
|
1362
|
+
topic_uuid: string | null;
|
|
1363
|
+
title: string | null;
|
|
1364
|
+
category: string | null;
|
|
1365
|
+
category_code: string | null;
|
|
1366
|
+
stage: string | null;
|
|
1367
|
+
stage_code: string | null;
|
|
1368
|
+
/** 全國議題為 null */
|
|
1369
|
+
city: string | null;
|
|
1370
|
+
first_period_key: string | null;
|
|
1371
|
+
last_period_key: string | null;
|
|
1372
|
+
updated_at: string | null;
|
|
1373
|
+
/** 最新 6 次進展,最新在前 */
|
|
1374
|
+
timeline: Array<{
|
|
1375
|
+
period_type: string | null;
|
|
1376
|
+
period_key: string | null;
|
|
1377
|
+
stage: string | null;
|
|
1378
|
+
stage_code: string | null;
|
|
1379
|
+
text: string | null;
|
|
1380
|
+
sources: Array<Record<string, unknown>>;
|
|
1381
|
+
}>;
|
|
1382
|
+
}>;
|
|
1383
|
+
count: number;
|
|
1384
|
+
message: string | null;
|
|
1385
|
+
ai_notice: string;
|
|
1386
|
+
attribution: string;
|
|
1387
|
+
disclaimer: string | null;
|
|
1388
|
+
}
|
|
1389
|
+
interface OdStatsCpiQuery {
|
|
1390
|
+
/** 民國年(40~200),與 month 成對查單月 */
|
|
1391
|
+
roc_year?: number;
|
|
1392
|
+
month?: number;
|
|
1393
|
+
/** 區間起訖的民國年(含頭尾整年),可單獨使用;不能和 roc_year 同時帶 */
|
|
1394
|
+
from_year?: number;
|
|
1395
|
+
to_year?: number;
|
|
1396
|
+
}
|
|
1397
|
+
interface OdStatsCpiResult {
|
|
1398
|
+
/** 由舊到新;period 是民國年-月(例如 115-06) */
|
|
1399
|
+
items: Array<{
|
|
1400
|
+
roc_year: number | null;
|
|
1401
|
+
month: number | null;
|
|
1402
|
+
period: string | null;
|
|
1403
|
+
period_text: string | null;
|
|
1404
|
+
cpi_value: number | null;
|
|
1405
|
+
}>;
|
|
1406
|
+
count: number;
|
|
1407
|
+
/** 🔴 目前的基期(最新月份=100);每發布一個新月份整張表會重算,請一併保存 */
|
|
1408
|
+
base_period: string | null;
|
|
1409
|
+
base_period_text: string | null;
|
|
1410
|
+
message: string | null;
|
|
1411
|
+
notice: string;
|
|
1412
|
+
attribution: string;
|
|
1413
|
+
}
|
|
1414
|
+
type OdMarketIndicator = 'transfer_count' | 'building_permit_count' | 'use_permit_count' | 'construction_start_count' | 'housing_loan_balance' | 'construction_loan_balance' | 'new_housing_loan_rate' | 're_loan_concentration' | 'rent_cpi' | 'business_cycle_score' | 'housing_loan_flow' | 'housing_price_index' | 'unsold_new_housing' | 'residential_permit_floor_area' | 'presale_filing_units' | 'residential_permit_units';
|
|
1415
|
+
interface OdStatsMarketQuery {
|
|
1416
|
+
items: OdMarketIndicator[];
|
|
1417
|
+
/** 縣市名(中文);不帶=全國。只有全國數字的指標帶縣市會回空序列並說明 */
|
|
1418
|
+
city?: string;
|
|
1419
|
+
/** 每個指標最近幾期,1~120,預設 24 */
|
|
1420
|
+
periods?: number;
|
|
1421
|
+
}
|
|
1422
|
+
interface OdStatsMarketResult {
|
|
1423
|
+
region: string;
|
|
1424
|
+
series: Array<{
|
|
1425
|
+
indicator: string;
|
|
1426
|
+
indicator_code: OdMarketIndicator;
|
|
1427
|
+
unit: string;
|
|
1428
|
+
agency: string;
|
|
1429
|
+
source_url: string | null;
|
|
1430
|
+
frequency: string;
|
|
1431
|
+
/** 有哪些地區的數字:只有全國/全國與 22 縣市/全國與六都 */
|
|
1432
|
+
regions: string;
|
|
1433
|
+
/** true=率/比率/分數,只看原值與百分點差,不算成長率 */
|
|
1434
|
+
level_only: boolean;
|
|
1435
|
+
/** 由舊到新;期別西元(月 YYYY-MM、季 YYYY-Qn);provisional 為 true 的是初值,不可寫成漲跌 */
|
|
1436
|
+
points: Array<{
|
|
1437
|
+
period: string | null;
|
|
1438
|
+
value: number | null;
|
|
1439
|
+
provisional: boolean;
|
|
1440
|
+
revised_at: string | null;
|
|
1441
|
+
prev_value: number | null;
|
|
1442
|
+
extra: Record<string, unknown>;
|
|
1443
|
+
}>;
|
|
1444
|
+
total_available: number;
|
|
1445
|
+
truncated: boolean;
|
|
1446
|
+
message: string | null;
|
|
1447
|
+
}>;
|
|
1448
|
+
notice: string;
|
|
1449
|
+
attribution: string;
|
|
1450
|
+
disclaimer: string | null;
|
|
1451
|
+
}
|
|
1452
|
+
/**
|
|
1453
|
+
* 多邊形:頂點陣列,`[緯度, 經度]`(注意:**緯度在前**,與 GeoJSON 的 `[經度, 緯度]` 相反)或 `{ lat, lng }`;
|
|
1454
|
+
* 也可以直接給已組好的字串 `'緯度,經度;緯度,經度;…'`。首尾不同會自動閉合。
|
|
1455
|
+
* 限制:3~300 個頂點、台灣範圍內、邊不可交叉、面積 ≤ 5,000 平方公里;不合規定丟 `INVALID_REQUEST`(不扣點)。
|
|
1456
|
+
*/
|
|
1457
|
+
type OdPolygon = string | Array<[number, number]> | Array<{
|
|
1458
|
+
lat: number;
|
|
1459
|
+
lng: number;
|
|
1460
|
+
}>;
|
|
1461
|
+
/** 地圖範圍(西南角、東北角)與縮放層級;各資源的 zoom 下限與範圍上限見方法說明,不符丟 `INVALID_REQUEST`(不扣點) */
|
|
1462
|
+
interface OdBbox {
|
|
1463
|
+
sw_lat: number;
|
|
1464
|
+
sw_lng: number;
|
|
1465
|
+
ne_lat: number;
|
|
1466
|
+
ne_lng: number;
|
|
1467
|
+
/** 0~22 的整數(與 Leaflet/Mapbox/Google 地圖相同) */
|
|
1468
|
+
zoom: number;
|
|
1469
|
+
}
|
|
1470
|
+
/** 簡化的 GeoJSON 幾何(座標序 `[經度, 緯度]`,WGS84;精度與上游相同,沒有四捨五入) */
|
|
1471
|
+
interface OdGeometry {
|
|
1472
|
+
type: 'Polygon' | 'MultiPolygon' | 'Point' | 'LineString' | 'MultiLineString' | 'MultiPoint' | 'GeometryCollection' | (string & {});
|
|
1473
|
+
coordinates: unknown;
|
|
1474
|
+
}
|
|
1475
|
+
interface OdFeature<P> {
|
|
1476
|
+
type: 'Feature';
|
|
1477
|
+
geometry: OdGeometry;
|
|
1478
|
+
properties: P;
|
|
1479
|
+
}
|
|
1480
|
+
interface OdFeatureCollection<P> {
|
|
1481
|
+
type: 'FeatureCollection';
|
|
1482
|
+
features: Array<OdFeature<P>>;
|
|
1483
|
+
/** features 的筆數 */
|
|
1484
|
+
total: number;
|
|
1485
|
+
/** true=超過上限已截斷,請提示使用者放大地圖 */
|
|
1486
|
+
truncated: boolean;
|
|
1487
|
+
attribution: string;
|
|
1488
|
+
[key: string]: unknown;
|
|
1489
|
+
}
|
|
1490
|
+
type OdAdminLevel = 'village' | 'area' | 'city';
|
|
1491
|
+
interface OdWindowQuery {
|
|
1492
|
+
/** 期間起日(YYYY-MM-DD) */
|
|
1493
|
+
date_start?: string;
|
|
1494
|
+
/** 期間迄日(YYYY-MM-DD;不帶=今天) */
|
|
1495
|
+
date_end?: string;
|
|
1496
|
+
/** 沒有給齊起訖日期時往前回溯幾個月(1~120,預設 12) */
|
|
1497
|
+
months?: number;
|
|
1498
|
+
}
|
|
1499
|
+
interface OdSpatialLvrSummaryQuery extends OdWindowQuery {
|
|
1500
|
+
polygon: OdPolygon;
|
|
1501
|
+
transaction_type?: OdLvrTransactionType;
|
|
1502
|
+
/** 預設 house(房地);混入土地會把均價拉低 */
|
|
1503
|
+
transaction_target?: OdLvrTarget[];
|
|
1504
|
+
}
|
|
1505
|
+
interface OdSpatialLvrSummaryResult {
|
|
1506
|
+
query: {
|
|
1507
|
+
transaction_type: string;
|
|
1508
|
+
transaction_type_code: OdLvrTransactionType;
|
|
1509
|
+
transaction_target: string[];
|
|
1510
|
+
transaction_target_codes: OdLvrTarget[];
|
|
1511
|
+
date_start: string;
|
|
1512
|
+
date_end: string;
|
|
1513
|
+
polygon_area_km2: number;
|
|
1514
|
+
vertex_count: number;
|
|
1515
|
+
};
|
|
1516
|
+
/** 0 表示範圍內這段期間沒有成交(不是錯誤) */
|
|
1517
|
+
count: number;
|
|
1518
|
+
/**
|
|
1519
|
+
* 買賣與預售:`avg_unit_price_wan_per_ping`、`median_unit_price_wan_per_ping`、`avg|median|min|max_total_price_wan`;
|
|
1520
|
+
* 租賃:`avg|median_rent_per_ping_month_twd`、`avg|median|min|max_monthly_rent_twd`。件數為 0 時是 null
|
|
1521
|
+
*/
|
|
1522
|
+
stats: Record<string, number | null> | null;
|
|
1523
|
+
first_transaction_date: string | null;
|
|
1524
|
+
last_transaction_date: string | null;
|
|
1525
|
+
unit_price_basis: string;
|
|
1526
|
+
parking_estimated_count: number;
|
|
1527
|
+
parking_unpriced_count: number;
|
|
1528
|
+
message: string | null;
|
|
1529
|
+
notice: string;
|
|
1530
|
+
attribution: string;
|
|
1531
|
+
}
|
|
1532
|
+
interface OdSpatialCompaniesQuery extends OdWindowQuery {
|
|
1533
|
+
polygon: OdPolygon;
|
|
1534
|
+
/** 附公司明細(預設 false) */
|
|
1535
|
+
include_items?: boolean;
|
|
1536
|
+
/** 明細筆數上限(1~100,預設 50) */
|
|
1537
|
+
limit?: number;
|
|
1538
|
+
}
|
|
1539
|
+
interface OdSpatialCompaniesResult {
|
|
1540
|
+
query: Record<string, unknown>;
|
|
1541
|
+
count: number;
|
|
1542
|
+
capital_sum_wan: number | null;
|
|
1543
|
+
capital_avg_wan: number | null;
|
|
1544
|
+
capital_max_wan: number | null;
|
|
1545
|
+
/** 核准日新到舊;沒有要求明細時是 null。distance_m 是到範圍中心的直線距離,僅供參考 */
|
|
1546
|
+
items: Array<{
|
|
1547
|
+
tax_id: string | null;
|
|
1548
|
+
name: string | null;
|
|
1549
|
+
capital_wan: number | null;
|
|
1550
|
+
city: string | null;
|
|
1551
|
+
address: string | null;
|
|
1552
|
+
approved_date: string | null;
|
|
1553
|
+
distance_m: number | null;
|
|
1554
|
+
}> | null;
|
|
1555
|
+
message: string | null;
|
|
1556
|
+
notice: string;
|
|
1557
|
+
attribution: string;
|
|
1558
|
+
}
|
|
1559
|
+
interface OdSpatialVillagesResult {
|
|
1560
|
+
level: string;
|
|
1561
|
+
level_code: OdAdminLevel;
|
|
1562
|
+
count: number;
|
|
1563
|
+
/** 可直接帶進 `stats.villages({ codes })` */
|
|
1564
|
+
codes: string[];
|
|
1565
|
+
/** 村里層級另有 district、city */
|
|
1566
|
+
items: Array<{
|
|
1567
|
+
code: string;
|
|
1568
|
+
name: string;
|
|
1569
|
+
district?: string | null;
|
|
1570
|
+
city?: string | null;
|
|
1571
|
+
}>;
|
|
1572
|
+
polygon_area_km2: number | null;
|
|
1573
|
+
message: string | null;
|
|
1574
|
+
notice: string;
|
|
1575
|
+
attribution: string;
|
|
1576
|
+
}
|
|
1577
|
+
interface OdSpatialVillageGeometryResult {
|
|
1578
|
+
/** GeoJSON Polygon([經度, 緯度]) */
|
|
1579
|
+
geometry: OdGeometry;
|
|
1580
|
+
/** 同一個範圍的 polygon 字串,可直接當 `spatial.*` 的 polygon;頂點超過 300 時是 null */
|
|
1581
|
+
polygon: string | null;
|
|
1582
|
+
vertex_count: number;
|
|
1583
|
+
simplify_tolerance_deg: number | null;
|
|
1584
|
+
village_count: number;
|
|
1585
|
+
notice: string;
|
|
1586
|
+
attribution: string;
|
|
1587
|
+
}
|
|
1588
|
+
interface OdBoundaryProperties {
|
|
1589
|
+
code: string;
|
|
1590
|
+
name: string;
|
|
1591
|
+
parent_code: string | null;
|
|
1592
|
+
/** 村里層級才有:所屬鄉鎮市區 */
|
|
1593
|
+
district?: string | null;
|
|
1594
|
+
}
|
|
1595
|
+
interface OdBoundaryLookupQuery {
|
|
1596
|
+
level: OdAdminLevel;
|
|
1597
|
+
/** 官方代碼(最多 50 個);與 names 二擇一 */
|
|
1598
|
+
codes?: string[];
|
|
1599
|
+
/** `{ city }`(level=city)或 `{ city, district }`(level=area),最多 50 個;也可給字串 `'臺北市/信義區;基隆市/中正區'`。village 只能用 codes */
|
|
1600
|
+
names?: Array<{
|
|
1601
|
+
city: string;
|
|
1602
|
+
district?: string;
|
|
1603
|
+
}> | string;
|
|
1604
|
+
}
|
|
1605
|
+
interface OdBoundaryLookupResult {
|
|
1606
|
+
/** 🔴 point/bbox 只用來移動地圖鏡頭(fitBounds),不是資料篩選條件 */
|
|
1607
|
+
items: Array<{
|
|
1608
|
+
code: string;
|
|
1609
|
+
level: string;
|
|
1610
|
+
level_code: OdAdminLevel;
|
|
1611
|
+
name: string;
|
|
1612
|
+
city: string | null;
|
|
1613
|
+
district: string | null;
|
|
1614
|
+
point: {
|
|
1615
|
+
lat: number;
|
|
1616
|
+
lng: number;
|
|
1617
|
+
} | null;
|
|
1618
|
+
bbox: {
|
|
1619
|
+
west: number;
|
|
1620
|
+
south: number;
|
|
1621
|
+
east: number;
|
|
1622
|
+
north: number;
|
|
1623
|
+
} | null;
|
|
1624
|
+
}>;
|
|
1625
|
+
missing_codes: string[];
|
|
1626
|
+
/** reason_code:not_found/ambiguous(對到不只一個,請改用代碼)/missing_geometry */
|
|
1627
|
+
unresolved: Array<{
|
|
1628
|
+
city: string | null;
|
|
1629
|
+
district: string | null;
|
|
1630
|
+
reason: string;
|
|
1631
|
+
reason_code: 'not_found' | 'ambiguous' | 'missing_geometry' | (string & {});
|
|
1632
|
+
}>;
|
|
1633
|
+
notice: string;
|
|
1634
|
+
attribution: string;
|
|
1635
|
+
}
|
|
1636
|
+
/** 土地使用分區的一層(使用分區或使用地編定) */
|
|
1637
|
+
interface OdZoningLayer {
|
|
1638
|
+
name: string;
|
|
1639
|
+
code: string | null;
|
|
1640
|
+
/** 大類中文(住宅、商業、工業、農業…),可用來上色 */
|
|
1641
|
+
category: string | null;
|
|
1642
|
+
category_code: string | null;
|
|
1643
|
+
plan_name: string | null;
|
|
1644
|
+
/** 建蔽率(%);沒有官方依據時 null,請顯示「—」不要當 0 */
|
|
1645
|
+
building_coverage_ratio_pct: number | null;
|
|
1646
|
+
floor_area_ratio_pct: number | null;
|
|
1647
|
+
/** 資料提供機關 */
|
|
1648
|
+
source: string | null;
|
|
1649
|
+
source_updated_at: string | null;
|
|
1650
|
+
}
|
|
1651
|
+
interface OdZoning {
|
|
1652
|
+
status: string;
|
|
1653
|
+
/** covered 才有分區;urban_not_covered、no_data 都是查不到,🔴 查不到不代表沒有使用限制 */
|
|
1654
|
+
status_code: 'covered' | 'urban_not_covered' | 'no_data' | (string & {});
|
|
1655
|
+
plan_type: string | null;
|
|
1656
|
+
plan_type_code: 'urban' | 'non_urban' | 'national_park' | null;
|
|
1657
|
+
city: string | null;
|
|
1658
|
+
district: string | null;
|
|
1659
|
+
zone: OdZoningLayer | null;
|
|
1660
|
+
/** 只有非都市土地有(使用地編定,例如甲種建築用地) */
|
|
1661
|
+
land_use: OdZoningLayer | null;
|
|
1662
|
+
/** true=取 33 公尺內最近的分區,不是確定值,顯示時請註明 */
|
|
1663
|
+
approximate: boolean;
|
|
1664
|
+
message: string | null;
|
|
1665
|
+
}
|
|
1666
|
+
interface OdZoningBatchResult {
|
|
1667
|
+
results: Array<{
|
|
1668
|
+
index: number;
|
|
1669
|
+
lat: number;
|
|
1670
|
+
lng: number;
|
|
1671
|
+
zoning: OdZoning;
|
|
1672
|
+
}>;
|
|
1673
|
+
point_count: number;
|
|
1674
|
+
covered_count: number;
|
|
1675
|
+
max_points: number;
|
|
1676
|
+
notice: string;
|
|
1677
|
+
disclaimer: string;
|
|
1678
|
+
attribution: string;
|
|
1679
|
+
}
|
|
1680
|
+
/** WMTS 圖磚圖層(url_template 是 `{z}/{y}/{x}`,GoogleMapsCompatible/EPSG:3857) */
|
|
1681
|
+
interface OdTileLayer {
|
|
1682
|
+
id: string;
|
|
1683
|
+
name: string;
|
|
1684
|
+
type: 'wmts' | (string & {});
|
|
1685
|
+
url_template: string;
|
|
1686
|
+
tile_matrix_set: string;
|
|
1687
|
+
format: string | null;
|
|
1688
|
+
/** 🔴 畫面上須顯示 */
|
|
1689
|
+
attribution: string | null;
|
|
1690
|
+
/** false=底圖 */
|
|
1691
|
+
is_overlay: boolean;
|
|
1692
|
+
default_visible: boolean;
|
|
1693
|
+
opacity: number | null;
|
|
1694
|
+
}
|
|
1695
|
+
interface OdTilesResult {
|
|
1696
|
+
layers: OdTileLayer[];
|
|
1697
|
+
/** 需授權而平台尚未開通的圖層(不給網址,請不要自行開啟) */
|
|
1698
|
+
unavailable: Array<{
|
|
1699
|
+
id: string;
|
|
1700
|
+
name: string;
|
|
1701
|
+
reason: string;
|
|
1702
|
+
}>;
|
|
1703
|
+
/** 圖磚使用條款(App 直接向國土測繪中心取圖,須自行遵守) */
|
|
1704
|
+
terms: string;
|
|
1705
|
+
[key: string]: unknown;
|
|
1706
|
+
}
|
|
1707
|
+
interface OdZoningFeatureProperties {
|
|
1708
|
+
id: number | string | null;
|
|
1709
|
+
name: string | null;
|
|
1710
|
+
code: string | null;
|
|
1711
|
+
category: string | null;
|
|
1712
|
+
category_code: string | null;
|
|
1713
|
+
plan_type: string | null;
|
|
1714
|
+
plan_type_code: string | null;
|
|
1715
|
+
plan_name: string | null;
|
|
1716
|
+
building_coverage_ratio_pct: number | null;
|
|
1717
|
+
floor_area_ratio_pct: number | null;
|
|
1718
|
+
city: string | null;
|
|
1719
|
+
district: string | null;
|
|
1720
|
+
}
|
|
1721
|
+
interface OdCadastreSection {
|
|
1722
|
+
/** `{鄉鎮代碼}_{段號}`,可帶進 `cadastre.landInfo()` */
|
|
1723
|
+
section_code: string;
|
|
1724
|
+
section_name: string | null;
|
|
1725
|
+
/** 含前導零,請當字串 */
|
|
1726
|
+
section_no: string | null;
|
|
1727
|
+
city: string | null;
|
|
1728
|
+
district: string | null;
|
|
1729
|
+
district_code: string | null;
|
|
1730
|
+
/** 地政事務所簡稱 */
|
|
1731
|
+
office: string | null;
|
|
1732
|
+
office_code: string | null;
|
|
1733
|
+
}
|
|
1734
|
+
interface OdCadastreSectionsQuery {
|
|
1735
|
+
city?: string;
|
|
1736
|
+
district?: string;
|
|
1737
|
+
/** 段名關鍵字(部分相符) */
|
|
1738
|
+
keyword?: string;
|
|
1739
|
+
/** 1~500,預設 100 */
|
|
1740
|
+
limit?: number;
|
|
1741
|
+
}
|
|
1742
|
+
interface OdCadastreSectionsResult {
|
|
1743
|
+
items: OdCadastreSection[];
|
|
1744
|
+
count: number;
|
|
1745
|
+
/** 符合條件的總數(不受 limit 影響) */
|
|
1746
|
+
total: number;
|
|
1747
|
+
truncated: boolean;
|
|
1748
|
+
message: string | null;
|
|
1749
|
+
notice: string;
|
|
1750
|
+
attribution: string;
|
|
1751
|
+
[key: string]: unknown;
|
|
1752
|
+
}
|
|
1753
|
+
interface OdCadastreReversePointResult {
|
|
1754
|
+
center: OdCenter;
|
|
1755
|
+
/** false=這個位置查不到地段(例如海域) */
|
|
1756
|
+
found: boolean;
|
|
1757
|
+
city: string | null;
|
|
1758
|
+
district: string | null;
|
|
1759
|
+
district_code: string | null;
|
|
1760
|
+
village: string | null;
|
|
1761
|
+
village_code: string | null;
|
|
1762
|
+
section_code: string | null;
|
|
1763
|
+
section_name: string | null;
|
|
1764
|
+
section_no: string | null;
|
|
1765
|
+
office: string | null;
|
|
1766
|
+
office_code: string | null;
|
|
1767
|
+
/** 這個地段是否已在平台的地段主檔 */
|
|
1768
|
+
in_section_list: boolean;
|
|
1769
|
+
message: string | null;
|
|
1770
|
+
attribution: string;
|
|
1771
|
+
}
|
|
1772
|
+
interface OdCadastreLandInfoResult {
|
|
1773
|
+
/** false=平台尚無這筆地號的宗地資料(多數地號如此,照常扣點;不代表地號不存在) */
|
|
1774
|
+
available: boolean;
|
|
1775
|
+
/** 只有位置、面積、地段地號;沒有任何權屬資料 */
|
|
1776
|
+
item: {
|
|
1777
|
+
section_code: string;
|
|
1778
|
+
section_name: string | null;
|
|
1779
|
+
land_no: string;
|
|
1780
|
+
land_no_8: string;
|
|
1781
|
+
area_ping: number | null;
|
|
1782
|
+
area_sqm: number | null;
|
|
1783
|
+
centroid: {
|
|
1784
|
+
lat: number | null;
|
|
1785
|
+
lng: number | null;
|
|
1786
|
+
} | null;
|
|
1787
|
+
geometry: OdGeometry | null;
|
|
1788
|
+
fetched_at: string | null;
|
|
1789
|
+
} | null;
|
|
1790
|
+
message: string | null;
|
|
1791
|
+
attribution: string;
|
|
1792
|
+
}
|
|
1793
|
+
/** 熱力點(原始點,沒有抽樣、沒有正規化);value 的單位看 value_unit */
|
|
1794
|
+
interface OdHeatResult {
|
|
1795
|
+
bounds: OdBbox;
|
|
1796
|
+
points: Array<{
|
|
1797
|
+
lat: number;
|
|
1798
|
+
lng: number;
|
|
1799
|
+
value: number | null;
|
|
1800
|
+
}>;
|
|
1801
|
+
count: number;
|
|
1802
|
+
/** true=已達 20,000 點上限 */
|
|
1803
|
+
truncated: boolean;
|
|
1804
|
+
max_points: number;
|
|
1805
|
+
/** value 的單位;密度圖為 null(每點權重相同) */
|
|
1806
|
+
value_unit: string | null;
|
|
1807
|
+
/** 權重的意義(請寫在圖例) */
|
|
1808
|
+
weight: string;
|
|
1809
|
+
attribution: string;
|
|
1810
|
+
[key: string]: unknown;
|
|
1811
|
+
}
|
|
1812
|
+
interface OdHeatDealsQuery extends OdBbox {
|
|
1813
|
+
/** unit_price=單價(預設,萬元/坪;租賃為元/坪/月)/price=總價(萬元;租賃為元/月)/density=只看密度 */
|
|
1814
|
+
mode?: 'unit_price' | 'price' | 'density';
|
|
1815
|
+
transaction_type?: OdLvrTransactionType;
|
|
1816
|
+
transaction_target?: OdLvrTarget[];
|
|
1817
|
+
/** 政府登錄的建物型態全名 */
|
|
1818
|
+
building_type?: string;
|
|
1819
|
+
date_start?: string;
|
|
1820
|
+
date_end?: string;
|
|
1821
|
+
}
|
|
1822
|
+
/** POI 與熱力圖的類型代碼(交通:metro、train、hsr、bus_stop、youbike;其餘見 README) */
|
|
1823
|
+
type OdPoiType = string;
|
|
1824
|
+
interface OdHeatTypesQuery extends OdBbox {
|
|
1825
|
+
types?: OdPoiType[];
|
|
1826
|
+
}
|
|
1827
|
+
type OdHazardType = 'flood' | 'liquefaction' | 'fault' | 'hillside' | 'geological_sensitive' | 'flood_history';
|
|
1828
|
+
interface OdPoiPointsResult {
|
|
1829
|
+
items: Array<{
|
|
1830
|
+
id: number | null;
|
|
1831
|
+
name: string | null;
|
|
1832
|
+
category: string | null;
|
|
1833
|
+
category_code: string | null;
|
|
1834
|
+
address: string | null;
|
|
1835
|
+
lat: number | null;
|
|
1836
|
+
lng: number | null;
|
|
1837
|
+
}>;
|
|
1838
|
+
count: number;
|
|
1839
|
+
/** true=點數接近上限,畫面內可能還有其他點 */
|
|
1840
|
+
limit_reached: boolean;
|
|
1841
|
+
types: string[];
|
|
1842
|
+
notice: string;
|
|
1843
|
+
attribution: string;
|
|
1844
|
+
}
|
|
1845
|
+
type OdChoroplethMetric = 'pop_change' | 'elder_pct' | 'income_median' | 'lvr_price' | 'lvr_count';
|
|
1846
|
+
interface OdChoroplethResult extends OdFeatureCollection<{
|
|
1847
|
+
code: string;
|
|
1848
|
+
name: string;
|
|
1849
|
+
parent_name: string | null;
|
|
1850
|
+
value: number | null;
|
|
1851
|
+
}> {
|
|
1852
|
+
metric: string;
|
|
1853
|
+
metric_code: OdChoroplethMetric;
|
|
1854
|
+
/** value 的單位(%、千元/年、萬元/坪、件),請照實標在圖例 */
|
|
1855
|
+
unit: string;
|
|
1856
|
+
/** 實際粒度(村里/鄉鎮市區),請照實標在圖例 */
|
|
1857
|
+
level: string;
|
|
1858
|
+
level_code: 'village' | 'area' | (string & {});
|
|
1859
|
+
period: string | null;
|
|
1860
|
+
notice: string;
|
|
1861
|
+
}
|
|
1862
|
+
interface OdPaged {
|
|
1863
|
+
total: number;
|
|
1864
|
+
page: number;
|
|
1865
|
+
page_size: number;
|
|
1866
|
+
has_more: boolean;
|
|
1867
|
+
message: string | null;
|
|
1868
|
+
notice: string;
|
|
1869
|
+
/** 個人資料使用限制,請顯示給使用者並遵守 */
|
|
1870
|
+
privacy_notice: string;
|
|
1871
|
+
attribution: string;
|
|
1872
|
+
}
|
|
1873
|
+
interface OdLicensePenalty {
|
|
1874
|
+
penalty_date: string | null;
|
|
1875
|
+
/** 受處分人(公司名稱或來源已遮罩的姓名),平台不還原 */
|
|
1876
|
+
offender: string;
|
|
1877
|
+
/** 罰鍰(元) */
|
|
1878
|
+
fine_twd: number | null;
|
|
1879
|
+
law: string | null;
|
|
1880
|
+
city: string | null;
|
|
1881
|
+
county_code: string | null;
|
|
1882
|
+
source: string | null;
|
|
1883
|
+
}
|
|
1884
|
+
interface OdLicensePenaltiesResult extends OdPaged {
|
|
1885
|
+
query: {
|
|
1886
|
+
q: string | null;
|
|
1887
|
+
};
|
|
1888
|
+
items: OdLicensePenalty[];
|
|
1889
|
+
}
|
|
1890
|
+
interface OdFactory {
|
|
1891
|
+
name: string;
|
|
1892
|
+
/** 工廠登記編號 */
|
|
1893
|
+
registration_no: string | null;
|
|
1894
|
+
tax_id: string | null;
|
|
1895
|
+
/** 產業類別(中文)與代碼(例如「食品製造業」/'08') */
|
|
1896
|
+
industry: string | null;
|
|
1897
|
+
industry_code: string | null;
|
|
1898
|
+
main_products: string | null;
|
|
1899
|
+
city: string | null;
|
|
1900
|
+
address: string | null;
|
|
1901
|
+
lat: number | null;
|
|
1902
|
+
lng: number | null;
|
|
1903
|
+
/** 只有 `factories.nearby()`:直線距離(公尺) */
|
|
1904
|
+
distance_m?: number | null;
|
|
1905
|
+
/** 只有 `factories.search()`:登記狀態、是否有座標、座標怎麼來的 */
|
|
1906
|
+
status?: string | null;
|
|
1907
|
+
has_coordinates?: boolean;
|
|
1908
|
+
coordinate_source?: string | null;
|
|
1909
|
+
coordinate_source_code?: 'address_point' | 'resolution' | 'legacy_cache' | (string & {}) | null;
|
|
1910
|
+
}
|
|
1911
|
+
/** 工廠座標的覆蓋情形:只有門牌已收錄的縣市有系統性的座標 */
|
|
1912
|
+
interface OdFactoryCoverage {
|
|
1913
|
+
/** 門牌有系統性覆蓋的縣市(查無比較可信,但也不是 100%) */
|
|
1914
|
+
geocoded_cities: string[];
|
|
1915
|
+
total: number | null;
|
|
1916
|
+
with_coordinates: number | null;
|
|
1917
|
+
coverage_pct: number | null;
|
|
1918
|
+
/** 只列有座標的縣市 */
|
|
1919
|
+
by_city: Array<{
|
|
1920
|
+
city: string | null;
|
|
1921
|
+
total: number | null;
|
|
1922
|
+
with_coordinates: number | null;
|
|
1923
|
+
coverage_pct: number | null;
|
|
1924
|
+
}>;
|
|
1925
|
+
note: string | null;
|
|
1926
|
+
explanation: string;
|
|
1927
|
+
}
|
|
1928
|
+
interface OdFactoriesNearbyQuery extends OdLocation {
|
|
1929
|
+
/** 半徑(公尺),50~5000 的整數,預設 1000 */
|
|
1930
|
+
radius?: number;
|
|
1931
|
+
}
|
|
1932
|
+
interface OdFactoriesNearbyResult {
|
|
1933
|
+
center: OdCenter;
|
|
1934
|
+
radius_m: number;
|
|
1935
|
+
items: OdFactory[];
|
|
1936
|
+
count: number;
|
|
1937
|
+
/** true=達到 100 家上限 */
|
|
1938
|
+
truncated: boolean;
|
|
1939
|
+
/** 以地址定位時的縣市;直接給座標時為 null */
|
|
1940
|
+
center_city: string | null;
|
|
1941
|
+
/** false=這個縣市的工廠座標還沒系統性建檔,查無幾乎沒有參考價值;不知道縣市時為 null */
|
|
1942
|
+
center_city_covered: boolean | null;
|
|
1943
|
+
coverage: OdFactoryCoverage;
|
|
1944
|
+
message: string | null;
|
|
1945
|
+
notice: string;
|
|
1946
|
+
/** 「查無僅代表圖資未收錄,不等於附近沒有工廠」,請顯示給使用者 */
|
|
1947
|
+
disclaimer: string;
|
|
1948
|
+
attribution: string;
|
|
1949
|
+
}
|
|
1950
|
+
interface OdFactoriesSearchQuery {
|
|
1951
|
+
/** 統一編號(8 碼數字,完全相符) */
|
|
1952
|
+
tax_id?: string;
|
|
1953
|
+
/** 工廠名稱關鍵字(≤ 100 字) */
|
|
1954
|
+
q?: string;
|
|
1955
|
+
city?: string;
|
|
1956
|
+
page?: number;
|
|
1957
|
+
/** 1~200,預設 20 */
|
|
1958
|
+
page_size?: number;
|
|
1959
|
+
}
|
|
1960
|
+
interface OdFactoriesSearchResult {
|
|
1961
|
+
query: {
|
|
1962
|
+
tax_id: string | null;
|
|
1963
|
+
q: string | null;
|
|
1964
|
+
city: string | null;
|
|
1965
|
+
};
|
|
1966
|
+
items: OdFactory[];
|
|
1967
|
+
total: number;
|
|
1968
|
+
page: number;
|
|
1969
|
+
page_size: number;
|
|
1970
|
+
has_more: boolean;
|
|
1971
|
+
coverage: OdFactoryCoverage;
|
|
1972
|
+
message: string | null;
|
|
1973
|
+
notice: string;
|
|
1974
|
+
disclaimer: string;
|
|
1975
|
+
attribution: string;
|
|
1976
|
+
}
|
|
1977
|
+
type OdDayType = 'workday' | 'weekend' | 'holiday' | 'makeup_workday' | 'day_off';
|
|
1978
|
+
interface OdCalendarDay {
|
|
1979
|
+
/** YYYY-MM-DD */
|
|
1980
|
+
date: string;
|
|
1981
|
+
/** 0=週日~6=週六 */
|
|
1982
|
+
weekday: number;
|
|
1983
|
+
weekday_label: string;
|
|
1984
|
+
day_type: string;
|
|
1985
|
+
day_type_code: OdDayType | (string & {});
|
|
1986
|
+
/** 放假(含一般週末);出勤與假日加班判定用這個 */
|
|
1987
|
+
is_day_off: boolean;
|
|
1988
|
+
is_weekend: boolean;
|
|
1989
|
+
/** 有名稱的放假日(國定假日、補假、調整放假);一般週末為 false */
|
|
1990
|
+
is_national_holiday: boolean;
|
|
1991
|
+
holiday_name: string | null;
|
|
1992
|
+
/** 補行上班日(週末但要上班) */
|
|
1993
|
+
is_makeup_workday: boolean;
|
|
1994
|
+
makeup_reason: string | null;
|
|
1995
|
+
/** 來源原文備註 */
|
|
1996
|
+
source_note: string | null;
|
|
1997
|
+
}
|
|
1998
|
+
interface OdCalendarHolidaysResult {
|
|
1999
|
+
from: string;
|
|
2000
|
+
to: string;
|
|
2001
|
+
days: OdCalendarDay[];
|
|
2002
|
+
count: number;
|
|
2003
|
+
summary: {
|
|
2004
|
+
day_off: number;
|
|
2005
|
+
national_holiday: number;
|
|
2006
|
+
makeup_workday: number;
|
|
2007
|
+
workday: number;
|
|
2008
|
+
};
|
|
2009
|
+
/** 期間內還沒有日曆資料的西元年(次年度通常前一年 6~7 月才公告) */
|
|
2010
|
+
missing_years: number[];
|
|
2011
|
+
sources: Array<{
|
|
2012
|
+
year: number;
|
|
2013
|
+
roc_year: number | null;
|
|
2014
|
+
description: string | null;
|
|
2015
|
+
synced_at: string | null;
|
|
2016
|
+
}>;
|
|
2017
|
+
message: string | null;
|
|
2018
|
+
notice: string;
|
|
2019
|
+
attribution: string;
|
|
2020
|
+
}
|
|
2021
|
+
interface AcademyOD {
|
|
2022
|
+
lvr: {
|
|
2023
|
+
/** 實價登錄逐筆成交(對應 MCP `search_lvr_deals`):city 必填,district、keyword、價格面積屋齡篩選、page、limit… */
|
|
2024
|
+
deals(q: OdQuery): Promise<OdResult>;
|
|
2025
|
+
/** 區域行情統計(`get_lvr_market_context`):樣本數、單價與總價中位數、p25/p75、逐月趨勢 */
|
|
2026
|
+
marketContext(q: OdQuery): Promise<OdResult>;
|
|
2027
|
+
/** 單筆成交的完整登錄內容(含建物、土地、車位明細);id 來自 `similar()` 的結果。查無時 `item` 為 null */
|
|
2028
|
+
deal(id: string): Promise<OdLvrDealResult>;
|
|
2029
|
+
/** 同一個行政區最近的買賣成交(附成交 id);不比對面積與屋齡,要條件相近的案例用 `nearby.comparables()` */
|
|
2030
|
+
similar(q: OdLvrSimilarQuery): Promise<OdLvrSimilarResult>;
|
|
2031
|
+
/** 符合條件的全部成交的摘要:完整筆數、平均總價與單價(平均值);沒帶日期查近 12 個月。不提供屋齡篩選 */
|
|
2032
|
+
summary(q: OdLvrSummaryQuery): Promise<OdLvrSummaryResult>;
|
|
2033
|
+
/** 各行政區的平均單價排行與前期漲跌幅;沒帶日期查近 12 個月 */
|
|
2034
|
+
statsByArea(q?: OdLvrStatsByAreaQuery): Promise<OdLvrStatsByAreaResult>;
|
|
2035
|
+
/** 逐月的平均單價與件數(由舊到新);`is_partial` 的月份件數偏少,不足以代表行情 */
|
|
2036
|
+
monthlyTrend(q: OdLvrMonthlyTrendQuery): Promise<OdLvrMonthlyTrendResult>;
|
|
2037
|
+
/** 行政區的租金行情:平均月租金與每坪月租(沒有車位拆算) */
|
|
2038
|
+
rentalStats(q: OdLvrRentalStatsQuery): Promise<OdLvrRentalStatsResult>;
|
|
2039
|
+
/** 各行政區逐月的成交件數與總金額(預先算好的彙總,不分交易標的);適合算成交量走勢 */
|
|
2040
|
+
monthlyByRegion(q: OdLvrMonthlyByRegionQuery): Promise<OdLvrMonthlyByRegionResult>;
|
|
2041
|
+
};
|
|
2042
|
+
nearby: {
|
|
2043
|
+
/** 座標或地址周邊近期成交(`get_nearby` 的成交);逐筆另附樓層、地坪、建築完成年月、車位類別、使用分區、備註 */
|
|
2044
|
+
deals(q: OdQuery): Promise<OdResult>;
|
|
2045
|
+
/** 周邊生活機能與嫌惡設施(`get_nearby`;include 可選 amenities、nimby) */
|
|
2046
|
+
amenities(q: OdQuery): Promise<OdResult>;
|
|
2047
|
+
/**
|
|
2048
|
+
* 同類型比較案例:指定建物型態與面積範圍,回周邊條件相近的買賣成交(最多 5 筆,無門牌)與符合條件的總筆數。
|
|
2049
|
+
* 必填 building_type(公寓、住宅大樓、華廈、透天厝、套房、辦公商業大樓、店面、工廠、廠辦,逗號可複選)、area_min、area_max(坪),
|
|
2050
|
+
* 位置給 address 或 lat+lng;radius 上限 1000 公尺、months 上限 36。
|
|
2051
|
+
*/
|
|
2052
|
+
comparables(q: OdQuery): Promise<OdResult>;
|
|
2053
|
+
};
|
|
2054
|
+
address: {
|
|
2055
|
+
/** 地址正規化、地址與座標互轉;帶 city+section+land_no 查地號位置(`convert_location`) */
|
|
2056
|
+
convert(q: OdQuery): Promise<OdResult>;
|
|
2057
|
+
/** 門牌建議:依已輸入的地址開頭給門牌候選(附座標)。未收錄縣市查不到不代表地址不存在,見回應的 covered_cities */
|
|
2058
|
+
suggest(q: OdAddressSuggestQuery): Promise<OdAddressSuggestResult>;
|
|
2059
|
+
/**
|
|
2060
|
+
* 地址查座標(2.6.0):先查官方門牌,查不到再查外部圖資(平台付費)。精度不是門牌時只適合顯示。
|
|
2061
|
+
* 請先用 `convert()`(只查官方門牌、不花平台費用),找不到再用這支;不要對同一個地址重複呼叫,查過的結果請自行保存。
|
|
2062
|
+
* 上游暫時失敗時丟 `DATA_UNAVAILABLE`(503,不扣點)。
|
|
2063
|
+
*/
|
|
2064
|
+
geocode(q: OdAddressGeocodeQuery): Promise<OdAddressGeocodeResult>;
|
|
2065
|
+
};
|
|
2066
|
+
area: {
|
|
2067
|
+
/** 人口、年齡結構、所得、全國新承做購屋貸款利率與核貸成數(`get_area_profile`) */
|
|
2068
|
+
profile(q: OdQuery): Promise<OdResult>;
|
|
2069
|
+
/** 區域統計歷史序列(由舊到新):人口(月)、所得(年,民國年)、鄉鎮市區人口密度(年)、全國房貸利率(月) */
|
|
2070
|
+
series(q: OdAreaSeriesQuery): Promise<OdAreaSeriesResult>;
|
|
2071
|
+
};
|
|
2072
|
+
/** 社區。名單不完整(老社區可能缺席),請當成建議而不是封閉選單;價格是預售成交歷史(萬元/坪),可能沒有 */
|
|
2073
|
+
communities: {
|
|
2074
|
+
/** 名稱自動完成:關鍵字比對名稱任一段,開頭相符的排前面 */
|
|
2075
|
+
suggest(q: OdCommunitySuggestQuery): Promise<OdCommunityListResult>;
|
|
2076
|
+
/** 名稱四級比對(完全相同→別名→開頭相符→模糊)。`reliable` 為 false(模糊比對)的結果不可當成正解 */
|
|
2077
|
+
match(q: OdCommunityMatchQuery): Promise<OdCommunityMatchResult>;
|
|
2078
|
+
/** 位置周邊的社區,由近到遠,附 distance_m(公尺) */
|
|
2079
|
+
nearby(q: OdCommunityNearbyQuery): Promise<OdCommunityListResult & {
|
|
2080
|
+
center: OdCenter;
|
|
2081
|
+
radius_m: number;
|
|
2082
|
+
}>;
|
|
2083
|
+
/** 矩形範圍(地圖視窗)內的社區,成交筆數多的排前面;`truncated` 為 true 表示達到筆數上限 */
|
|
2084
|
+
inBounds(q: OdCommunityInBoundsQuery): Promise<OdCommunityListResult & {
|
|
2085
|
+
truncated: boolean;
|
|
2086
|
+
}>;
|
|
2087
|
+
/** 一個行政區的社區名稱與別名(不含價格與座標) */
|
|
2088
|
+
byArea(q: OdCommunityByAreaQuery): Promise<OdCommunityByAreaResult>;
|
|
2089
|
+
/** 單一社區詳情(id 來自其他社區方法的結果);查無時 `item` 為 null */
|
|
2090
|
+
get(id: number): Promise<OdCommunityDetailResult>;
|
|
2091
|
+
};
|
|
2092
|
+
/** 學校。🔴 資料是**學校校地位置,不是學區劃分**:不能用來判斷某個地址讀哪一所學校,回應的 `disclaimer` 請顯示給使用者 */
|
|
2093
|
+
schools: {
|
|
2094
|
+
/** 位置附近的學校:落在校地內回該校,否則回 2 公里內最近的 5 所 */
|
|
2095
|
+
nearby(q: OdSchoolsNearbyQuery): Promise<OdSchoolsNearbyResult>;
|
|
2096
|
+
/** 以校名關鍵字找學校(最多 50 所) */
|
|
2097
|
+
search(q: OdSchoolsSearchQuery): Promise<OdSchoolsSearchResult>;
|
|
2098
|
+
/** 一次查多個座標(最多 20 個,整次算一次查詢)是否**落在校地內**;不會找附近的學校 */
|
|
2099
|
+
nearbyBatch(points: OdPoint[]): Promise<OdSchoolsNearbyBatchResult>;
|
|
2100
|
+
};
|
|
2101
|
+
population: {
|
|
2102
|
+
/** 位置所在村里最新一期的人口;`elder_pct` 是老年人口占比,不是老化指數 */
|
|
2103
|
+
village(q: OdLocation): Promise<OdPopulationVillageResult>;
|
|
2104
|
+
};
|
|
2105
|
+
stats: {
|
|
2106
|
+
/** 以村里代碼批次查官方統計(人口、所得、所屬鄉鎮市區人口密度),同時回整批加總與逐村里明細 */
|
|
2107
|
+
villages(q: OdStatsVillagesQuery): Promise<OdStatsVillagesResult>;
|
|
2108
|
+
/** 消費者物價總指數(稅務專用)。🔴 基期逐月改變(`base_period`=最新月份=100),請一併保存 base_period */
|
|
2109
|
+
cpi(q?: OdStatsCpiQuery): Promise<OdStatsCpiResult>;
|
|
2110
|
+
/** 房市市場指標序列(由舊到新):移轉棟數、建照、房貸餘額與利率、住宅價格指數等 16 項,代碼見 `OdMarketIndicator` */
|
|
2111
|
+
market(q: OdStatsMarketQuery): Promise<OdStatsMarketResult>;
|
|
2112
|
+
};
|
|
2113
|
+
/** 五類災害潛勢並附土地使用分區 zoning(`get_property_risk`);查無不等於無風險、查不到分區不等於沒有使用限制 */
|
|
2114
|
+
hazards(q: OdQuery): Promise<OdResult>;
|
|
2115
|
+
/** 市場快訊日報/週報/月報(`get_market_brief`);`marketBriefs.list()` 列出已產出的期別 */
|
|
2116
|
+
marketBriefs: ((q?: OdQuery) => Promise<OdResult>) & {
|
|
2117
|
+
/** 已產出的市場快訊期別清單(新到舊);內容用 `marketBriefs({ period_type, period_key })` 查 */
|
|
2118
|
+
list(q?: OdPeriodListQuery): Promise<OdReportListResult>;
|
|
2119
|
+
};
|
|
2120
|
+
/**
|
|
2121
|
+
* 政策公告與媒體報導。🔴 依各來源授權裁切:政府資料全給;媒體只有標題與來源摘要(summary)或只有標題、機關、日期、連結(title_only)。
|
|
2122
|
+
* `content_withheld` 為 true 時請引導使用者點原文連結,不要自行補寫內容
|
|
2123
|
+
*/
|
|
2124
|
+
bulletins: {
|
|
2125
|
+
/** 清單(發布時間新到舊,不含全文) */
|
|
2126
|
+
list(q?: OdBulletinsListQuery): Promise<OdBulletinsListResult>;
|
|
2127
|
+
/** 單則;政府公告附內文(≤ 6,000 字)與附件清單。查無時 `item` 為 null */
|
|
2128
|
+
get(id: number): Promise<OdBulletinDetailResult>;
|
|
2129
|
+
/** 附件(PDF)逐頁原文;只有政府公告有,媒體一律不提供 */
|
|
2130
|
+
documents(id: number, q?: OdBulletinDocumentsQuery): Promise<OdBulletinDocumentsResult>;
|
|
2131
|
+
};
|
|
2132
|
+
/** 期別結構化摘要(程式整理的事實,沒有 AI 判斷):本期公告分類、重點條目、新發布指標與比較、法規異動、來源覆蓋 */
|
|
2133
|
+
briefs: {
|
|
2134
|
+
/** 最新一期;還沒產出時 `available` 為 false(照常扣點) */
|
|
2135
|
+
latest(q?: OdPeriodViewQuery): Promise<OdBriefResult>;
|
|
2136
|
+
/** 指定期別(與版本) */
|
|
2137
|
+
get(q: OdPeriodGetQuery): Promise<OdBriefResult>;
|
|
2138
|
+
/** 已產出的期別清單 */
|
|
2139
|
+
list(q?: OdPeriodListQuery): Promise<OdBriefListResult>;
|
|
2140
|
+
/** 最新一期各視角的來源取得狀況(平台資料狀況,不是公告內容;一般使用者畫面不需要顯示) */
|
|
2141
|
+
coverage(q?: {
|
|
2142
|
+
period_type?: OdPeriodType;
|
|
2143
|
+
}): Promise<OdBriefCoverageResult>;
|
|
2144
|
+
};
|
|
2145
|
+
/** 新聞分析報告(AI 整理,不是價格預測;`ai_notice` 請原文顯示) */
|
|
2146
|
+
newsReports: {
|
|
2147
|
+
latest(q?: OdPeriodViewQuery): Promise<OdNewsReportResult>;
|
|
2148
|
+
get(q: OdPeriodGetQuery): Promise<OdNewsReportResult>;
|
|
2149
|
+
list(q?: OdPeriodListQuery): Promise<OdReportListResult>;
|
|
2150
|
+
/** 進行中的議題與時間軸 */
|
|
2151
|
+
topics(q?: OdNewsTopicsQuery): Promise<OdNewsTopicsResult>;
|
|
2152
|
+
};
|
|
2153
|
+
tax: {
|
|
2154
|
+
/** 縣市「非自住住家用房屋」的房屋稅率級距(囤房稅 2.0,依全國歸戶戶數);只有這一類,查無不得以他縣市替代 */
|
|
2155
|
+
houseRates(q: {
|
|
2156
|
+
city: string;
|
|
2157
|
+
}): Promise<OdResult>;
|
|
2158
|
+
};
|
|
2159
|
+
judgments: {
|
|
2160
|
+
/**
|
|
2161
|
+
* 搜尋不動產相關判決(去識別化版本):q(關鍵字)或 dispute_type 至少一項,可加 case_category(民事/行政/刑事)、
|
|
2162
|
+
* city(審理法院所在縣市,不是不動產所在地)、date_from、date_to、final_only、page、limit(上限 20)。翻頁每頁各扣一次。
|
|
2163
|
+
*/
|
|
2164
|
+
search(q: OdQuery): Promise<OdResult>;
|
|
2165
|
+
/** 單筆判決的去識別化全文與上下級審(id 來自 search 的結果);超過 6,000 字會截斷並標明原長度 */
|
|
2166
|
+
get(id: number): Promise<OdResult>;
|
|
2167
|
+
/**
|
|
2168
|
+
* 搜尋可用的代碼表(案件類別、糾紛類型、定讞狀態、法院)與目前收錄的資料範圍(起訖日、筆數、
|
|
2169
|
+
* 去識別化未通過而不提供的筆數);做搜尋表單的下拉選單用。
|
|
2170
|
+
*/
|
|
2171
|
+
meta(): Promise<OdResult>;
|
|
2172
|
+
};
|
|
2173
|
+
/** 空間查詢(2.4.0):多邊形給 `[緯度, 經度]` 陣列或 `{ lat, lng }` 陣列,整次算一次查詢 */
|
|
2174
|
+
spatial: {
|
|
2175
|
+
/** 多邊形內指定期間的實價登錄統計(預設買賣、房地、近 12 個月) */
|
|
2176
|
+
lvrSummary(q: OdSpatialLvrSummaryQuery): Promise<OdSpatialLvrSummaryResult>;
|
|
2177
|
+
/** 多邊形內指定期間核准設立的公司家數與資本額(萬元),可附明細 */
|
|
2178
|
+
companies(q: OdSpatialCompaniesQuery): Promise<OdSpatialCompaniesResult>;
|
|
2179
|
+
/** 多邊形涵蓋的村里(或鄉鎮市區、縣市):代表點落在範圍內才算 */
|
|
2180
|
+
villages(q: {
|
|
2181
|
+
polygon: OdPolygon;
|
|
2182
|
+
level?: OdAdminLevel;
|
|
2183
|
+
}): Promise<OdSpatialVillagesResult>;
|
|
2184
|
+
/** 村里代碼(最多 300 個)→ 連成一片的範圍多邊形;沒連成一片時丟 `INVALID_REQUEST`,`err.message` 是給使用者的修正指引,請原樣顯示 */
|
|
2185
|
+
villageGeometry(q: {
|
|
2186
|
+
codes: string[];
|
|
2187
|
+
max_vertices?: number;
|
|
2188
|
+
}): Promise<OdSpatialVillageGeometryResult>;
|
|
2189
|
+
/** 地圖範圍內的行政區界線 GeoJSON(範圍上限:村里 1、鄉鎮市區 4、縣市 25 平方度) */
|
|
2190
|
+
boundaries(q: OdBbox & {
|
|
2191
|
+
level?: OdAdminLevel;
|
|
2192
|
+
}): Promise<OdFeatureCollection<OdBoundaryProperties> & {
|
|
2193
|
+
level: string;
|
|
2194
|
+
level_code: OdAdminLevel;
|
|
2195
|
+
}>;
|
|
2196
|
+
/** 🔴 行政區名稱或代碼 → **地圖鏡頭定位**(代表點+外接矩形),不是資料篩選;名稱對到不只一個時回 ambiguous,不會猜 */
|
|
2197
|
+
lookup(q: OdBoundaryLookupQuery): Promise<OdBoundaryLookupResult>;
|
|
2198
|
+
};
|
|
2199
|
+
/** 土地使用分區(2.4.0;單點請用 `hazards()` 回應的 zoning)。🔴 都市計畫分區只有臺北、新北、高雄,查不到不代表沒有使用限制 */
|
|
2200
|
+
zoning: {
|
|
2201
|
+
/** 一次查多個座標(最多 20 個,整次算一次查詢) */
|
|
2202
|
+
batch(points: OdPoint[]): Promise<OdZoningBatchResult>;
|
|
2203
|
+
/** 非都市土地分區的官方 WMTS 圖磚設定 */
|
|
2204
|
+
tiles(): Promise<OdTilesResult>;
|
|
2205
|
+
/** 地圖範圍內的分區多邊形 GeoJSON(zoom ≥ 13、範圍 ≤ 0.01 平方度) */
|
|
2206
|
+
geojson(q: OdBbox & {
|
|
2207
|
+
layer?: 'zone' | 'land_use';
|
|
2208
|
+
}): Promise<OdFeatureCollection<OdZoningFeatureProperties> & {
|
|
2209
|
+
layer: string;
|
|
2210
|
+
notice: string;
|
|
2211
|
+
disclaimer: string;
|
|
2212
|
+
}>;
|
|
2213
|
+
};
|
|
2214
|
+
/** 地籍(2.4.0;地號定位請用 `address.convert()`)。只回位置、面積、地段地號,沒有任何權屬資料 */
|
|
2215
|
+
cadastre: {
|
|
2216
|
+
/** 地段清單與段名搜尋(至少給 city、district、keyword 其中一項) */
|
|
2217
|
+
sections(q: OdCadastreSectionsQuery): Promise<OdCadastreSectionsResult>;
|
|
2218
|
+
/** 座標(或完整門牌)→ 縣市、鄉鎮、村里與地段;即時查國土測繪中心,忙碌時丟 `DATA_UNAVAILABLE`(不扣點) */
|
|
2219
|
+
reversePoint(q: OdLocation): Promise<OdCadastreReversePointResult>;
|
|
2220
|
+
/** 地段代碼+地號 → 宗地位置、面積與形狀。⚠️ 只讀平台已累積的資料,多數地號回 `available: false` */
|
|
2221
|
+
landInfo(q: {
|
|
2222
|
+
section_code: string;
|
|
2223
|
+
land_no: string;
|
|
2224
|
+
}): Promise<OdCadastreLandInfoResult>;
|
|
2225
|
+
/** 已同步縣市宗地資料的縣市(這些縣市以地號定位最快、附宗地形狀) */
|
|
2226
|
+
locateSources(): Promise<{
|
|
2227
|
+
counties: Array<{
|
|
2228
|
+
city: string;
|
|
2229
|
+
source: string | null;
|
|
2230
|
+
synced_at: string | null;
|
|
2231
|
+
}>;
|
|
2232
|
+
count: number;
|
|
2233
|
+
notice: string;
|
|
2234
|
+
attribution: string;
|
|
2235
|
+
}>;
|
|
2236
|
+
/** 國土測繪中心底圖與地段界線的 WMTS 圖磚設定(含地號的地籍圖需授權,只列在 unavailable) */
|
|
2237
|
+
tiles(): Promise<OdTilesResult & {
|
|
2238
|
+
default_layer: string | null;
|
|
2239
|
+
}>;
|
|
2240
|
+
};
|
|
2241
|
+
/** 地圖圖層(2.4.0):熱力點、災害潛勢面、POI 點位、面量圖。熱力與 POI 要 zoom ≥ 10、範圍 ≤ 1 平方度 */
|
|
2242
|
+
layers: {
|
|
2243
|
+
heat: {
|
|
2244
|
+
/** 實價登錄成交點(權重:單價、總價或密度) */
|
|
2245
|
+
deals(q: OdHeatDealsQuery): Promise<OdHeatResult & {
|
|
2246
|
+
notice: string;
|
|
2247
|
+
}>;
|
|
2248
|
+
/** 生活機能等 POI 點位(密度) */
|
|
2249
|
+
amenities(q: OdHeatTypesQuery): Promise<OdHeatResult & {
|
|
2250
|
+
types: string[];
|
|
2251
|
+
type_codes: string[];
|
|
2252
|
+
}>;
|
|
2253
|
+
/** 交通站點(密度) */
|
|
2254
|
+
transport(q: OdHeatTypesQuery): Promise<OdHeatResult & {
|
|
2255
|
+
types: string[];
|
|
2256
|
+
type_codes: string[];
|
|
2257
|
+
}>;
|
|
2258
|
+
/** 村里人口密度或人數(每村里一點) */
|
|
2259
|
+
population(q: OdBbox & {
|
|
2260
|
+
mode?: 'density_km' | 'count';
|
|
2261
|
+
city?: string;
|
|
2262
|
+
year_month?: string;
|
|
2263
|
+
}): Promise<OdHeatResult & {
|
|
2264
|
+
notice: string;
|
|
2265
|
+
}>;
|
|
2266
|
+
/** 災害潛勢代表點(權重:風險等級 1~4) */
|
|
2267
|
+
hazards(q: OdBbox & {
|
|
2268
|
+
type?: OdHazardType;
|
|
2269
|
+
}): Promise<OdHeatResult & {
|
|
2270
|
+
hazard: string;
|
|
2271
|
+
hazard_code: OdHazardType;
|
|
2272
|
+
notice: string;
|
|
2273
|
+
disclaimer: string;
|
|
2274
|
+
}>;
|
|
2275
|
+
};
|
|
2276
|
+
/** 災害潛勢面 GeoJSON(最多 3,000 個面);查無不等於沒有風險 */
|
|
2277
|
+
hazardZones(q: OdBbox & {
|
|
2278
|
+
types?: OdHazardType[];
|
|
2279
|
+
limit?: number;
|
|
2280
|
+
}): Promise<OdFeatureCollection<{
|
|
2281
|
+
id: number | null;
|
|
2282
|
+
hazard: string | null;
|
|
2283
|
+
hazard_code: OdHazardType | null;
|
|
2284
|
+
risk_level: string | null;
|
|
2285
|
+
name: string | null;
|
|
2286
|
+
}> & {
|
|
2287
|
+
types: string[];
|
|
2288
|
+
upstream_disclaimers: string[];
|
|
2289
|
+
disclaimer: string;
|
|
2290
|
+
}>;
|
|
2291
|
+
/** 地圖 marker 用的 POI 點位(含名稱、地址;最多 1,500 點) */
|
|
2292
|
+
poi(q: OdHeatTypesQuery & {
|
|
2293
|
+
limit?: number;
|
|
2294
|
+
}): Promise<OdPoiPointsResult>;
|
|
2295
|
+
/** 區域體質面量圖 GeoJSON(zoom ≥ 8;口徑同 `area.profile()`)。value 是中性數值,請用單色系色階 */
|
|
2296
|
+
choropleth(q: OdBbox & {
|
|
2297
|
+
metric?: OdChoroplethMetric;
|
|
2298
|
+
}): Promise<OdChoroplethResult>;
|
|
2299
|
+
};
|
|
2300
|
+
/**
|
|
2301
|
+
* 同業裁罰(2.5.0)。同業名冊查詢(`search()`)因含未遮罩的自然人姓名,2.6.0 起不提供。
|
|
2302
|
+
* 🔴 受處分人已由來源遮罩,仍只能用於查核同業等正當目的,不得蒐集、建檔或另作行銷使用
|
|
2303
|
+
*/
|
|
2304
|
+
licenses: {
|
|
2305
|
+
/** 臺中市不動產經紀業裁罰名單(新到舊;受處分人由來源遮罩) */
|
|
2306
|
+
penalties(q?: {
|
|
2307
|
+
q?: string;
|
|
2308
|
+
page?: number;
|
|
2309
|
+
page_size?: number;
|
|
2310
|
+
}): Promise<OdLicensePenaltiesResult>;
|
|
2311
|
+
};
|
|
2312
|
+
/** 經濟部登記工廠名錄(2.5.0) */
|
|
2313
|
+
factories: {
|
|
2314
|
+
/** 半徑內的登記工廠(嫌惡設施參考,最多 100 家);查無不代表附近沒有工廠,請看 coverage */
|
|
2315
|
+
nearby(q: OdFactoriesNearbyQuery): Promise<OdFactoriesNearbyResult>;
|
|
2316
|
+
/** 以統編、名稱或縣市查名錄(沒有座標的工廠一樣查得到) */
|
|
2317
|
+
search(q?: OdFactoriesSearchQuery): Promise<OdFactoriesSearchResult>;
|
|
2318
|
+
};
|
|
2319
|
+
/** 政府行政機關辦公日曆(2.5.0) */
|
|
2320
|
+
calendar: {
|
|
2321
|
+
/** 期間(最長 366 天,含頭尾)內每一天是上班日、週末、放假日或補行上班日 */
|
|
2322
|
+
holidays(q: {
|
|
2323
|
+
from: string;
|
|
2324
|
+
to: string;
|
|
2325
|
+
}): Promise<OdCalendarHolidaysResult>;
|
|
2326
|
+
};
|
|
2327
|
+
/** 直接以資源路徑查詢(新資源上線、SDK 還沒加方法時用) */
|
|
2328
|
+
get(resource: string, q?: OdQuery): Promise<OdResult>;
|
|
2329
|
+
}
|
|
2330
|
+
|
|
2331
|
+
export type { OdFactory as $, AcademyAI as A, OdCadastreSectionsQuery as B, OdCadastreSectionsResult as C, OdCalendarDay as D, OdCalendarHolidaysResult as E, OdCenter as F, OdChoroplethMetric as G, OdChoroplethResult as H, OdCommunity as I, OdCommunityByAreaQuery as J, OdCommunityByAreaResult as K, OdCommunityDetail as L, OdCommunityDetailResult as M, OdCommunityInBoundsQuery as N, OdAddressGeocodeQuery as O, OdCommunityListResult as P, OdCommunityMatchItem as Q, OdCommunityMatchQuery as R, OdCommunityMatchResult as S, OdCommunityNearbyQuery as T, OdCommunityPrice as U, OdCommunitySuggestQuery as V, OdDayType as W, OdFactoriesNearbyQuery as X, OdFactoriesNearbyResult as Y, OdFactoriesSearchQuery as Z, OdFactoriesSearchResult as _, AcademyOD as a, OdSpatialCompaniesQuery as a$, OdFactoryCoverage as a0, OdFeature as a1, OdFeatureCollection as a2, OdGeocodePrecision as a3, OdGeocodeSource as a4, OdGeocodeStatus as a5, OdGeometry as a6, OdHazardType as a7, OdHeatDealsQuery as a8, OdHeatResult as a9, OdNewsTopicsQuery as aA, OdNewsTopicsResult as aB, OdNoticeBase as aC, OdPeriodGetQuery as aD, OdPeriodListQuery as aE, OdPeriodType as aF, OdPeriodViewQuery as aG, OdPoiPointsResult as aH, OdPoiType as aI, OdPoint as aJ, OdPolygon as aK, OdPopulationVillageResult as aL, OdPublicFact as aM, OdPublicSource as aN, OdQuery as aO, OdReportEvent as aP, OdReportListResult as aQ, OdReportQuote as aR, OdResult as aS, OdSchool as aT, OdSchoolLevel as aU, OdSchoolsNearbyBatchResult as aV, OdSchoolsNearbyQuery as aW, OdSchoolsNearbyResult as aX, OdSchoolsSearchQuery as aY, OdSchoolsSearchResult as aZ, OdSeries as a_, OdHeatTypesQuery as aa, OdIndicatorComparison as ab, OdLicensePenaltiesResult as ac, OdLicensePenalty as ad, OdLocation as ae, OdLvrBase as af, OdLvrDeal as ag, OdLvrDealMoney as ah, OdLvrDealResult as ai, OdLvrMonthlyByRegionQuery as aj, OdLvrMonthlyByRegionResult as ak, OdLvrMonthlyTrendQuery as al, OdLvrMonthlyTrendResult as am, OdLvrRentalStatsQuery as an, OdLvrRentalStatsResult as ao, OdLvrSimilarItem as ap, OdLvrSimilarQuery as aq, OdLvrSimilarResult as ar, OdLvrStatsByAreaQuery as as, OdLvrStatsByAreaResult as at, OdLvrSummaryQuery as au, OdLvrSummaryResult as av, OdLvrTarget as aw, OdLvrTransactionType as ax, OdMarketIndicator as ay, OdNewsReportResult as az, OdAddressGeocodeResult as b, OdSpatialCompaniesResult as b0, OdSpatialLvrSummaryQuery as b1, OdSpatialLvrSummaryResult as b2, OdSpatialVillageGeometryResult as b3, OdSpatialVillagesResult as b4, OdStatsCpiQuery as b5, OdStatsCpiResult as b6, OdStatsMarketQuery as b7, OdStatsMarketResult as b8, OdStatsVillagesQuery as b9, OdStatsVillagesResult as ba, OdTileLayer as bb, OdTilesResult as bc, OdUsagePolicy as bd, OdVillageStatsItem as be, OdZoning as bf, OdZoningBatchResult as bg, OdZoningFeatureProperties as bh, OdZoningLayer as bi, OdAddressSuggestQuery as c, OdAddressSuggestResult as d, OdAdminLevel as e, OdAreaSeriesItem as f, OdAreaSeriesQuery as g, OdAreaSeriesResult as h, OdBbox as i, OdBoundaryLookupQuery as j, OdBoundaryLookupResult as k, OdBoundaryProperties as l, OdBriefCoverageResult as m, OdBriefIndicator as n, OdBriefListResult as o, OdBriefResult as p, OdBulletin as q, OdBulletinDetail as r, OdBulletinDetailResult as s, OdBulletinDocumentsQuery as t, OdBulletinDocumentsResult as u, OdBulletinsListQuery as v, OdBulletinsListResult as w, OdCadastreLandInfoResult as x, OdCadastreReversePointResult as y, OdCadastreSection as z };
|