操作

返回表中地址的点几何图形，即地理编码。 在 Search Text 属性中指定地址字符串，或在相应属性中指定结构化部分，例如 Country、 Street 等。 也允许组合使用。此操作需要特殊许可证。由于任何原因无法找到的地址不会在结果中返回。

Qlik Geocoding（通过 AddressPointLookup 和 PointToAddressLookup）提供的功能不同于其他位置查找功能。Qlik Geocoding 允许在地址级别进行查找，而常规位置查找的精确度只能达到邮政编码级别。

开始使用 Qlik Geocoding 时，请使用 配置 Qlik Geocoding （仅提供英文版本） 中引用的模板。

大多数参数有两个版本，一个指定实际值，例如 country="SWE"，另一个指定应从中检索实际值的字段名称， 例如 countryField="CountryIso2"。

返回以下列：

• <dataset key column> - 输入数据集的关键字段。
• Address - 找到的地址，格式化为该国家/地区的地址标准。
• Geometry - 找到的项目的点。
• HouseNumber - 找到的项目的门牌号。
• Street - 找到的项目的街道。
• PostalCode - 找到的项目的邮政编码。
• City - 找到的项目的城市级行政区划名称。
• Adm1 - 找到的项目的一级行政区划（州/省）的名称或缩写名称。
• CountryIso2 - 找到的项目的国家/地区代码。
• Match - 介于 0 和 1 之间的值，显示匹配的良好程度。值为 1 表示完美匹配。
• 除 dataset 中的关键字段外的所有列，以数据集名称为前缀。

在不适用或数据不可用的情况下，返回的字段可能为空。

支持：

• 加载脚本中的 ScriptEval。

对一些瑞典地址进行地理编码的示例，其中每个项目都在各自的字段中：

此示例显示了自由文本样式的地理编码：

为点数据集生成矩形或六边形分箱。这是一种聚合点数据的方法，以便可以有效地显示数据的概览。

返回以下列：

• <dataset key column> - 输入数据集的关键字段。
• BinId - 分箱的标识。
• BinTable.BinPolygon - 分箱的多边形。
• BinTable.CenterPoint - 分箱中心的点。
• 除 dataset 中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。

从美国机场加载六边形分箱的示例：

返回一个数据集中的对象与另一个数据集中最近对象之间的关系和距离（如果有任何对象比最大距离更近）。 成本也可以沿道路计算，在这种情况下，可以选择使用旅行时间。 此操作在许多情况下都很有用，不仅用于获取与最近对象的关系，还用于获取一组点之间的距离矩阵。

返回以下列：

• <dataset1 name>_<dataset2 name>_RelationId - 为两个几何图形之间的关系生成的键。
• <dataset1 key column> - 输入 dataset1 的关键字段。
• <dataset2 key column> - 输入 dataset2 的关键字段。
• Distance - 以 costUnit 中指定的单位表示的距离。
• Status - 返回的状态为 "ok" 或 "failed:" 后跟错误消息。
• LowResLine - 路线的低分辨率版本，仅适用于非 bird 距离类型。
• 除输入 dataset1 数据集中的关键字段外的所有列，以数据集名称为前缀。
• 除输入 dataset2 数据集中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。

此示例查找距离表中各点最近的机场：

根据点之间的地理接近程度从点数据集生成聚类。聚类生成由 distance 参数控制，该参数定义点与其所属聚类的最大距离。 返回一个包含点和聚类之间关系的表。 还返回一个名为 Clusters 的联接表，其中包含聚类几何图形。 它包含字段 ClusterID、ClusterCenter（点几何图形）和 PointCount。 计数字段包含聚类中的点数。

返回以下列：

• <dataset key column> - 输入数据集的关键字段。
• ClusterID - 点所属聚类的 ID。
• Clusters.ClusterPoint - 聚类的中心点。
• Clusters.PointCount - 属于该聚类的原始点数。
• 除输入数据集中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。

此示例对美国的机场进行聚类，以便距离小于 50 公里的机场属于同一个聚类：

根据旧区域标识（或几何图形）与新区域标识之间的映射，融合并简化区域以形成更大的区域。 这通常用于构建由较小的明确定义的区域（例如邮政区域或行政区域）组成的自定义区域。

返回以下列：

• <dissolveField> - 在输入数据中指定为 dissolveField 的字段。
• DissolvedPolygon - 新融合区域的几何图形。

支持：

• 加载脚本中的 ScriptEval。

几何图形数据集是可选的。如果未提供，则假定几何图形在融合定义数据集中可用。

请注意，除 Source 外，所有分辨率中的多边形重叠都将被移除。

此示例创建两个区域，一个由 CA 和 AZ 组成，另一个由 WA 和 OR 组成：

返回一个表，该表在 dataset1 中的键和 dataset2 中的键之间映射所有相交的对象。 如果两个数据集都包含多边形，则返回与各自数据集中的区域相比的相对重叠区域。

可以通过指定 intersectsCount 来限制第二个数据集中应映射到第一个数据集中每个几何图形的相交几何图形的数量。 然后按顺序返回最相交的几何图形。如果未指定 intersectsCount，则该操作是对称的。

返回以下列：

• <dataset1 name>_<dataset2 name>_RelationId - 为两个几何图形之间的关系生成的键。
• <dataset1 key column> - 输入 dataset1 的关键字段。
• <dataset2 key column> - 输入 dataset2 的关键字段。
• <dataset1 name>.RelativeOverlap - 与 dataset1 中的多边形相比的重叠。仅当两个数据集都包含多边形时才返回。请求此字段会降低性能。
• <dataset2 name>.RelativeOverlap - 与 dataset2 中的多边形相比的重叠。仅当两个数据集都包含多边形时才返回。请求此字段会降低性能。
• 除输入 dataset1 数据集中的关键字段外的所有列，以数据集名称为前缀。
• 除输入 dataset2 数据集中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。

此示例计算某些线与哪些州/省相交：

返回表中 IP 地址的位置信息和点几何图形。 这在分析 Web 服务的访问数据时非常有用。 返回的表包含以下字段：

• 关键字段 - 与名称表的关键字段相同。
• <Address Table Ip Field> - 与查找的 IP 字段相同。仅当与关键字段不同时才可用。
• IpPoint - 找到的项目的点。
• CountryIso2 - 找到的项目的国家/地区代码。
• Adm1Code - 找到的项目的一级行政区划代码。请注意，此代码并不总是与位置服务返回的代码兼容。
• City - 找到的项目的城市。
• 除输入数据集中的关键字段外的所有列，以数据集名称为前缀。

IP 地理定位本质上是不精确的。对于许多 IP 地址，可以精确定位到城市，但对于其他 IP 地址，只能解析到国家/地区。

最佳实践是仅将 Ip 列发送到 IpLookup 操作。查找某些 IP 地址的示例：

同一个 IP 在多行中重复是很常见的。像此示例中那样首先过滤出唯一的 IP 可以提高性能：

本产品包含由 MaxMind 创建的 GeoLite2 数据，可从 MaxMind 获取。

加载数据集而不应用任何操作。这使得加载 GeoOperations 支持的所有格式成为可能。 请注意，如果几何图形详细且显示缓慢， Simplify 可能是 Load 的一个很好的替代方案。

返回以下列：

• dataset 中的所有列。

支持：

• 加载脚本中的 ScriptEval。

从瑞典加载邮政编码的示例：

由于 WKT 被支持作为 INTABLE 中数据的几何图形格式，因此 Load 操作非常适合将从数据库加载的地理几何图形转换为 Sense 几何图形格式，以便可以显示它。 以下示例显示了如何转换 WKT 数据，在本例中来自 MyWKTData 表：

返回列表中各点的最近地址，也称为反向地理编码。 此操作需要特殊许可证。 靠近街道的点将获得街道级别的地址，否则将回退到返回邮政区域或城市级别的匹配项。对于太远的点，不返回任何数据。

返回以下列：

• <dataset key column> - 输入数据集的关键字段。
• Address - 找到的地址，格式化为该国家/地区的地址标准。
• Geometry - 找到的项目的点。
• HouseNumber - 找到的项目的门牌号。
• Street - 找到的项目的街道。
• PostalCode - 找到的项目的邮政编码。
• City - 找到的项目的城市级行政区划名称。
• Adm1 - 找到的项目的一级行政区划（州/省）的名称或缩写名称。
• CountryIso2 - 找到的项目的国家/地区代码。
• Distance - 到找到的地址的距离（以米为单位）。
• 除 dataset 中的关键字段外的所有列，以数据集名称为前缀。

请注意，在不适用或数据不可用的情况下，返回的字段可能为空。

获取某些点的地址的示例：

计算表中两个位置之间的路线，包括长度和持续时间。

请注意，起点是数据集中的几何图形列。 终点列在操作参数中指定，因为数据集只知道一个几何图形列。

如果您使用 bird 作为交通类型，它会在起点和终点之间生成大圆弧。

返回以下列：

• <dataset key column> - 输入数据集的关键字段。
• Distance - 路线距离（以米为单位）。
• Duration - 估计的路线旅行时间（以秒为单位）。
• Status - 返回的状态为 "ok" 或 "failed:" 后跟错误消息。
• LowResLine - 路线的低分辨率版本。
• 除输入数据集中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。
• 图表脚本中的 ScriptEvalStr，用于获取路线。
• 图表脚本中的 ScriptEval，用于获取距离或持续时间。

这是一个计算数据集中各点之间路线的示例：

这是一个直接在线图层中计算路线的示例。每次选择更改时，都会为选择调用该操作。 通常应该有一个计算条件，如果仅选择了几个点，则该条件为真（否则最好在加载脚本中计算路线）。 这应该放在加载脚本中以加载数据。例如：

在线图层中使用以下维度：

在线图层中使用计算条件：

在应设置为 Line geometry 的 Location 属性中，输入此内容以计算从固定位置到所选点的路线：

简化数据集中的线和区域几何图形。 使用 Simplify 操作而不是 Load 操作加载地理数据通常很有用，可以获得更高效、显示更快的几何图形。

简化的程度是根据面积、对象数量和对象大小自动计算的。 然后可以使用 resolution 参数将其调整为更高或更低的分辨率。

区域简化是使用处理拓扑的算法完成的，可以消除间隙并连接孤岛。

线简化是使用断点减少算法完成的。

请注意，多边形的重叠将被移除。输出中将没有重叠的多边形。

返回以下列：

• <dataset key column> - 输入 dataset1 的关键字段。
• Simplified_<geometry column name> - 原始几何图形的简化版本。
• 除 dataset 中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。

加载美国各州简化版本的示例：

计算旅行时间 ISO 区域。 返回区域内的所有位置都可以在特定时间内到达，或者沿道路的距离小于特定距离。 返回一个包含 ID、旅行区域几何图形、中心点、成本、成本单位和状态（OK 或 failed）的表。

如果您使用 "bird" 作为交通类型，它会在起点周围生成地理上正确的圆。

返回以下列：

• <dataset key column> - 输入数据集的关键字段。
• TravelArea - 定义旅行区域的多边形几何图形。
• Cost - 在 costValue 或 costField 中指定的成本。
• CostUnit - 在 costUnit 中指定的成本单位。
• Status - 返回的状态为 "OK" 或 "failed:" 后跟错误消息。
• 除输入数据集中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。
• 图表脚本中的 ScriptEvalStr，用于获取旅行区域几何图形。
• 图表脚本中的 ScriptEval，用于获取成本。

此加载脚本示例根据坐标在迈阿密和奥兰多生成 10 分钟的旅行区域：

此加载脚本示例使用命名点在迈阿密和奥兰多生成 10 分钟的旅行区域：

这是一个直接在区域图层中计算点周围旅行区域的示例。每次选择更改时，都会为选择调用该操作。 这应该放在加载脚本中以加载示例的数据：

在区域图层中使用以下维度：

在区域图层中使用计算条件：

在 Location 属性中输入此内容：

返回两个数据集之间的关系，其中一个数据集（被包含）中的几何图形完全位于另一个数据集（包含）的区域内。 返回一个表，该表在被包含的键和包含的键之间映射所有找到的关系。

通常使用 within 来查找数据所在的区域； 例如，测试 GPS 位置以确定它们所在的行政区域。 这是一种反向地理编码。

返回以下列：

• <enclosed name>_<enclosing name>_RelationId - 为两个几何图形之间的关系生成的键。
• <enclosed key column> - 输入 dataset1 的关键字段。
• <enclosing key column> - 输入 dataset2 的关键字段。
• 除 enclosed 数据集中的关键字段外的所有列，以数据集名称为前缀。
• 除 enclosing 数据集中的关键字段外的所有列，以数据集名称为前缀。

支持：

• 加载脚本中的 ScriptEval。

为了补偿数据中的不准确性，有时最好使用 Closest 而不是 Within。例如，如果您有沿海地区的点数据，并且希望将其与行政区域关联，那么微小的不准确性可能会使点略微落在区域之外。

这是一个加载脚本示例，用于计算哪些点在哪些州/省内：