Indicaciones (Network Analyst)

Resumen

Genera información de indicación a partir de una capa de análisis de red con rutas. La información de indicación se escribe en un archivo en formato XML o de texto.

Uso

• La herramienta resuelve la capa de análisis de red si no tiene un resultado válido. Por eso, no es necesario resolver la capa de análisis de red antes de generar las indicaciones.

• El archivo XML de salida que contiene las indicaciones se puede convertir a un archivo HTML formateado correctamente utilizando las hojas de estilo disponibles en la carpeta de instalación de ArcGIS. Por ejemplo, el formato XML de salida de las indicaciones se puede convertir a un archivo HTML o un archivo de texto utilizando las hojas de estilo Dir2WebDocument.xsl o Dir2PlainText.xsl, respectivamente (generalmente ubicadas en C:\Program Files\ArcGIS\Desktop10.0\NetworkAnalyst\Directions\Styles). Tenga en cuenta que necesitará una herramienta personalizada que transforme archivos XML a archivos HTML mediante las hojas de estilo.

Sintaxis

Directions_na (in_network_analysis_layer, file_type, out_directions_file, report_units, {report_time}, {time_attribute})

Parámetro	Explicación	Tipo de datos
in_network_analysis_layer	La capa de análisis de red desde la que se generarán las indicaciones. Las indicaciones se pueden generar sólo para las capas de análisis de red de Ruta, Instalación más cercana y Problema de generación de rutas para vehículos.	Network Analyst Layer
file_type	El formato del archivo de indicaciones de salida. XML —El archivo de indicaciones de salida se generará como un archivo XML. Además de las cadenas de texto de las indicaciones y la longitud e información de tiempo de las rutas, el archivo también contiene información sobre el tipo de maniobra y el ángulo de giro para cada indicación. Debe utilizar el formato XML si desea aplicar su propio formato para visualizar las indicaciones. TEXT —El archivo de indicaciones de salida se generará como un archivo de TEXTO simple que contiene las cadenas de texto de las indicaciones, la longitud y, opcionalmente, la información de tiempo para las rutas.	String
out_directions_file	Las rutas de acceso completas para el archivo de indicaciones que se escribirá.	File
report_units	Especifica las unidades lineales en las que se informará la información de longitud en el archivo de indicaciones. Por ejemplo, si bien la impedancia estaba en metros, usted puede optar por mostrar las direcciones en millas.	String
report_time (Opcional)	NO_REPORT_TIME —No informa el tiempo de viaje en el archivo de indicaciones. REPORT_TIME —Informa el tiempo de viaje en el archivo de indicaciones.	Boolean
time_attribute (Opcional)	El atributo de coste basado en el tiempo que proporciona los tiempos de viaje en las indicaciones. El atributo de coste debe existir en el dataset de red utilizado por la capa de análisis de red de entrada.	String

Ejemplo de código

Ejemplo 1 de Indicaciones (ventana de Python)

Ejecute la herramienta Indicaciones con todos los parámetros.

import arcpy
arcpy.Directions_na("Route","TEXT","C:/temp/Route_Directions.txt","Miles",
                    "REPORT_TIME","Minutes")

Ejemplo 2 de Indicaciones (flujo de trabajo)

La siguiente secuencia de comandos de Python independiente muestra cómo se puede utilizar la herramienta Indicaciones para generar indicaciones para conducir en un archivo de texto para una ruta.

# 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)
    
    

Entornos

Espacio de trabajo actual

Información de licencia

ArcView: Requiere Analista de red

ArcEditor: Requiere Analista de red

ArcInfo: Requiere Analista de red