LastMileDeliveryResult

Resumen

An object containing the results of a last mile delivery analysis that can be used to access outputs and solver messages.

Debate

Instances of this class cannot be created directly. Instead, they are returned by the solve method of the LastMileDelivery class.

Learn more about how to use the result object to access and work with the analysis outputs

Propiedades

PropiedadExplicaciónTipo de datos
isPartialSolution
(Sólo lectura)

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
(Sólo lectura)

Returns True if the solve was successful.

Boolean
spatialReference
(Sólo lectura)

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

Descripción general del método

MétodoExplicación
count (output_type)

Returns the number of rows for an output type.

export (output_type, output_features)

Exports the analysis results to a feature class or table.

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.

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)

Saves the analysis result and settings to a layer package. The layer package can be opened in ArcGIS Pro as a record of the analysis settings or to visualize the results.

The method returns a RuntimeError exception if the allowSaveLayerFile property on the solver object is set to False.

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.

Los elementos de capa de ruta pueden usarse desde distintas aplicaciones, por ejemplo, ArcGIS Navigator para proporcionar indicaciones de ruta a los trabajadores móviles, el panel Indicaciones de Map Viewer Classic para personalizar aún más la ruta contenida en la capa de ruta, y ArcGIS Pro para crear una capa de análisis de ruta a partir de una capa de ruta.

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.

Métodos

count (output_type)
ParámetroExplicaciónTipo de datos
output_type

The type of output features to count.

Set this parameter using the LastMileDeliveryOutputDataType enumeration.

Object
Valor de retorno
Tipo de datosExplicación
Integer

The number of rows.

export (output_type, output_features)
ParámetroExplicaciónTipo de datos
output_type

The type of output to export.

Set this parameter using the LastMileDeliveryOutputDataType enumeration.

See descriptions of the fields included in each output type

Object
output_features

The catalog path to the output feature class or table that will contain the exported features.

String
extent ({output_type})
ParámetroExplicaciónTipo de datos
output_type

The type of output features for which to get the extent.

Set this parameter using the LastMileDeliveryOutputDataType 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
Valor de retorno
Tipo de datosExplicación
Extent

An arcpy.Extent object indicating the extent of the designated output type.

fieldNames (output_type)
ParámetroExplicaciónTipo de datos
output_type

The type of output for which to return a list of field names.

Set this parameter using the LastMileDeliveryOutputDataType enumeration.

See descriptions of the fields included in each output type

Object
Valor de retorno
Tipo de datosExplicación
String

A list of field names supported by the specified output type.

saveAsLayerFile (file_name)
ParámetroExplicaciónTipo de datos
file_name

The catalog path of the output layer package (.lpkx file).

Nota:

Layer files with an .lyr extension are not supported for last mile delivery analyses.

String
saveRouteData (file_name)
ParámetroExplicaciónTipo de datos
file_name

The full path of the output .zip file.

String
searchCursor (output_type, field_names, {where_clause})
ParámetroExplicaciónTipo de datos
output_type

The type of output that will be read.

Set this parameter using the LastMileDeliveryOutputDataType enumeration.

Object
field_names
[field_names,...]

A list of field names of the output type whose values will be returned by the cursor. 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:

  • SHAPE@XYA tuple of the feature's centroid's x- and y-coordinates.
  • SHAPE@XYZA tuple of the feature's centroid's x-, y-, and z-coordinates.
  • SHAPE@JSON The Esri JSON string representing the geometry.
  • SHAPE@WKBThe well-known binary (WKB) representation for OGC geometry. It provides a portable representation of a geometry value as a contiguous stream of bytes.
  • SHAPE@WKTThe well-known text (WKT) representation for OGC geometry. It provides a portable representation of a geometry value as a text string.
  • SHAPE@A geometry object for the feature.

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

Una expresión opcional que limita los registros que se devuelven. Para obtener más información sobre cláusulas WHERE y sentencias SQL, consulte Referencia de SQL para las expresiones de consulta utilizadas en ArcGIS.

(El valor predeterminado es None)

String
Valor de retorno
Tipo de datosExplicación
Object

A SolverResultSearchCursor object that reads rows from the output.

solverMessages (severity)
ParámetroExplicaciónTipo de datos
severity

The type of messages to be returned.

The parameter should be specified using the MessageSeverity enumeration.

Object
Valor de retorno
Tipo de datosExplicación
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.

[[-2147200995, '0 location(s) in "Destinations" are valid.  Need at least 1 valid location(s).'],
 [30024, 'Solve returned a failure.'],
 [-2147200995, 'Insufficient number of valid locations in "Origins" or "Destinations".']]