跳到主要內容 跳至補充內容

資料集

以下是可在 Qlik GeoOperations 伺服器端延伸中搭配操作使用的資料來源。

CSV

文字檔案含有表格資料,可選擇含有幾何。若不指定幾何,可以指定位置名稱。將會載入所有欄位作為字串。
CSV 的參數
參數 類型 使用 描述
url 字串 預設值:無。

包含資料的檔案 URL。僅允許使用 HTTPS 或 LIB 通訊協定的 URL。

您可以使用下列語法從應用程式空間中的資料來源使用檔案:lib://DataFiles/<file name>。例如 lib://DataFiles/Offices.csv。您也可以使用下列語法指定儲存檔案的空間:lib://<space name>:DataFiles/<file name>。例如 lib://EuropeSales:DataFiles/Offices.csv。您也可以使用下列語法從 Web 儲存空間提供者連接器指定檔案:lib://<Web Storage Provider>/<file name>。例如 lib://Dropbox/Offices.csv。

keyField 字串 預設值:無。 包含每個幾何識別的欄位名稱。若您讓欄位空白,就會產生索引鍵欄位。
geometryField 字串 預設值:無。 幾何欄位的名稱 (如有)。作為幾何的替代選項,可以指定具有知名的點或區域的欄,如以下「幾何類型」。若點資料位於兩個欄位中,則以下列格式指定:以逗號分隔的緯度欄位名稱和經度欄位名稱。
geometryType 字串 default:POINT 幾何欄位中的幾何類型。允許的值為:
  • 點 - 使用 Qlik Sense 點格式的點幾何:"[longitude,latitude]"
  • PointLatLon - 一個欄位具有緯度,一個具有經度
  • 線條 - 使用 Qlik Sense 線條格式的線條幾何:"[[longitude,latitude],[longitude,latitude],...]"
  • 多邊形 - 多邊形幾何,亦即多邊形情況下的封閉線路陣列或封閉線路陣列的陣列
  • LocationNamedPoint - 地理點名稱,例如城市
  • LocationNamedArea - 地理區域名稱,例如國家/地區
  • WKT - WKT 格式的幾何,支援點、線條字串、多線條字串、多邊形和複多邊形,請參閱知名幾何文字呈現
對於已命名的點或區域,會在位置服務中查閱幾何,並新增幾何的欄。會新增國家/地區、類型和行政區域的欄,如同在標準區域和點資料集中。
尾碼 字串 預設值:無。 適用於進階使用者。指定的字串附加至所有 ID。這是一種便利的方式,可向基於伺服器的位置服務 (例如國家代碼或類型) 指定更多資訊。替代選項用來在將表格載入到 Qlik 時附加額外資料。透過下列尾碼,所有項目都特定於瑞典的城市:
,SE:city
請參閱幾何服務規格 (僅提供英文版)瞭解更多關於要使用的語法的資訊。
標頭 字串 預設值:無。 欄的名稱以逗號分隔。如為空白,第一列包含標頭。
fieldSeparator 字串 default:TAB 分隔欄位的字元。除了一般字元,也允許使用關鍵字 TAB (定位字元)、NEWLINE (新行字元)、COMMA (逗號) 和 SEMICOLON (分號)。
recordSeparator 字串 default:NEWLINE 分隔行的字元。除了一般字元,也允許使用關鍵字 TAB (定位字元)、NEWLINE (新行字元)、COMMA (逗號) 和 SEMICOLON (分號)。
編碼 字串 default:UTF-8 為檔案設定的字元。允許與 Java 中相同的值。
stringQuotes 字串 預設值:無。 可用於引述字串的字元。將不會剖析引號內部的欄位和記錄分隔符號。將會在匯入的資料中移除引號。除了一般字元,也允許使用關鍵字 QUOTE(") (引號)、DOUBLEQUOTE(") (雙引號) 和 SINGLEQUOTE(') (單引號)。
crs 字串 default:Auto 要載入的資料 CRS (座標參考系統 )。資料將會在載入到應用程式之前,從此 CRS 投影到 WGS84 (EPSG:4326)。

若設定為自動,則會使用 EPSG:4326 (WGS84)。

GEOFILE

載入不同種類的地理檔案格式,例如 GeoJSON 和 ESRI Shapefile。

此範例透過簡化操作載入 GeoJSON 檔案:

Load * Extension GeoOperations.ScriptEval(' SELECT nuts.NUTS_ID as NUTS_ID, Simplified_nuts_Geometry FROM Simplify() DATASOURCE nuts GEOFILE url="https://datahub.io/core/geo-nuts-administrative-boundaries/r/nuts_rg_60m_2013_lvl_1.geojson"');
GEOFILE 的參數
參數 類型 使用 描述
url 字串 預設值:無。

包含資料的檔案 URL。僅允許使用 HTTPS 或 LIB 通訊協定的 URL。

您可以使用下列語法從應用程式空間中的資料來源使用檔案:lib://DataFiles/<file name>。例如 lib://DataFiles/SalesGeographies.geojson。您也可以使用下列語法指定儲存檔案的空間:lib://<space name>:DataFiles/<file name>。例如 lib://EuropeSales:DataFiles/SalesGeographies.geojson。您也可以使用下列語法從 Web 儲存空間提供者連接器指定檔案:lib://<Web Storage Provider>/<file name>。例如 lib://Dropbox/SalesGeographies.geojson。

keyField 字串 預設值:無。 包含每個幾何識別的欄位名稱。若您讓欄位空白,就會產生索引鍵欄位。
類型 字串 default:Auto 檔案類型。允許的值為:
  • Auto - 嘗試從檔案名稱偵測檔案類型。
  • GeoJSON - 透過 geojson.org 指定的 GeoJSON 格式。
  • GML - 用於讀取 GML 檔案或連線至 WFS 服務。讀取 featureCollection 檔案並為每個 featureMember 元素製作一個列。GeoOperations 僅支援 GML2。
  • Shape - 具有至少一個 SHP 和 DBF 檔案的 ZIP 檔案,用於 ESRI 形狀檔格式。重要的是,應使用與其中檔案相同的字元編碼來建立 ZIP 檔案。
  • ESRIJson - ESRI ArcGIS 伺服器傳回的 JSON (請參閱 ESRI 文件格式)。這可以連線至 ArcGIS 並從已發佈的服務匯入資料。
  • DXF - 用於從 AutoCAD DXF 檔案讀取幾何。支援一組受限制的點和線路項目類型: POINT, TEXT, MTEXT, ARC, CIRCLE, LINE, POLYLINE, LWPOLYLINE, SPLINE, and MLINE
編碼 字串 預設值:無。 對於某些格式 (例如 ESRI 形狀檔),格式中沒有定義字元編碼。這給予了提供此資訊的方式。對於大部分的格式,會忽略此屬性。
expectedGeomType 字串 default:Auto 一次只能載入單一幾何類型。若資料中有多種類型,請使用此屬性以設定要載入哪種類型。對於不支援多種類型的格式,會忽略此參數。
  • Auto - 嘗試自動偵測類型。
  • Point - 在指定的檔案中尋找點。
  • Line - 在指定的檔案中尋找線路。
  • Polygon - 在指定的檔案中尋找多邊形。
crs 字串 default:Auto 要載入的資料座標參考系統 (CRS)。資料將會在載入到應用程式之前,從此 CRS 投影到 WGS84 (EPSG:4326)。

若設定為自動,或者若空白,將會嘗試從檔案剖析。若檔案中找不到 CRS,則會使用 EPSG:4326 (WGS84)。請注意,將此設定為 CRS 會覆寫檔案中的資訊,只能對缺乏這類資訊或已知資訊錯誤的檔案進行。不支援具有含數個 CRS 資料的檔案。

INTABLE

可以宣告作為輸入傳遞至延伸函數的表格,以指定如何解譯。若沒有宣告,在許多情況下,可以根據內容自動偵測索引鍵欄位和幾何欄位。不過,建議宣告表格,讓解譯不會在載入新資料之後變更。

若表格包含名稱,而非幾何或緯度和經度欄,則必須宣告。

若沒有宣告表格,這在操作中將會計數為預設資料集的第一個表格。 若已宣告,將會以宣告順序計數。

通常會使用 Qlik Sense 幾何格式,但也支援 WKT 格式 (知名幾何文字呈現)。因此可以使用一般資料庫連接器之一從資料庫讀取地理資料,然後使用載入操作將幾何轉換為 Sense 幾何。請注意,從資料庫讀取幾何時,應套用以 WKT 格式傳回欄的函數。標準 SQL 函數稱為 ST_AsText(),但有些資料庫有自己的函數。

一次只能使用指定位置欄位的其中一個參數,除了 latitudeFieldlongitudeField,這永遠應以成對方式來定義。

每次操作只能指定一個內嵌表格。若您需要在兩個或更多內嵌表格中使用資料,可以使用 STORE 以將其他內嵌表格儲存為 CSV 檔案,然後從 CSV 檔案載入。

緯度和經度欄位的範例:

MyCities: LOAD * inline " cid;lat;long 1;57.7;12 2;45.42;-75.70 " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' TravelAreas(costValue="10",costUnit="minutes") DATASOURCE cities INTABLE keyField="cid", latitudeField="lat", longitudeField="long"', MyCities);
在範例中,資料包含已命名的位置,並因此需要宣告 namedAreaField 參數:
MyCountries: LOAD * inline " cid;Country 1;US 2;CA " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' Simplify() DATASOURCE countries INTABLE keyField="Country", namedAreaField="Country"', MyCountries{Country});
INTABLE 的參數
參數 類型 使用 描述
keyField 字串 選用 包含每一列唯一識別的欄位名稱。若未指定,將會透過每列的唯一值新增名稱為 _autoIndex_ 的索引鍵欄。
pointField 字串 選用 欄位包含使用 Qlik Sense 點格式的點資料,亦即「[longitude, latitude]」。也支援 WKT 點資料 (「POINT(...)」)。
lineField 字串 選用 欄位包含使用 Qlik Sense 線路格式的線路資料:「[[longitude,latitude],[longitude,latitude],...]」。也支援 WKT 線路資料 (「LINESTRING(...)」或「MULTILINESTRING(...)」)。
polygonField 字串 選用 欄位包含使用 Sense 多邊形格式的線路資料,亦即多邊形情況下的封閉線路陣列或封閉線路陣列的陣列。也支援 WKT 多邊形資料 (「POLYGON(...)」或「MULTIPOLYGON(...)」)。
latitudeField 字串 選用 包含緯度值的欄位。
longitudeField 字串 選用 包含經度值的欄位。
namedPointField 字串 選用 欄位包含在位置資料庫中查閱的地理功能名稱。名稱將使用點來呈現。
namedAreaField 字串 選用 欄位包含在位置資料庫中查閱的地理功能名稱。名稱將使用多邊形來呈現。位置資料庫中的所有名稱不一定有相關的多邊形。
crs 字串 default:Auto 要載入的資料 CRS (座標參考系統 )。資料將會在載入到應用程式之前,從此 CRS 投影到 WGS84 (EPSG:4326)。

若設定為自動,則會使用 EPSG:4326 (WGS84)。

LOCATIONSERVICE

可用於 Qlik GeoAnalytics 伺服器位置服務的點和區域。必須指定類型或國家/地區。

從位置服務載入的表格中欄位是:

  • LocationDbId - 每個項目的唯一 ID。
  • LocationPoint/LocationArea - 項目的幾何。
  • CountryIso2 - 兩個字母的國家代碼。
  • Adm1Code - 一級行政區域的國家特定代碼。
  • Adm2Code - 二級行政區域的國家特定代碼。
  • LocationDbType - 請參閱幾何服務規格 (僅提供英文版)瞭解更多關於類型的資訊。

此範例載入美國的州:

MyAirports: Load * Extension GeoOperations.ScriptEval(' Load() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="STATE", country="us" ');
LOCATIONSERVICE 的參數
參數 類型 使用 描述
幾何 字串 default:Area 選擇以存取點或區域。
類型 字串 default:Country 名稱呈現的資料類型,例如國家/地區、行政區域、郵遞區號等。可以在位置資料庫中以原生類型使用下列簡化的類型名稱 (區分大小寫):
  • CONTINENT - 洲名。
  • COUNTRY - 國家名稱。
  • COUNTRYISO2 - ISO 3166-1 alpha-2 代碼。
  • COUNTRYISO3 - ISO 3166-1 alpha-2 代碼。
  • ADMIN1 - 一級行政區。
  • STATE - ADMIN1 的別名。
  • ADMIN2 - 二級行政區。
  • ADMIN3 - 三級行政區。
  • ADMIN4 - 四級行政區。
  • POSTALCODE - 郵遞區號。
  • ZIP - POSTALCODE 的別名。
  • CITY - 城市名稱。
  • AIRPORTIATA - 機場 IATA 代碼。
  • AIRPORTICAO - 機場 ICAO 代碼。
請參閱幾何服務規格 (僅提供英文版)瞭解更多關於詳細類型的資訊。
country 字串 預設值:無。 要存取之國家/地區的國家/地區代碼 (2 或 3 個字母)。可以指定數個國家/地區,以逗號分隔。預設值表示不限於一個國家/地區。
 

此頁面是否對您有幫助?

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們可以如何改善!