计算位置 (Network Analyst 工具)
汇总
用于定位网络上的输入要素，并向输入要素添加描述网络位置的字段。 该工具用于预先计算将在 Network Analyst 工作流中使用的输入的网络位置，从而提高求解时的分析性能。 该工具将计算的输入网络位置存储在输入数据的字段中。
用法
默认情况下，此工具将已计算网络位置存储在一组字段中，其中所有 Network Analyst 工作流可识别网络位置字段名。 但是，您可以更改存储已计算网络位置的字段的名称。 在这种情况下，如果在工作流中使用预先计算的网络位置，请使用字段映射将非默认位置字段映射到正确的网络位置属性。
更改字段名称的唯一原因是需要为同一要素类中的不同网络或出行模式存储单独的一组位置字段。 否则，必须使用默认字段名。
可以使用源 ID 字段、源 OID 字段、延伸百分比字段、边缘侧字段、定位的 X 坐标字段、定位的 Y 坐标字段、要素距离字段、定位的 Z 坐标字段和位置范围字段参数指定备用字段名。
此工具仅使用网络数据集计算输入的网络位置。 无法计算网络分析服务的网络位置。
如果输入要素是网络分析图层的子图层，则将根据存储在输入网络分析图层中的位置属性自动填充搜索容差、搜索条件和搜索查询参数。 如果网络分析图层具有所选子图层的位置设置替代，则将使用这些设置。 否则，将使用网络分析图层的默认位置设置。
如果输入要素是网络分析图层的子图层，并且您更改了搜索容差、搜索条件或搜索查询参数的值，则运行该工具将更新所选子图层的网络分析图层的位置设置替代。 将这些位置设置存储在网络分析图层中可确保在求解时完成的任何自动重定位都使用您在最初计算网络位置时已使用的相同位置设置。
如果输入要素类具有长整型的
CurbApproach字段，则该字段中的值可用于影响定位行为。 具体来说，如果点位于单行道上，并且具有指定车辆左侧或右侧的路边通道，则可以更新SideOfEdge位置字段值，从而确保可以沿着单行道以正确的方向到达该点。CurbApproach字段在输入中不是必需的，但如果它存在并且是长整型，则会使用该值。如果某行的
CurbApproach字段值与有效CurbApproach域值之一不匹配，则在定位点时将忽略该行的字段值，并使用默认值 0（车辆的任一侧）。如果输入要素类具有长整型的
Status字段，则该字段的值将会更新以反映每行的定位状态。如果输入要素类中的
Status字段有其他用途且您不想覆盖它，请在运行此工具之前更改该字段的名称。
参数
| 标注 | 说明 | 数据类型 |
|---|---|---|
|
输入要素 |
将要计算网络位置的输入要素。 对于线和面要素，由于网络位置信息存储在 BLOB 字段中，所以仅支持地理数据库要素类。 |
Table View |
|
输入分析网络 （可选） |
将用于计算位置的网络数据集。 除非网络分析图层的子图层用作输入要素，否则此参数为必填项。 在这种情况下，将隐藏该参数，并自动将其设置为网络分析图层所引用的网络数据集。 |
Network Dataset Layer |
|
搜索容差 （可选） |
在网络上定位输入要素将使用的最大搜索距离。 搜索容差范围之外的要素将保持未定位状态。 该参数包含值和单位。 默认值为 5000 米。 如果输入图层为网络分析图层的子图层，则此参数的默认值取决于在输入网络分析图层中存储的位置属性。 如果网络分析图层具有所选子图层的位置设置替代，则将使用这些设置。 否则，将使用网络分析图层的默认位置设置。 如果为此参数设置非默认值，则将更新选定子图层的网络分析图层的位置设置覆盖。 计算线或面要素的位置时，不使用该参数。 |
Linear Unit |
|
搜索条件 （可选） |
在网络上定位输入时将搜索的网络数据集中的边和交汇点源。 例如，如果网络数据集引用了表示街道和人行道的单独要素类，您可以将输入定位在街道上而不是人行道上。 默认值是在所有网络源上定位，但通过运行融合网络工具创建的替代交汇点和系统交汇点除外。 注意：对于废弃物收集分析，如果任何停靠点位于交汇点，则求解操作将失败。 向垃废弃物收集分析图层添加停靠点时，请勿配置此参数以允许定位在交汇点源上。 如果输入图层为网络分析图层的子图层，则此参数的默认值取决于在输入网络分析图层中存储的位置属性。 如果网络分析图层具有所选子图层的位置设置替代，则将使用这些设置。 否则，将使用网络分析图层的默认位置设置。 如果为此参数设置非默认值，则将更新选定子图层的网络分析图层的位置设置覆盖。 值表列：
|
Value Table |
|
在所有类中查找最近的 （可选） |
旧版本：此参数已弃用，并将仅针对向后兼容性进行维护。 输入将与用于定位的所有源中最近网络源进行匹配，对应
|
Boolean |
|
源 ID 字段 （可选） |
要创建或更新的字段的名称，将使用输入要素已计算网络位置的网络数据集源要素类的 ID 进行填充。 默认值为 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
源 OID 字段 （可选） |
要创建或更新的字段的名称，将使用输入要素已计算网络位置的网络数据集源要素类的 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
延伸百分比字段 （可选） |
要创建或更新的字段的名称，用于描述已计算网络位置沿其所在网络元素的延伸百分比。 默认值为 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
边缘侧字段 （可选） |
要创建或更新的字段的名称，用于描述已计算网络位置所在的网络边缘侧。 默认值为 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
定位的 X 坐标字段 （可选） |
要使用已计算网络位置的 x 坐标创建或更新的字段名称。 默认值为 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
定位的 Y 坐标字段 （可选） |
要使用已计算网络位置的 y 坐标创建或更新的字段名称。 默认值为 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
要素距离字段 （可选） |
要创建或更新的字段的名称，用于描述原始点要素与其已计算网络位置之间的距离（以米为单位）。 默认值为 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
定位的 Z 坐标字段 （可选） |
要使用已计算网络位置的 z 坐标创建或更新的字段的名称。 默认值为 仅当输入的网络数据集支持基于网络源的 z 坐标值的连通性时，才会使用该参数。 计算线或面要素的位置时，不使用该参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
位置范围字段 （可选） |
要使用线或面要素的计算的网络位置的位置范围创建或更新的字段的名称。 默认值为 仅当计算线或面要素的位置时，才会使用此参数。 当输入要素为网络分析图层的子图层时，切勿使用此参数。 子图层中的网络位置必须以默认名称存储在位置字段中，否则在求解图层时不会使用这些位置。 |
Field |
|
排除网络的受限部分 （可选） |
旧版本：此参数已弃用，并将仅针对向后兼容性进行维护。 永不在受限的网络元素上定位分析输入，对应于
|
Boolean |
|
搜索查询 （可选） |
此查询将搜索范围限制在源要素类的要素子集内。 这在不想查找可能不适合网络位置的要素时很有用。 例如，如果您不想定位在高速公路坡道上，则可定义一个查询将其排除。 可以为网络数据集的每个边或交汇点源要素类指定单独的 SQL 表达式。 不会向未在地理处理窗格中明确指定的任何网络源应用查询。 默认情况下，不对任何源使用查询。 如果输入图层为网络分析图层的子图层，则此参数的默认值取决于在输入网络分析图层中存储的位置属性。 如果网络分析图层具有所选子图层的位置设置替代，则将使用这些设置。 否则，将使用网络分析图层的默认位置设置。 如果为此参数设置非默认值，则将更新选定子图层的网络分析图层的位置设置覆盖。 值表列：
|
Value Table |
|
出行模式 （可选） |
将使用的出行模式的名称。 如果指定了一个出行模式，那么将在计算网络位置时进行出行模式设置（例如限制和阻抗属性）。 例如，在应用所选出行模式时，如果距离输入点之一最近的网络边缘受到限制，则该工具将定位下一条不受限制的网络边缘上的点。 可用出行模式取决于输入分析网络参数值。 如果将网络分析图层的子图层用作输入要素，则将隐藏此参数并且不应使用此参数。 在计算网络位置时，将自动使用网络分析图层的当前出行模式。 |
String |
派生输出
| 标注 | 说明 | 数据类型 |
|---|---|---|
|
更新的输入要素 |
更新后的输入要素。 |
Table View |
|
网络分析图层 |
如果输入要素参数值是网络分析图层的子图层，则此派生输出参数将返回子图层的父网络分析图层。 否则，将不返回任何值。 |
Network Analyst Layer |
环境
许可信息
- 基本: 是
- 标准: 是
- 高级: 是