跳到主要内容 跳到补充内容

数据集

以下是可与 Qlik GeoOperations 服务器端扩展中的操作一起使用的数据源。

CSV

包含表格数据的文本文件,可以选择包含几何体。可以指定位置名称,代替几何体。所有字段都将作为字符串加载。
CSV 的参数
参数 类型 使用 描述
url string 默认:无。

包含数据的文件的 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 string 默认:无。 包含每个几何体标识的字段的名称。如果将字段留空,将生成一个关键字段。
geometryField string 默认:无。 几何体字段的名称(如果有)。作为几何体的替代方案,可以在下面的“几何体类型”中指定具有已知点或区域名称的列。如果点数据位于两个字段中,则以下面的格式指定:纬度字段的名称、经度字段的逗号名称。
geometryType string default:POINT “几何体”字段中的几何体类型。允许的值为:
  • 点 - 一种 Qlik Sense 点格式的点几何形状,即 "[longitude,latitude]"
  • PointLatLon - 一个有纬度,一个有经度
  • 线 - 一种 Qlik Sense 线格式的线几何体,即 "[[longitude,latitude],[longitude,latitude],...]"
  • 多边形 - 多边形几何体,即闭合线阵列或多个多边形情况下的闭合线阵列
  • LocationNamedPoint - 地理点的名称,如城市
  • LocationNamedArea - 一个地理区域的名称,如一个国家/地区
  • WKT - WKT 格式的几何图形,支持 POINT、LINESTRING、MULTILINESTRING、POLYGON 和 MULTIPOLYGON,请参见几何图形的已知文本表示法
对于指定点或区域,将在位置服务中查找几何体,并添加几何体的列。国家/地区、类型、行政区域的列也将添加为标准区域和点数据集中的列。
后缀 string 默认:无。 用于高级用户。指定的字符串将附加到所有 ID。这是向基于服务器的位置服务(如国家/地区代码或类型)指定更多信息的方便方法。另一种方法是在将表加载到 Qlik 时附加额外的数据。所有项目均指定为瑞典的城市,后缀如下:
,SE:city
有关使用何种语法的详细信息,请参见几何服务规范 (仅提供英文版本)
标题 string 默认:无。 以逗号分隔的列的名称。如果为空,则第一行应包含标题。
fieldSeparator string default:TAB 分离字段的字符。除了初始字符,还循序关键词 TAB、NEWLINE、COMMA 和 SEMICOLON。
recordSeparator string default:NEWLINE 分离行的字符。除了初始字符,还循序关键词 TAB、NEWLINE、COMMA 和 SEMICOLON。
编码 string default:UTF-8 为文件设置的字符。和 Java 中一样允许相同的值。
stringQuotes string 默认:无。 可用于引用字符串的字符。引号内的字段分隔符和记录分隔符将不会被这样解析。将删除导入数据中的引号。除普通字符外,还允许使用关键词 QUOTE(")、DOUBLEQUOTE(") 和 SINGLEQUOTE(')。
crs string 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 string 默认:无。

包含数据的文件的 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 string 默认:无。 包含每个几何体标识的字段的名称。如果将字段留空,将生成一个关键字段。
类型 string default:Auto 文件类型。允许的值为:
  • Auto - 尝试从文件名检测文件类型。
  • GeoJSON - geojson.org 指定的 GeoJSON 格式。
  • GML - 用于读取 GML 文件或连接到 WFS 服务。读取 featureCollection 文件并为每个 featureMember 元素生成一行。GeoOperations 仅支持 GML2。
  • Shape - 一个 zip 文件,至少包含一个 shp 和一个 dbf 文件,用于 ESRI 形状文件格式。重要的是,创建 zip 文件时使用与其包含的文件相同的字符编码。
  • ESRIJson - ESRI ArcGIS 服务器返回的 JSON(参见 ESRI 文档格式)。这使得连接到 ArcGIS 并从其发布的服务导入数据成为可能。
  • DXF - 用于从 AutoCAD DXF 文件中读取几何体。支持有限的点和线实体类型集: POINT, TEXT, MTEXT, ARC, CIRCLE, LINE, POLYLINE, LWPOLYLINE, SPLINE, and MLINE
编码 string 默认:无。 对于某些格式(如 ESRI Shapefile),该格式中未定义字符编码。这提供了一种提供此信息的方法。对于大多数格式,会忽略此属性。
expectedGeomType string default:Auto 一次仅加载一个几何类型。如果数据中有多个类型,请使用此属性设置加载的类型。对于不支持多种类型的格式,将忽略此参数。
  • Auto - 尝试自动检测类型。
  • Point - 查找指定文件中的点。
  • Line - 查找指定文件中的行。
  • Polygon - 查找指定文件中的多边形。
crs string default:Auto 要加载的数据的坐标参考系 (CRS)。在加载到应用程序之前,数据将从该 CRS 投影到 WGS84 (EPSG:4326)。

如果设置为自动或者如果为空,它将尝试从文件中解析它。如果文件中未找到 CRS,则使用 EPSG:4326 (WGS84)。请注意,将此设置为 CRS 将覆盖文件中的信息,并且仅应针对缺少此类信息的文件或已知信息错误的文件进行设置。不支持数据包含多个 CRS 的文件。

INTABLE

可以声明作为扩展函数输入传递的表,以指定如何解释它。如果未声明,在许多情况下,可以根据内容自动检测关键字段和几何字段。但是,建议声明表,以便在重新加载新数据后不会更改解释。

如果表格包含名称而不是几何体或纬度和经度列,则必须声明该表格。

如果未声明该表,它将被计为操作中默认数据集的第一个表。如果它被声明,它将按声明的顺序计算。

通常使用 Qlik Sense 几何体格式,但也支持使用 WKT 格式(几何形状的已知文本表示)。这使得可以使用一个常用的数据库连接器从数据库读取地理数据,然后使用加载操作将几何图形转换为感测几何图形。请注意,从数据库读取几何图形时,应使用以 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 string 可选 包含每个行的唯一标识的字段的名称。如果未指定,将为每行添加一个名为 _autoIndex_ 的键列,其中包含唯一的值。
pointField string 可选 包含 Qlik Sense 点格式的点数据的字段,"[longitude, latitude]"。还支持 WKT 点数据 ("POINT(...)")。
lineField string 可选 包含 Qlik Sense 行格式的行数据的字段: "[[longitude,latitude],[longitude,latitude],...]"。还支持 WKT 行数据 ("LINESTRING(...)" 或 "MULTILINESTRING(...)")。
polygonField string 可选 包含 Sense 多边形格式的行数据的字段,即闭合行阵列或多多边形情况下的闭合行阵列的阵列。还支持 WKT 多边形数据 ("POLYGON(...)" 或 "MULTIPOLYGON(...)")。
latitudeField string 可选 包含纬度值的字段。
longitudeField string 可选 包含经度值的字段。
namedPointField string 可选 包含在位置数据库中查找的地理要素名称的字段。名称将用点表示。
namedAreaField string 可选 包含在位置数据库中查找的地理要素名称的字段。名称将用多边形表示。并非位置数据库中的所有名称都具有关联的多边形。
crs string 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 的参数
参数 类型 使用 描述
几何体 string default:Area 选择访问点或区域。
类型 string 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 string 默认:无。 要访问的国家/地区的国家/地区代码(2 或 3个字母)。可以指定几个国家/地区,用逗号分隔。默认值表示不限于某个国家/地区。
 

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!