Feuille de route (Network Analyst)

Synthèse

Génère une feuille de route tournant par tournant à partir d'une couche d'analyse de réseau avec des itinéraires. La feuille de route peut être enregistrée dans un fichier au format texte, XML ou HTML. Si vous fournissez une feuille de style appropriée, la feuille de route peut être enregistrée sous un autre format de fichier.

Utilisation

  • L’outil résout la couche d’analyse de réseau s’il ne présente pas déjà un résultat valide.

Paramètres

ÉtiquetteExplicationType de données
Couche d’analyse de réseau en entrée

Couche d’analyse de réseau pour 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.

Attention :
Cet outil ne prend pas en charge les couches d’analyse de livraison sur le dernier kilomètre bien que ce type de couche prenne en charge les feuilles de route.

Network Analyst Layer
Type de fichier en sortie

Indique le format à utiliser pour le fichier de feuille de route en sortie. Ce paramètre est ignoré si le paramètre de feuille de style possède une valeur.

  • XMLLe fichier de directions en sortie est généré en tant que fichier XML. Outre les chaînes de direction et les informations liées à la longueur et au temps pour les itinéraires, le fichier contiendra également les informations concernant le type de manœuvre et l'angle de tournant pour chaque feuille de route.
  • TexteLe fichier de direction en sortie sera généré en tant que fichier TXT simple qui contient les chaînes de direction, la longueur et, facultativement, les informations de temps pour les itinéraires.
  • HTMLLe fichier de direction en sortie sera généré en tant que fichier HTML contenant les chaînes de direction, la longueur et, facultativement, les informations de temps pour les itinéraires.
String
Fichier de feuille de route en sortie

Chemin complet de la feuille de route qui sera écrite.

Si vous fournissez une feuille de style dans le paramètre Feuille de style, vérifiez que le suffixe de Fichier de feuille de route en sortie correspond au type de fichier que la feuille de style produit.

File
Consigner la longueur dans ces unités

Spécifie les unités linéaires à utiliser dans le fichier de feuille de route. Par exemple, même si l’attribut d’impédance est exprimé en mètres, vous pouvez afficher la feuille de route en miles.

  • Milles nautiquesLes unités linéaires sont exprimées en milles nautiques.
  • PiedsLes unités linéaires sont exprimées en pieds.
  • YardsLes unités linéaires sont exprimées en yards.
  • MilesLes unités linéaires sont exprimées en miles.
  • MètresLes unités linéaires sont exprimées en mètres.
  • KilomètresLes unités linéaires sont exprimées en kilomètres.
String
Consigner le temps de trajet
(Facultatif)

Indique si le temps de trajet sera consigné dans le fichier de feuille de route.

  • Activé – Le temps de trajet est consigné dans le fichier de feuille de route. Il s’agit de l’option par défaut.
  • Désactivé – Le temps de trajet n’est pas consigné dans le fichier de feuille de route.
Boolean
Attribut de temps
(Facultatif)

Attribut de coût basé sur le temps permettant d’indiquer les temps de déplacement dans la feuille de route. 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
Langue
(Facultatif)

Langue à utiliser lors de la génération des trajets.

Utilisez un code de langue à deux ou cinq caractères correspondant à l’une des langues disponibles pour générer la feuille de route comme valeur de ce paramètre. Dans Python, vous pouvez récupérer la liste des codes de langue disponibles à l’aide de la fonction ListDirectionsLanguages.

String
Nom du style
(Facultatif)

Spécifie le style de mise en forme de la feuille de route.

  • Trajets imprimablesUne feuille de route détaillée imprimable est utilisée.
  • Trajets pour un appareil de navigationUne feuille de route détaillée, conçue pour un dispositif de navigation embarquée, est utilisée.
  • Itinéraire à piedUne feuille de route pédestre détaillée, conçue pour les itinéraires piétons, est utilisée.
String
Feuille de style
(Facultatif)

La feuille de style permettant de générer un type de fichier en sortie dans un format (tel que PDF, Word ou HTML). Le suffixe du fichier dans le paramètre du fichier de feuille de route en sortie doit correspondre au type de fichier que la feuille de style génère. L’outil remplace le paramètre Type de fichier en sortie si ce paramètre contient une valeur.

Conseil :

Pour créer des feuilles de style HTML et de texte personnalisées, copiez et modifiez les feuilles de style à partir de Network Analyst. Les feuilles de style sont disponibles dans le répertoire <ArcGIS installation directory>\Pro\Resources\NetworkAnalyst\Directions\Styles. La feuille de style HTML correspond à Dir2PHTML.xsl et celle relative au texte à Dir2PlainText.xsl.

File

Sortie obtenue

ÉtiquetteExplicationType de données
Couche d'analyse de réseau

Couche d’analyse de réseau mise à jour avec des itinéraires.

Network Analyst Layer

arcpy.management.Directions(in_network_analysis_layer, file_type, out_directions_file, report_units, {report_time}, {time_attribute}, {language}, {style_name}, {stylesheet})
NomExplicationType de données
in_network_analysis_layer

Couche d’analyse de réseau pour 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.

Attention :
Cet outil ne prend pas en charge les couches d’analyse de livraison sur le dernier kilomètre bien que ce type de couche prenne en charge les feuilles de route.

Network Analyst Layer
file_type

Indique le format à utiliser pour le fichier de feuille de route en sortie. Ce paramètre est ignoré si le paramètre de feuille de style possède une valeur.

  • XMLLe fichier de directions en sortie est généré en tant que fichier XML. Outre les chaînes de direction et les informations liées à la longueur et au temps pour les itinéraires, le fichier contiendra également les informations concernant le type de manœuvre et l'angle de tournant pour chaque feuille de route.
  • TEXTLe fichier de direction en sortie sera généré en tant que fichier TXT simple qui contient les chaînes de direction, la longueur et, facultativement, les informations de temps pour les itinéraires.
  • HTMLLe fichier de direction en sortie sera généré en tant que fichier HTML contenant les chaînes de direction, la longueur et, facultativement, les informations de temps pour les itinéraires.
String
out_directions_file

Si vous fournissez une feuille de style dans le paramètre stylesheet, vérifiez que le suffixe du fichier out_directions_file correspond au type de fichier que la feuille de style produit.

File
report_units

Spécifie les unités linéaires à utiliser dans le fichier de feuille de route. Par exemple, même si l’attribut d’impédance est exprimé en mètres, vous pouvez afficher la feuille de route en miles.

  • FeetLes unités linéaires sont exprimées en pieds.
  • YardsLes unités linéaires sont exprimées en yards.
  • MilesLes unités linéaires sont exprimées en miles.
  • MetersLes unités linéaires sont exprimées en mètres.
  • KilometersLes unités linéaires sont exprimées en kilomètres.
  • NauticalMilesLes unités linéaires sont exprimées en milles nautiques.
String
report_time
(Facultatif)

Indique si le temps de trajet sera consigné dans le fichier de feuille de route.

  • NO_REPORT_TIMELe temps de trajet n’est pas consigné dans le fichier de feuille de route.
  • REPORT_TIMELe temps de trajet est consigné dans le fichier de feuille de route. Il s’agit de l’option par défaut.
Boolean
time_attribute
(Facultatif)

Attribut de coût basé sur le temps permettant d’indiquer les temps de déplacement dans la feuille de route. 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
language
(Facultatif)

Langue à utiliser lors de la génération des trajets.

Utilisez un code de langue à deux ou cinq caractères correspondant à l’une des langues disponibles pour générer la feuille de route comme valeur de ce paramètre. Dans Python, vous pouvez récupérer la liste des codes de langue disponibles à l’aide de la fonction ListDirectionsLanguages.

String
style_name
(Facultatif)

Spécifie le style de mise en forme de la feuille de route.

  • NA DesktopUne feuille de route détaillée imprimable est utilisée.
  • NA NavigationUne feuille de route détaillée, conçue pour un dispositif de navigation embarquée, est utilisée.
  • NA CampusUne feuille de route pédestre détaillée, conçue pour les itinéraires piétons, est utilisée.
String
stylesheet
(Facultatif)

La feuille de style permettant de générer un type de fichier en sortie dans un format (tel que PDF, Word ou HTML). Le suffixe du fichier dans le paramètre du fichier de feuille de route en sortie doit correspondre au type de fichier que la feuille de style génère. L’outil remplace le paramètre Type de fichier en sortie si ce paramètre contient une valeur.

Conseil :

Pour créer des feuilles de style HTML et de texte personnalisées, copiez et modifiez les feuilles de style à partir de Network Analyst. Les feuilles de style sont disponibles dans le répertoire <ArcGIS installation directory>\Pro\Resources\NetworkAnalyst\Directions\Styles. La feuille de style HTML correspond à Dir2PHTML.xsl et celle relative au texte à Dir2PlainText.xsl.

File

Sortie obtenue

NomExplicationType de données
output_layer

Couche d’analyse de réseau mise à jour avec des itinéraires.

Network Analyst Layer

Exemple de code

Exemple 1 d’utilisation de la fonction Directions (fenêtre Python)

L’exemple de code ci-dessous montre l’utilisation de la fonction Directions avec tous les paramètres :

arcpy.na.Directions("Route", "TEXT", "C:/Data/Route_Directions.txt", "Miles",
                    "REPORT_TIME", "Minutes")
Exemple 2 d'utilisation de l'outil Feuille de route (workflow)

Le script Python autonome suivant illustre l’utilisation de la fonction Directions pour générer des trajets dans un fichier HTML pour un itinéraire.

# Name: Directions_Workflow.py
# Description: Generate driving directions in an html file for a route that
#              visits the store locations in the best sequence in order to
#              minimize the total travel time
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env
import os

try:
    #Set environment settings
    output_dir = "C:/Data"
    #The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True

    #Set inputs and outputs
    input_gdb = "C:/Data/SanFrancisco.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    layer_name = "StoreRoute"
    impedance = "TravelTime"
    start_location = os.path.join(input_gdb, "Analysis", "DistributionCenter")
    store_locations = os.path.join(input_gdb, "Analysis", "Stores")
    output_directions = os.path.join(output_dir,
                                                layer_name + "_Directions.html")
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    #Create a new route layer. The route starts at the distribution center and
    #visits the stores in the best order to yield the shortest travel time.
    result_object = arcpy.na.MakeRouteLayer(network, layer_name, impedance,
                                         "FIND_BEST_ORDER", "PRESERVE_FIRST",
                                         "", ['Meters'], "NO_UTURNS",
                                         start_date_time="8 AM")

    #Get the layer object from the result object. The route layer can
    #now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    #Get the names of all the sublayers within the route layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    #Stores the layer names that we will use later
    stops_layer_name = sublayer_names["Stops"]

    #Load the distribution center as the start location using default field
    #mappings and search tolerance
    arcpy.na.AddLocations(layer_object, stops_layer_name, start_location, "",
                            "", exclude_restricted_elements = "EXCLUDE")

    #Load the store locations as stops. Make sure the store locations are
    #appended to the Stops sublayer so the distribution center you just loaded
    #isn't overwritten. Map the ServiceTime field from the input data to the
    #Attr_TravelTime property in the Stops sublayer so that the time it takes to
    #service each store is included in the total travel time for the route.
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                            stops_layer_name)
    field_mappings["Name"].mappedFieldName = "Name"
    field_mappings["Attr_" + impedance].mappedFieldName = "ServiceTime"
    arcpy.na.AddLocations(layer_object, stops_layer_name, store_locations,
                          field_mappings, "", append="APPEND",
                          exclude_restricted_elements = "EXCLUDE")

    #Generate driving directions in an HTML file
    arcpy.na.Directions(layer_object, "HTML", output_directions, "Miles",
                        "REPORT_TIME", impedance)

    #Save the solved na layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

    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 occurred on line %i" % tb.tb_lineno))
    print((str(e)))