Feuille de route (Network Analyst)
Récapitulatif
Génère des informations de direction à partir d'une couche d'analyse de réseau avec des itinéraires. Les informations de directions sont écrites dans un fichier au format XML ou texte.
Utilisation
-
L'outil résout la couche d'analyse de réseau s'il n'a pas de résultat valide. Il n'est donc pas indispensable de résoudre la couche d'analyse de réseau avant de générer des feuille de route.
-
Le fichier XML en sortie qui contient des directions peut être converti en fichier HTML correctement formaté à l'aide des feuilles de style disponibles dans le dossier d'installation d'ArcGIS. Par exemple, la fichier de directions en sortie au format XML peut être convertie en fichier HTML ou en fichier texte à l'aide de la feuille de style Dir2WebDocument.xsl ou Dir2PlainText.xsl, respectivement (qui se trouve généralement sous C:\Program Files\ArcGIS\Desktop10.0\NetworkAnalyst\Directions\Styles). Notez que vous aurez besoin d'un outil personnalisé qui transforme un fichier XML en fichier HTML à l'aide des feuilles de style.
Syntaxe
| Paramètre | Explication | Type de données |
in_network_analysis_layer |
Couche d'analyse de réseau à partir de laquelle la feuille de route est générée. Il est possible de générer la feuille de route uniquement pour les couches d'analyse de réseau Itinéraire, Ressource la plus proche et Tournée de véhicules. | Network Analyst Layer |
file_type |
Format du fichier de directions en sortie.
| String |
out_directions_file |
Nom de chemin complet du fichier de directions qui sera écrit. | File |
report_units |
Précise les unités linéaires dans lesquelles les informations relatives à la longueur seront consignées dans le fichier de directions. Par exemple, bien que votre impédance soit en mètres, vous pouvez afficher des feuilles de route en miles. | String |
report_time (Facultatif) |
| Boolean |
time_attribute (Facultatif) |
Attribut coût basé sur le temps indiquant les temps de déplacement aux directions. L'attribut de coût doit exister sur le jeu de données réseau utilisé par la couche d'analyse de réseau en entrée. | String |
Exemple de code
Exécutez l'outil Feuille de route avec tous les paramètres.
import arcpy
arcpy.Directions_na("Route","TEXT","C:/temp/Route_Directions.txt","Miles",
"REPORT_TIME","Minutes")
Le script Python autonome suivant illustre l'utilisation de l'outil Feuille de route pour générer des trajets dans un fichier texte pour un itinéraire.
# Name: Directions_Workflow.py
# Description: Generate driving directions in a text file for a route that
# visits the store locations in the best sequence that minimizes
# the total travel time
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = "C:/data/SanFrancisco.gdb"
env.overwriteOutput = True
#Set local variables
inNetworkDataset = "Transportation/Streets_ND"
outNALayer = "StoreRoute"
impedanceAttribute = "TravelTime"
startLocation = "Analysis/DistributionCenter"
storeLocations = "Analysis/Stores"
fieldMappings = "Name Name #; Attr_TravelTime ServiceTime #"
outDirectionsFile = "C:/data/output" + "/" + outNALayer + "Directions.txt"
outLayerFile = "C:/data/output" + "/" + outNALayer + ".lyr"
#Create a new route layer. The route starts at the distribution center and
#takes the best sequence to visit the store locations.
arcpy.MakeRouteLayer_na(inNetworkDataset,outNALayer,impedanceAttribute,
"FIND_BEST_ORDER","PRESERVE_FIRST","",['Meters'],
"NO_UTURNS",start_date_time="8 AM")
#Load the distribution center as the start location using default field
#mappings and search tolerance
arcpy.AddLocations_na(outNALayer,"Stops",startLocation,"","")
#Load the store locations as stops. Make sure the store locations are
#appended to the Stops sublayer which already contains the distribution
#center location. Map the Attr_TravelTime property from the ServiceTime
#field so that the total travel time for the route will also contain the
#service time
arcpy.AddLocations_na(outNALayer,"Stops",storeLocations,fieldMappings,"","",
"","","APPEND")
#Generate driving directions in a text file
arcpy.Directions_na(outNALayer,"TEXT",outDirectionsFile,"Miles",
"REPORT_TIME","TravelTime")
#Save the solved na layer as a layer file on disk using relative paths
arcpy.SaveToLayerFile_management(outNALayer,outLayerFile,"RELATIVE")
print "Script completed successfully"
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print "An error occured on line %i" % tb.tb_lineno
print str(e)