サマリー
An object containing the results of a route analysis that can be used to access outputs and solver messages.
説明
Instances of this class cannot be created directly. Instead, they are returned by the solve method of the Route class.
Learn more about how to use the result object to access and work with the analysis outputs
プロパティ
プロパティ | 説明 | データ タイプ |
isPartialSolution (読み取り専用) | Returns True if the solver produced a partial solution, meaning that not all inputs were included in the results. This can occur if one of the inputs is unlocated and the solver class's ignoreInvalidLocations property is set to True. | Boolean |
solveSucceeded (読み取り専用) | Returns True if the solve was successful. | Boolean |
spatialReference (読み取り専用) | Returns the spatial reference of the output features. For example, feature classes created using the export method and geometry objects retrieved from the searchCursor method will have this spatial reference. The spatialReference value is typically the spatial reference of the network dataset or service used in the analysis. | SpatialReference |
方法の概要
方法 | 説明 |
count (output_type) | Returns the number of rows for an output type. |
export (output_type, output_features) |
The output features will be created in the spatial reference of the network dataset used for the analysis. If the arcpy.env.outputCoordinateSystem environment is set, the output features will be created with the specified coordinate system instead. Exports the analysis results to a feature class or table. |
extent ({output_type}) |
Returns the extent of the analysis output. The method returns a RuntimeError exception if the analysis solve failed. |
fieldNames (output_type) | Returns a list of field names supported by a specified output type. |
saveAsLayerFile (file_name) | Save the analysis result and settings to a layer file or layer package. The layer file or package can be opened in ArcGIS Pro as a record of the analysis settings or to visualize the results. A layer file can also be opened in ArcGIS Desktop. The method returns a RuntimeError exception if the allowSaveLayerFile property on the solver object is set to False. レガシー:Routing services based on portals running versions of ArcGIS Enterprise older than 10.9 do not support saving layer packages. The method returns a RuntimeError exception if this is the case. |
saveRouteData (file_name) | Save the outputs from the analysis to a .zip file. The .zip file can be used to share the routes from the analysis as route layer items in ArcGIS Online or ArcGIS Enterprise using the Share As Route Layers tool. ルート レイヤー アイテムは、現場作業者にルート ガイダンスを提供する場合には、ArcGIS Navigator などの各種アプリケーションで使用し、ルート レイヤーに含まれているルートをカスタマイズする場合には、Map Viewer Classic の [ルート案内] ウィンドウで使用し、ルート レイヤーから新しいルート解析レイヤーを作成する場合には、ArcGIS Pro で使用することができます。 The output features will be created in the spatial reference of the network dataset used for analysis. If the arcpy.env.outputCoordinateSystem environment has been set, the output will be created in that spatial reference instead. If the solve fails, saveRouteData returns a RuntimeError exception. The method returns a RuntimeError exception if the allowSaveRouteData property on the solver object is set to False. |
searchCursor (output_type, field_names, {where_clause}) | Establishes a search cursor on the specified output type. This cursor can be used to read rows directly from the output. |
solverMessages (severity) | Get error, warning, and informational messages returned by the solver. |
方法
count (output_type)
パラメーター | 説明 | データ タイプ |
output_type | The type of output features to count. The parameter should be set using the RouteOutputDataType enumeration. | Object |
データ タイプ | 説明 |
Integer | The number of rows. |
Raises no exception.
export (output_type, output_features)
パラメーター | 説明 | データ タイプ |
output_type | The type of output to export. The parameter should be set using the RouteOutputDataType enumeration. | Object |
output_features | The catalog path to the output feature class or table that will contain the exported features. | String |
extent ({output_type})
パラメーター | 説明 | データ タイプ |
output_type | The type of output features for which to get the extent. The parameter should be set using the RouteOutputDataType enumeration. If you do not specify a value, or you specify a value of None, the extent for the combined analysis outputs is returned. | Object |
データ タイプ | 説明 |
Extent | An arcpy.Extent object indicating the extent of the designated output type. |
fieldNames (output_type)
パラメーター | 説明 | データ タイプ |
output_type | The type of output for which to return a list of field names. The parameter should be set using the RouteOutputDataType enumeration. | Object |
データ タイプ | 説明 |
String | A list of field names supported by the specified output type. |
saveAsLayerFile (file_name)
パラメーター | 説明 | データ タイプ |
file_name | The catalog path of the output layer file (.lyr) or layer package (.lpkx) to write. 注意:Layer files with an .lyr extension cannot be saved if the solver object uses a service URL as its network data source. The method returns a RuntimeError exception in this case. | String |
saveRouteData (file_name)
パラメーター | 説明 | データ タイプ |
file_name | The full path of the output .zip file. | String |
searchCursor (output_type, field_names, {where_clause})
パラメーター | 説明 | データ タイプ |
output_type | The type of output to read. The parameter should be set using the RouteOutputDataType enumeration. | Object |
field_names [field_names,...] | A list of field names of the output type whose values the cursor will return. You can get the names of the fields that are supported by an output type using the fieldNames method. See descriptions of the fields included in each output type In addition to regular fields, you can also access the geometry of the output using one of the following geometry tokens:
The SHAPE@XY and SHAPE@XYZ tokens are only supported for point-based output types. The x-, y-, and z-values returned when using the SHAPE@XY and SHAPE@XYZ tokens are in the spatial reference reported by the solver result object's spatialReference property, and this is typically the same as the spatial reference of the network data source used for the analysis. | String |
where_clause | 返されるレコードを制限するオプションの式。 Where 句と SQL ステートメントの詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。 (デフォルト値は次のとおりです None) | String |
データ タイプ | 説明 |
Object | A SolverResultSearchCursor object that reads rows from the output. |
solverMessages (severity)
パラメーター | 説明 | データ タイプ |
severity | The type of messages to be returned. The parameter should be specified using the MessageSeverity enumeration. | Object |
データ タイプ | 説明 |
List | The messages are returned as a list of lists. The inner list contains two values; the first is a number representing the message code, and the second value is the message text. An example of a list of messages returned from a failed origin destination cost matrix analysis. |