ClosestFacilityResult

Résumé

An object containing the results of a closest facility analysis that can be used to access outputs and solver messages.

Discussion

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

Propriétés

Propriété	Explication	Type de données
isPartialSolution (Lecture seule)	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 (Lecture seule)	Returns True if the solve was successful.	Boolean

Vue d’ensemble des méthodes

Méthode	Explication
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.
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. The layer file can be opened in ArcGIS Desktop or 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. Un élément de couche d’itinéraire peut être utilisé par diverses applications. Dans ArcGIS Navigator, par exemple, il permet de guider les équipes dépêchées sur le terrain, via la fenêtre Directions (Feuille de route) du module Map Viewer afin de personnaliser davantage l’itinéraire figurant dans la couche d’itinéraire ou via ArcGIS Pro pour créer une couche d’analyse d’itinéraires à partir d’une couche d’itinéraire. 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éthodes

count (output_type)

Paramètre	Explication	Type de données
output_type	The type of output features to count. The parameter should be set using the ClosestFacilityOutputDataType enumeration.	Object

Valeur renvoyée

Type de données	Explication
Integer	The number of rows.

Raises no exception.

export (output_type, output_features)

Paramètre	Explication	Type de données
output_type	The type of output to export. The parameter should be set using the ClosestFacilityOutputDataType enumeration.	Object
output_features	The catalog path to the output feature class or table that will contain the exported features.	String

fieldNames (output_type)

Paramètre	Explication	Type de données
output_type	The type of output for which to return a list of field names. The parameter should be set using the ClosestFacilityOutputDataType enumeration.	Object

Valeur renvoyée

Type de données	Explication
String	A list of field names supported by the specified output type.

saveAsLayerFile (file_name)

Paramètre	Explication	Type de données
file_name	The catalog path of the output layer file (.lyr) to write.	String

saveRouteData (file_name)

Paramètre	Explication	Type de données
file_name	The full path of the output .zip file.	String

searchCursor (output_type, field_names, {where_clause})

Paramètre	Explication	Type de données
output_type	The type of output to read. The parameter should be set using the ClosestFacilityOutputDataType 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. In addition to regular fields, you can also access the geometry of the output using one of the following geometry tokens: SHAPE@XY —Tuple des coordonnées x,y du centroïde de l'entité. SHAPE@XYZ —Tuple des coordonnées x,y,z du centroïde de l’entité. Ce jeton est pris en charge uniquement lorsque la géométrie est de type z. SHAPE@JSON — Chaîne JSON d’Esri représentant la géométrie. SHAPE@WKB —Représentation binaire connue (WKB) de la géométrie de l'OGC. Cette représentation constitue une représentation portable d'une valeur de géométrie sous la forme d'un flux contigu d'octets. SHAPE@WKT —Représentation textuelle connue (WKT) de la géométrie de l'OGC. Cette représentation constitue une représentation portable d'une valeur de géométrie sous la forme d'une chaîne de texte. SHAPE@ —Objet géométrie de l'entité. The SHAPE@XY and SHAPE@XYZ tokens are only supported for point-based output types.	String
where_clause	Expression optionnelle qui limite les enregistrements retournés. Pour en savoir plus sur les clauses WHERE et les instructions SQL, consultez Référence SQL pour les éléments utilisés dans les expressions de la requête. (La valeur par défaut est None)	String

Valeur renvoyée

Type de données	Explication
Object	A SolverResultSearchCursor object that reads rows from the output.

solverMessages (severity)

Paramètre	Explication	Type de données
severity	The type of messages to be returned. The parameter should be specified using the MessageSeverity enumeration.	Object

Valeur renvoyée

Type de données

Explication

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".']]