Early Access: The content on this website is provided for informational purposes only in connection with pre-General Availability Qlik Products.
All content is subject to change and is provided without warranty.
跳到主要內容 跳至補充內容

資料集

以下是可在 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 個字母)。可以指定數個國家/地區,以逗號分隔。預設值表示不限於一個國家/地區。
 

此頁面是否對您有幫助?

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