統計地圖API參考手冊

 統計地圖API參考手冊

請點擊上方下載說明文件按鈕,下載完整統計地圖API參考手冊。

DataDB Class

Constructor
DataDB(Array<DBDataSet/MultiDataSet> dataSet, DataOption option, CoordSystem coordinate, AreaSelect select) 統計地圖API應用資料庫資料集物件

參數說明:
dataSet: 以陣列方式設定來源統計資料,若欲繪製之統計地圖/圖表為單變數類型如面量圖、分級符號圖,則僅須填入單一統計資料
options: 來源統計資料設定
coordinate: 坐標系統設定
select: 資料篩選設定
Methods
setDataset(Array<DBdataset dataset>) 設定來源統計資料
getDataset( ) 取得來源統計資料(回傳值:Array<Dbdataset dataset>)
setCoordSystem(CoordSystem coordinate) 設定坐標系統
getCoordSystem( ) 取得坐標系統設定值(回傳值:CoordSystem coordinate)
setAreaSelect(AreaSelect select) 設定資料篩選條件
getAreaSelect( ) 取得資料篩選條件(回傳值:AreaSelect select)
setDataOption(DataOption option) 設定來源統計資料設定
getDataOption( ) 取得來源統計資料設定(回傳值:DataOption option)

 

DBDataSet

Properties
string tableName 統計表名稱(必填)
Array<string> fieldsID 欄位名稱(必填)

 

MultiDataSet

Properties
string tableName 統計表名稱(必填)
Array<string> fieldsID 欄位名稱(必填)
string to 設定統計資料代碼名稱(必填)
string time 統計資料時間代碼(必填)

DataOwn Class

Constructor
DataOwn(Array<DBDataSet> dataSet ,DataOption option, CoordSystem coordinate, AreaSelect select) 自有統計資料集物件

參數說明:
dataSet: 以陣列方式設定來源統計資料,若欲繪製之統計地圖/圖表為單變數類型如面量圖、分級符號圖,則僅須填入單一統計資料
options: 來源統計資料設定
coordinate: 坐標系統設定
select: 資料篩選設定

 

Methods
setDataset(Array<DBdataset dataset>) 設定來源統計資料
getDataset( ) 取得來源統計資料(回傳值:Array<Dbdataset dataset>)
setCoordSystem(CoordSystem coordinate) 設定坐標系統
getCoordSystem( ) 取得坐標系統設定值(回傳值:CoordSystem coordinate)
setAreaSelect(AreaSelect select) 設定資料篩選條件
getAreaSelect( ) 取得資料篩選條件(回傳值:AreaSelect select)
setDataOption(DataOption option) 設定來源統計資料設定
getDataOption( ) 取得來源統計資料設定(回傳值:DataOption option)

 

OwnDataSet

Properties
string tableSrc

統計表來源,填入自備統計資料之URL(必填)

支援資料類型:符合格式之XML與GeoJSON

GeoJSON僅支援點(point)與多邊形(polygon、multipolygon)幾何資料

Array<string> fieldsID 填入使用欄位ID(必填)

 

StatMap Class

Constructor
StatMap(object containerObj, [DataDB/DataOwn] dataobj, string mapKind, MapOptions mapOpts) 繪製統計地圖物件

參數說明:
containerObj: 若須輸出互動式地圖介面,則填入該網頁物件容器之DIV ID,不須輸出則填入'null'
dataObj: 統計資料來源設定,可使用「統計地圖API應用資料庫資料集物件(DataDB)」或「自有統計資料集物件(DataOwn)」
MapKind: 統計地圖類型設定,以字串方式填入指定類型
    面量圖:CHOROPLETH
    柱狀圖:BAR
    圓餅圖:PIE
    分級符號圖:SYMBOL
mapOpts: 統計地圖參數設定

 

Methods
drawMap(Function callback(StatMapResult result)) 繪製統計地圖。Function callback內包含統計地圖繪製結果(StatMapResult result)
appendLayer(StatLayer statLayer , Function callback(StatMapResult result)) 繪製疊加統計地圖圖層。指定疊加圖層物件StatLayer後,由Function callback中取出統計地圖繪製結果(StatMapResult result)
removeLayer(StatLayer statLayer) 指定疊加圖層物件StatLayer後由互動式介面中移除疊加統計地圖圖層。
freezeMap() 凍結互動式地圖圖台視窗
unfreezeMap() 解凍互動式地圖圖台視窗
calcClassify(choroplethSets pChoropleth, Function callback(CalcResult result)) 計算面量圖分級
setContainer(object containerObj) 設定互動式地圖介面之網頁物件容器DIV ID
getContainer( ) 取得互動式地圖介面之網頁物件容器DIV ID
setContainerLegend(object containerLegend) 設定互動式圖例之網頁物件容器DIV ID
getContainerLegend( ) 取得互動式圖例之網頁物件容器DIV ID
setContainerData(object containerData) 設定互動式資料清單之網頁物件容器DIV ID
getContainerData( ) 取得互動式資料清單之網頁物件容器DIV ID
setContainerMix(object containerMix) 設定混合型資料(機構別)圖形之網頁物件容器DIV ID
getContainerMix() 取得混合型資料(機構別)圖形之網頁物件容器DIV ID
setColor(string/array ) 設定向量式圖磚動態配色資訊,輸入dynamicColor物件中設定之色系名稱或是顏色陣列(需配合匯出向量試圖磚設定使用)
setStatData([DataDB/DataOwn] dataobj) 設定統計資料來源
getStatData( ) 取得統計資料來源(回傳值:[DataDB/DataOwn] dataobj)
setMapKind(string mapKind) 設定統計地圖類型
getMapKind( ) 取得統計地圖類型(回傳值:string mapKind)
setMapOptions(MapOptions mapOpts) 設定統計地圖參數
getMapOptions( ) 取得統計地圖參數(回傳值:MapOptions mapOpts)

StatLayer

Constructor
StatLayer([DataDB/DataOwn] dataobj, string mapKind, MapOptions mapOpts) 統計地圖疊加圖層物件

參數說明:
dataObj: 統計資料來源設定,可使用「統計地圖API應用資料庫資料集物件((DataDB)」或「自有統計資料集物件(DataOwn)」
MapKind: 統計地圖類型設定,以字串方式填入指定類型
    面量圖:CHOROPLETH
    柱狀圖:BAR
    圓餅圖:PIE
    分級符號圖:SYMBOL
mapOpts: 統計地圖參數設定

 

Methods
setStatData([DataDB/DataOwn] dataobj) 設定統計資料來源
getStatData( ) 取得統計資料來源(回傳值:[DataDB/DataOwn] dataobj)
setMapKind(string mapKind) 設定統計地圖類型
getMapKind( ) 取得統計地圖類型(回傳值:string mapKind)
setMapOptions(MapOptions mapOpts) 設定統計地圖參數
getMapOptions( ) 取得統計地圖參數(回傳值:MapOptions mapOpts)

 

MapOptions

Properties
boolean drillDown 是否開啟資料下探功能,預設為false。
開啟此參數後,DataLevel表初始呈現資料層級。
boolean quickDraw 是否使用暫存資料集繪製地圖,預設為false
boolean exportImage 是否輸出純影像統計地圖,預設為false
BaseLevel baseLevel 互動式統計地圖預設底圖層級,預設為縣市層級
縣市: COUNTY
鄉鎮市區: TOWN
村里: VILLAGE
Envelope envelope 以地理坐標限制純影像統計地圖之輸出地理邊界,預設為不設定,以統計資料範圍為輸出地理邊界。
boolean useBasemap 輸出之統計地圖影像是否包含行政區底圖,預設為true
string baseType 設定純影像輸出底圖類型,預設為基本行政區界底圖
統計區地圖:STATMAP
基本行政區界底圖:BASIC
boolean exportStatData 是否輸出statData,預設為true
boolean exportStatInfo 是否輸出statInfo,預設為true
boolean exportLegend 是否輸出各式legend,預設為true
InfoOptions infoOpts 互動式訊息視窗客製化參數集合
ImageSize size 統計地圖影像尺寸設定
number opacity 統計地圖透明度設定,可填入0~1之間的小數,預設為不透明(1)
boolean exportKML 統計地圖是否輸出KML格式檔案,預設為false
boolean exportVectorTile 匯出向量式圖磚結果,預設為false
boolean closeMapObj 隱藏所有互動式圖台元件,預設為false
boolean autoZoom 互動式介面關閉自動縮放效果,預設為false。
choroplethSets pChoropleth 面量圖參數設定集合
barSets pBar 柱狀圖參數設定集合
pieSets pPie 圓餅圖參數設定集合
symbolSets pSymbol 分級符號圖參數設定集合

InfoOptions

Properties
string activateMode 互動式效果觸發模式,預設為滑鼠移動即觸發(MOUSEMOVE)
滑鼠移動:MOUSEMOVE
滑鼠經過:MOUSEOVER
滑鼠點擊:CLICK
滑鼠雙擊:DBLCLICK
string infoColor 互動訊息視窗背景色,,格式為16進位RGB(#RRGGBB),預設為白色(#FFFFFF)
number opacity 透明度設定,可填入0~1之間的小數,預設為不透明(1)

 

ChoroplethSets

Properties
string classifyMethod 分級方法,預設為等距法:
等距法: EQUALINTERVAL
去除前後5%資料等距法:EQUALINTERVA5
等量法: QUANTILE
自訂間距: USER_DEFINED 
(自訂間距值設定請參照userLevels)
int classes 使用系統提供分級法之分級數設定。可填入整數2~10,未填入之預設值為5。
array userLevels 自訂統計分級區間設定,由小至大依序於陣列內輸入分級區間值(包括最小及最大值)
例:輸入[100, 300, 700, 900]表示分為三級,第一級為100~300;第二級為300~700;第三級為700~900
ValueSelect valueSelect 統計值篩選設定,非必填,預設為不篩選
不篩選: DEFAULT
所有統計值由大至小排序後取前十筆統計資料: TOP_TEN
所有統計值由大至小排序後取最後十筆統計資料: LAST_TEN
string statTime 繪製時序性面量圖時使用,填入欲作為分級標準之統計時間點,若未填則以資料集中最後一個時間點作為分級標準(可判別的時間格式)
boolean KMLwithZ 輸出之KML檔案是否附帶Z值,以在三維圖台呈現立體效果,預設為false
[ColorSettings/Array<string [#RRGGBB]> color 統計圖配色設定,可由物件ColorSettings取得或是自訂區間配色,若兩者皆未設定則以紅色漸層進行配色。

若使用自訂配色設定,以陣列方式輸入16進位RGB (#RRGGBB)格式之配色集合,輸出之面量圖將依照配色集依序填入各個分級區間。未設定之分級項則由系統自動進行配色。
object dynamicColor 動態調整面量圖向量磚配色設定
LabelSettings label 文字標記設定,由物件LabelSettings取得,若未設定則不進行文字標記
boolean useInt 是否使用整數進行統計計算及展示(非必填,預設使用資料庫對統計欄位是否為整數的定義進行設定,也可自行定義本屬性)

ColorSettings

Properties
string maxColor 統計最大值色彩,格式為16進位RGB(#RRGGBB),預設為深紅色(#4A1010)
string minColor 統計最小值色彩,格式為16進位RGB(#RRGGBB),預設為淺灰色(#D4D4D4)
string defaultColor 預設色彩,於統計值為NULL時顯示,格式為16進位RGB(#RRGGBB),預設為白色(#FFFFFF)

 

LabelSettings

Properties
string contentType 文字標記內容,預設為ALL
行政區/統計區名稱:NAME
行政區/統計區全名:FULLNAME
統計值:VALUE
名稱 + 統計值:ALL
string LocateType 文字標記定位方式,預設為GRAVITY
特定位置(與分級符號位置相同):SPECIFY
行政區重心位置:GRAVITY

當使用SPECIFY設定後,將無法控制文字是否重疊。
string weight 文字字體設定,預設為NORMAL
正常:NORMAL
粗體:BOLD
number labelSize 文字大小,單位為pt,預設值為14
string color 標記文字配色,格式為16進位RGB(#RRGGBB),預設為深灰色(#333333)
boolean outline 是否加上文字暈圈,預設為不使用(false)
string outlineColor 文字暈圈配色,格式為16進位RGB(#RRGGBB),預設為白色(#FFFFFF)
boolean overlay 是否允許文字標記互相重疊,若設為false則程式將自動計算文字標記位置並且隱藏部份標記文字,預設值為true

BarSets

Properties
number maxHeight 最大柱高設定,單位為pixel,若未設定則系統將自動計算適合大小後套用
number barWidth 柱寬設定,單位為pixel,若未設定則系統將自動計算適合大小後套用
boolean chartView 是否在互動式訊息視窗中顯示詳細圖表,預設為false
Array<string [#RRGGBB]> color 配色設定,以陣列方式輸入16進位RGB(#RRGGBB)格式之配色集合,輸出之柱狀圖將依照配色集依序填入各個資料柱。若未設定則系統將自動進行配色

 

PieSets

Properties
number size 圓餅大小設定,單位為pixel,若未設定則系統將自動計算適合大小後套用
boolean chartView 是否在互動式訊息視窗中顯示詳細圖表,預設為false
Array<string [#RRGGBB]> color 配色設定,以陣列方式輸入16進位RGB(#RRGGBB)格式之配色集合,輸出之圓餅圖將依照配色集依序填入各個資料分塊。若未設定則系統將自動進行配色

 

SymbolSets

Properties
string ClassifyMethod

分級方法,預設為等距法:
等距法: EQUALINTERVAL
去除前後5%資料等距法:EQUALINTERVA5
等量法: QUANTILE
自訂間距: USER_DEFINED

(自訂間距值設定請參照userLevels)

int classes 使用系統提供分級法之分級數設定。可填入整數2~10,未填入之預設值為5
array userLevels 自訂統計分級區間設定,由小至大依序於陣列內輸入分級區間值(包括最小及最大值)
例:輸入[100, 300, 700, 900]表示分為三級,第一級為100~300;第二級為300~700;第三級為700~900
string SymbolStyle 分級符號樣式設定,預設為圓形,也可選擇下列系統內建的符號樣式
圓形: CIRCLE
星形: STAR
方形: SQUARE
三角形: TRIANGLE
string fillColor 符號填色色彩,格式為16進位RGB(#RRGGBB),預設為深紅色(#4A1010)
string outlineColor 符號框線色彩,格式為16進位RGB(#RRGGBB),預設為黑色(#000000)
number outlineWidth 符號框線線寬,單位為pixel,預設值為1
string styleUrl 自定義符號,以URL連結方式填入,支援格式為PNG
number maxSize 分級符號最大尺寸,單位為pixel,若未設定則系統將自動進行尺寸設定
number minSize 分級符號最小尺寸,單位為pixel,若未設定則系統將自動進行尺寸設定
boolean useInt 是否使用整數進行統計計算及展示(非必填,預設使用資料庫對統計欄位是否為整數的定義進行設定,也可自行定義本屬性)

 

MapKind

Properties
string CHOROPLETH 面量圖
string BAR 柱狀圖
string PIE 圓餅圖
string SYMBOL 分級符號圖

 

SymbolStyle

Properties
string CIRCLE 圓形
string STAR 星形
string SQUARE 方形
string TRIANGLE 三角形

 

StatChart Class

Constructor
StatChart(object containerObj, [DataDB/DataOwn] dataobj, string chartKind, ChartOptions chartOpts) 繪製統計圖表物件

參數說明:
containerObj: 若須輸出互動式圖表介面,則填入該網頁物件容器之DIV ID,不須輸出則填入'null'
dataObj: 統計資料來源設定,可使用「統計地圖API應用資料庫資料集物件((DataDB)」或「自有統計資料集物件(DataOwn)」
ChartKind: 統計地圖類型設定,以字串方式填入指定類型
    折線圖:LINE
    柱狀圖:BAR
    圓餅圖:PIE
chartOpts: 統計地圖參數設定

 

Methods
drawChart(Function callback(StatChartResult result)) 繪製統計圖表。Function callback內包含統計圖表繪製結果(StatMapResult result)
setContainer(object containerObj) 設定互動式圖表介面之網頁物件容器DIV ID
getContainer() 取得互動式圖表介面之網頁物件容器DIV ID
setStatData([DataDB/DataOwn] dataobj) 設定統計資料來源
getStatData( ) 取得統計資料來源(回傳值:[DataDB/DataOwn] dataobj)
setChartKind(string chartKind) 設定統計圖表類型
getChartKind( ) 取得統計圖表類型(回傳值:string chartKind)
setChartOptions(MapOptions chartOpts) 設定統計圖表參數
getChartOptions( ) 取得統計圖表參數(回傳值:MapOptions chartOpts)

 

 

ChartOptions

Properties
boolean quickDraw 是否使用暫存資料集繪製圖表,預設為false
boolean exportImage 是否輸出純影像統計圖表,預設為false
ImageSize size 統計圖表影像尺寸設定
InfoOptions infoOpts 互動式訊息視窗客製化參數集合
string chartTitle 自訂圖表標題
LineChartSets pLine 折線圖參數設定集合
BarChartSets pBar 柱狀圖參數設定集合
PieChartSets pPie 圓餅圖參數設定集合
boolean showAllLabel 是否強制顯示所有互動標記,預設為false

InfoOptions

Properties
string activateMode 互動式效果觸發模式,預設為滑鼠移動即觸發(MOUSEMOVE)
滑鼠移動:MOUSEMOVE
滑鼠經過:MOUSEOVER
滑鼠點擊:CLICK
滑鼠雙擊:DBLCLICK
string infoColor 互動訊息視窗背景色,,格式為16進位RGB(#RRGGBB),預設為白色(#FFFFFF)
number opacity 透明度設定,可填入0~1之間的小數,預設為不透明(1)

 

LineChartSets

Properties
string xAxis 設定X軸資料類型(必填,不可與data值相同):
行政區/統計區/機構別: SPATIAL
統計欄位: FIELD
時序: TIME
string data 設定繪製資料類型(必填,不可與xAxis值相同):
行政區/統計區/機構別: SPATIAL
統計欄位: FIELD
時序: TIME
number yMin 自行設定Y軸最小值,非必填
number yMax 自行設定Y軸最大值,非必填
number yInterval 自行設定Y軸間距值,非必填
number width 折線線寬,單位為pixel,預設值為5
Array<string LineStyle> lineStyles 折線樣式,以陣列方式輸入折線的樣式,預設皆為實線(SOLID)
實線:SOLID
虛線:DASH
點:DOT
Array<string #RRGGBB> color 折線圖配色,以陣列方式輸入16進位RGB(#RRGGBB)格式之配色集合,輸出之折線圖將依照配色集依序填入各個折線。若未設定則系統將自動進行配色

 

 

BarChartSets

Properties
string xAxis 設定X軸資料類型(必填,不可與data值相同):
行政區/統計區/機構別: SPATIAL
統計欄位: FIELD
時序: TIME
string data 設定繪製資料類型(必填,不可與(xAxis值相同):
行政區/統計區/機構別: SPATIAL
統計欄位: FIELD
時序: TIME
number yMin 自行設定Y軸最小值,非必填
number yMax 自行設定Y軸最大值,非必填
number yInterval 自行設定Y軸間距值,非必填
number barWidth 柱寬設定,單位為pixel,若未設定則系統將自動計算適合大小後套用
Array<string [#RRGGBB]> color 配色設定,以陣列方式輸入16進位RGB(#RRGGBB)格式之配色集合,輸出之柱狀圖將依照配色集依序填入各個資料柱。若未設定則系統將自動進行配色

 

PieChartSets

Properties
string pies 設定比例資料類型(必填,不可與data值相同):
行政區/統計區/機構別: SPATIAL
統計欄位: FIELD
時序: TIME
string data 設定繪製資料類型(必填,不可與pies值相同):
行政區/統計區/機構別: SPATIAL
統計欄位: FIELD
時序: TIME
number size 圓餅大小設定,單位為pixel,若未設定則系統將自動計算適合大小後套用
Array<string [#RRGGBB]> color 配色設定,以陣列方式輸入16進位RGB(#RRGGBB)格式之配色集合,輸出之圓餅圖將依照配色集依序填入各個資料分塊。若未設定則系統將自動進行配色

 

ChartKind

Properties
string LINE 折線圖
string BAR 柱狀圖
string PIE 圓餅圖

 

Output Class

StatMapResult

Properties
string dataID 匯出暫存之統計資料集token ID
Array<string> imageUrl 輸出統計地圖影像位址(PNG格式),若繪製統計地圖類型為時序性之面量圖或柱狀圖時,則依序將各時間點之統計地圖位址置於陣列中
Envelope envelope 統計地圖地理邊界
string kmlUrl 輸出統計地圖KML檔
Array<[string time, string wkt<[string table, <[string code, string name, <[string field, number value, string unit]>, int classes]>]>]> statData 以陣列方式輸出所有地圖統計資料:
time: 統計時間
wkt: 行政區/統計區/機構別空間定義(統計地圖限定)
table: 統計表格名稱(統計地圖API應用資料庫)或統計表檔名(自有統計資料)
code: 行政區/統計區代碼或機構別ID
name: 行政區/統計區/機構別名稱
field: 統計欄位名稱
value: 統計值
unit: 統計單位
classes: 分級區間(面量圖、分級符號圖限定)
Array<string time, [string filed, number max, number min, number avg, int count, number sDev, number variance]> statInfo 輸出統計資訊
time:統計時間
field: 統計欄位名稱
max: 最大值
min: 最小值
avg: 平均值
count: 資料總數
sDev: 標準差
variance: 變異數
Array<[int classes, string color, number minValue, number maxValue, int count]> choroLegend 以陣列方式輸出面量圖圖例配色資訊:
classes: 分級區間
color: 配色(#RRGGBB)
minValue: 分級區間最小值
maxValue: 分級區間最大值
count: 分級區間內資料數
Array<[string barName, string color]> barLegend 以陣列方式輸出柱狀圖圖例配色資訊:
barName: 柱狀圖名稱
color: 配色(#RRGGBB)
Array<[string pieName, string color]> pieLegend 以陣列方式輸出圓餅圖圖例配色資訊:
pieName: 圓餅圖名稱
color: 配色(#RRGGBB)
Array<[int classes, string symbolUrl, number minValue, number maxValue, int count]> symbolLegend 以陣列方式輸出分級符號圖圖例配色資訊:
classes: 分級區間
symbolUrl: 分級符號URL(PNG格式)
minValue: 分級區間最小值
maxValue: 分級區間最大值
count: 分級區間內資料數
ServiceStatus status 回傳繪製狀況

StatChartResult

Properties
string dataID 匯出暫存之統計資料集token ID
Array<string> imageUrl 輸出統計圖表影像位址(PNG格式),若繪製統計地圖類型為時序性之統計圖表且以時間點同時繪製多張圖表時,則依序將各時間點之統計圖表位址置於陣列中
Array<[string code, string name, number value, int classes]>statData 以陣列方式輸出所有地圖統計資料:
code: 行政區/統計區代碼或機構別ID
name: 行政區/統計區/機構別名稱
value: 統計值
classes: 分級區間(面量圖、分級符號圖限定)
Array<[number max, number min, number avg, int count, number sDev, number variance]> statInfo 輸出統計資訊
max: 最大值
min: 最小值
avg: 平均值
count: 資料總數
sDev: 標準差
variance: 變異數
Array<[string lineName, string color, number width]> lineLegend 以陣列方式輸出折線圖圖例配色資訊:
lineName: 柱狀圖名稱
color: 配色(#RRGGBB)
width: 線寬
Array<[string barName, string color]> barLegend 以陣列方式輸出柱狀圖圖例配色資訊:
barName: 柱狀圖名稱
color: 配色(#RRGGBB)
Array<[string pieName, string color]> pieLegend 以陣列方式輸出圓餅圖圖例配色資訊:
pieName: 圓餅圖名稱
color: 配色(#RRGGBB)
ServiceStatus status 回傳繪製狀況

AdminQuery Class

Methods
pointQuery(Point point,  CoordSystem coordinate, string adminType, Function callback(AdminQueryResult result)) 輸入點坐標取得行政區資訊

 

AdminQueryResult

Properties
object adminName 行政區名稱,包含縣市(county)、鄉鎮市區(town)、村里(village)三個層級之行政區名稱,若查詢之行政區層級為縣市,則town與village之輸出為null;若查詢之行政區層級為鄉鎮市區,則village之輸出為null
object adminCode 行政區代碼,包含縣市(county)、鄉鎮市區(town)、村里(village)三個層級之行政區代碼,若查詢之行政區層級為縣市,則town與village之輸出為null;若查詢之行政區層級為鄉鎮市區,則village之輸出為null
Point central 行政區中心點坐標,回傳結果為public類別之Point物件
Envelope envelope 行政區地理邊界,回傳結果為public類別之Envelope物件
ServiceStatus status 回傳查詢狀況

 

Public Class

TimeOptions

Properties
boolean timeSeries 是否使用時序性設定(非必填,預設為false)
Array<string > time 以陣列方式依序填入所需時間區段,若TimeSeries值為false,僅須填入單一時間區段(必填)

 

AreaSelect

Properties
string areaSelectType 空間篩選設定方式(必填,可使用「指定行政區/統計區選取」、「空間篩選」、「環域篩選」三種篩選方式)
指定行政區/統計區選取:district
空間篩選:spatial
環域篩選:buffer
string districtType 配合「指定行政區/統計區篩選」類型使用。
設定指定行政區的類型,可直接指定選取資料的空間單元層級,或向上指定更高層級以高層級的行政區進行空間篩選。不輸入此參數則以該資料空間單元層級作為預設值。
縣市:COUNTY
鄉鎮市區:TOWN
村里:VILLAGE
二級發布區:CODE2
一級發布區:CODE1
最小統計區:CODEBASE

例:統計資料本身為鄉鎮層級,可於此參數設定 DistrictType.TOWN,再於「districtCode」參數直接輸入指定的鄉鎮代碼。或是在此參數設定為 DistrictType.COUNTY,再於「districtCode」參數輸入縣市代碼後,直接選取指定縣市內的所有鄉鎮市區統計資料。
Array<string > districtCode 配合「指定行政區/統計區篩選」類型使用。
以陣列方式填入指定之行政區/統計區代碼,所有代碼須位於同一行政區或統計區層級,並且填入之行政區/統計區代碼其層級必須大於或等於DBdataset中的DataLevel設定
SpatialOptions spatialOpts 配合「空間篩選」類型使用。設定篩選參數
BufferOptions bufferOpts 配合「環域篩選」類型使用。設定篩選參數

 

SpatialOptions

Properties
Array(Point) points 點坐標篩選,可於陣列中填入多點,坐標須符合 CoordSystem所設定之坐標格式
Envelope(number left, number top, number right, number bottom) envelope 矩形篩選,填入矩形之四邊坐標值,坐標須符合 CoordSystem所設定之坐標格式
Circle(number x, number y, number radius) circle 圓形篩選,填入圓心X、Y坐標及半徑值,坐標須符合 CoordSystem所設定之坐標格式,半徑單位為公尺
string wkt 多邊形篩選,以WKT字串格式設定多邊形,多邊形節點坐標須符合 CoordSystem所設定之坐標格式
例:POLYGON((121.528 25.044, 121.547 25.043, 121.542 25.031, 121.522 25.036, 121.528 25.044))

 

UnitOptions

Properties
boolean useDefaultUnit 是否使用預設統計單位,預設為true。若設為false時則使用資料預設之換算單位或自定義之換算單位
string CostumUnit 自定義換算單位參數,系統將依照換算單位將原始統計數值進行換算,並顯示於輸出結果中(如原始資料單位為「人」,若換算參數設定為「10e3」,則將所有取出之統計值除以1000後再進行統計地圖/圖表繪製,最終顯示之統計單位為「千人」)。可選擇下列各種單位換算參數
10e1: 十
10e2: 百
10e3: 千
10e4: 萬
10e5: 十萬
10e6: 百萬
10e7: 千萬

 

BufferOptions

Properties
Array<string> wkts 環域圖徵,以陣列方式填入WKT字串,支援點(Point)、線(LineString)、多邊形(Polygon)三種圖徵類型,圖徵節點坐標須符合 CoordSystem所設定之坐標格式(必填)
例:
POINT(121.528 25.044)
LINESTRING(121.528 25.044, 121.547 25.043)
POLYGON((121.528 25.044, 121.547 25.043, 121.522 25.036, 121.528 25.044))
number radius 環域半徑,單位為公尺(必填)

 

DataOption

Properties
string dataType 統計資料類型(必填)
行政區統計資料:ADMIN
統計區統計資料:CODE
機構別統計資料(XY坐標點):LOCATE
混合型統計資料:MIX
boolean useOrg 與dataType設定為MIX並用,當開啟此設定後,統計資訊的計算及呈現將會納入混合型中的機構別統計資料。
預設為false
TimeOptions timeOpts 統計時間設定(非必填)
string dataLevel 資料層級類型設定(非必填,預設為縣市,填入字串參考下列各項層級)
縣市:COUNTY
鄉鎮市區:TOWN
村里:VILLAGE
二級發布區:CODE2
一級發布區:CODE1
最小統計區:CODEBASE
機構別:ORG
自定資料:Customize
string dataTitle 自訂欄位命名(非必填)
UnitOptions unitOpts 統計單位設定(非必填)
string fieldFormula 資料欄位計算式設定,可包含加減乘除基本四則運算以及小括弧(),計算式舉例如將欄位A與欄位B相減後除以B,再乘以100,計算式可寫成"(A-B) / B *100"
本公式計算符號之認定分別為eq(加法)、-(減法)、*(乘法)、/(除法)
(非必填)
boolean multiData 設定是否為多重統計資料,當開起此設定後,將進行跨資料表功能

Envelope

Properties
number left 地圖左邊界,坐標格式與輸入資料之 CoordSystem設定一致
number top 地圖上邊界,坐標格式與輸入資料之 CoordSystem設定一致
number right 地圖右邊界,坐標格式與輸入資料之 CoordSystem設定一致
number bottom 地圖下邊界,坐標格式與輸入資料之 CoordSystem設定一致

 

Point

Properties
number  x 座標 x 軸
number  y 座標 y 軸

 

Circle

Properties
number  x 座標 x 軸
number  y 座標 y 軸
int  radius 半徑範圍 (公尺)

 

ImageSize

Properties
int height 圖片之高度。單位為pixel,預設為640
int width 圖片之寬度。單位為pixel,預設為480

 

Enum Class

CoordSystem

Properties
EPSG3825 TWD97坐標系統(中央經線119゚E)
EPSG3826 TWD97坐標系統(中央經線121゚E)
EPSG3857 Web Mercator坐標系統,使用WGS84經緯度坐標

 

ServiceStatus

Properties
string ERROR 與伺服器溝通有誤。
string INVALID_REQUEST 使用者輸入之參數條件要求無效。
string OK 繪圖結果正常。
string UNKNOWN_ERROR 由於伺服器錯誤造成服務無法完成,可再重新請求查詢。

 

AreaSelectType

Properties
string DISTRICT 指定行政區/統計區選取
string SPATIAL 空間篩選
string BUFFER 環域篩選

 

DataType

Properties
string ADMIN 行政區統計資料
string CODE 統計區統計資料
string LOCATE 機構別統計資料

 

ClassifyMethod

Properties
string EQUAL_INTERVAL 等距法
string EQUAL_INTERVAL_5 去除前後5%資料等距法
string QUANTILE 等量法
string USERDEFINED 自訂間距 ,間距設定由userLevels參數定義

 

DataLevel

Properties
string COUNTY 縣市
string TOWN 鄉鎮市區
string VILLAGE 村里
string CODE2 二級發布區
string CODE1 一級發布區
string CODEBASE 最小統計區
string ORG 機構別

 

XAxis

Properties
string SPATIAL 行政區/統計區/機構別
string FIELD 統計欄位
string TIME 時序

 

MapKind

Properties
string CHOROPLETH 面量圖
string BAR 柱狀圖
string PIE 圓餅圖
string SYMBOL 分級符號圖

 

ChartKind

Properties
string LINE 折線圖
string BAR 柱狀圖
string PIE 圓餅圖

 

CostumUnit

Properties
string 10e1
string 10e2
string 10e3
string 10e4
string 10e5 十萬
string 10e6 百萬
string 10e4 千萬

 

SymbolStyle

Properties
string CIRCLE 圓形
string STAR 星形
string SQUARE 方形
string TRIANGLE 三角形

 

DistrictType

Properties
string COUNTY 縣市
string TOWN 鄉鎮市區
string VILLAGE 村里
string CODE2 二級發布區
string CODE1 一級發布區
string CODEBASE 最小統計區

 

BaseLevel

Properties
string COUNTY 縣市
string TOWN 鄉鎮市區
string VILLAGE 村里

 

LabelContent

Properties
string NAME 行政區/統計區名稱
string VALUE 統計值
string ALL 行政區/統計區名稱 + 統計值

 

回到上方