Indicaciones

Resumen

Genera indicaciones giro a giro de una capa de análisis de red con rutas. Las direcciones se escriben en un archivo de texto, XML, o formato HTML. Si proporciona una hoja de estilo adecuada, las direcciones se pueden escribir en cualquier otro formato de archivo.

Uso

• La herramienta resuelve la capa de análisis de red si no tienen ya un resultado válido, de modo que no es necesario resolver la capa de análisis de red antes de generar las indicaciones.

Sintaxis

Directions(in_network_analysis_layer, file_type, out_directions_file, report_units, {report_time}, {time_attribute}, {language}, {style_name}, {stylesheet})

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 direcciones se pueden generar sólo para ruta, instalación más cercana, capas de análisis de red de problema de generación de rutas para vehículos.	Network Analyst Layer
file_type	El formato del archivo de indicaciones de salida. Este parámetro se ignora si el parámetro de hoja de estilo tiene un valor. 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. TEXT —El archivo de indicaciones de salida se generará como un archivo TXT simple que contiene las cadenas de caracteres de las indicaciones, la longitud y, opcionalmente, la información de tiempo para las rutas. HTML —El archivo de indicaciones de salida se generará como un archivo de HTML que contiene las cadenas de caracteres de las indicaciones, la longitud y, opcionalmente, la información de tiempo para las rutas.	String
out_directions_file	Si proporciona una hoja de estilo en el parámetro stylesheet, asegúrese de que el sufijo de out_directions_file coincide con el tipo de archivo que produce la hoja de estilo.	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. Feet —Pies Yards —Yardas Miles —Millas Meters —Metros Kilometers —Kilómetros NauticalMiles —Millas náuticas	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. Esta es la opción predeterminada.	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
language (Opcional)	Elija un idioma en el cual desea generar las indicaciones para conducir. Los idiomas que se muestran en la lista desplegable dependen de qué paquetes de idioma de ArcGIS estén instalados en su equipo. Observe que, si va a publicar esta herramienta como parte de un servicio en un servidor separado, el paquete de idioma de ArcGIS que corresponde al idioma que elija se debe instalar en ese servidor para que la herramienta funcione correctamente. También, si el paquete de idioma no está instalado en su equipo, el idioma no aparecerá en la lista desplegable; sin embargo, puede escribir un código de idioma en lugar de elegir uno.	String
style_name (Opcional)	Elija el nombre del estilo de formato para las indicaciones. NA Desktop —Instrucciones giro por giro para imprimir NA Navigation —Instrucciones giro por giro diseñada para un dispositivo de navegación desde el vehículo NA Campus —Direcciones para caminar giro a giro, que están diseñados para las rutas peatonales	String
stylesheet (Opcional)	Hoja de estilo para generar un tipo de archivo de salida formateado (como un archivo PDF, Word o HTML). El sufijo del archivo del parámetro del archivo de indicaciones de salida debe coincidir con el tipo de archivo generado por la hoja de estilo. La herramienta Indicaciones invalida el parámetro del tipo de archivo de salida si este parámetro contiene un valor. Sugerencia: Si desea obtener información avanzada sobre cómo crear sus propias hojas de estilo HTML y texto, copie y edite las hojas de estilo que usa Network Analyst. Puede encontrarlas en el siguiente directorio: <ArcGIS installation directory>\ArcGIS\Desktop10.2.1\NetworkAnalyst\Directions\Styles. La hoja de estilo es Dir2PHTML.xsl y la hoja de estilo de texto es Dir2PlainText.xsl.	File

Salida derivada

Nombre	Explicación	Tipo de datos
output_layer	La capa de análisis de red actualizada con rutas.	Capa de Network Analyst

Muestra de código

Ejemplo 1 de Indicaciones (ventana de Python)

Ejecute la herramienta Indicaciones con todos los parámetros.

arcpy.na.Directions("Route", "TEXT", "C:/Data/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 Directions para generar indicaciones de conducción en un archivo HTML para una ruta.

# Name: Directions_Workflow.py
# Description: Generate driving directions in a html 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"
    outNALayerName = "StoreRoute"
    impedanceAttribute = "TravelTime"
    startLocation = "Analysis/DistributionCenter"
    storeLocations = "Analysis/Stores"
    #fieldMappings = "Name Name #; Attr_TravelTime ServiceTime #"
    outDirectionsFile = "C:/data/output" + "/" + outNALayerName + "Directions.html"
    outLayerFile = "C:/data/output" + "/" + outNALayerName + ".lyr"
    
    #Create a new route layer. The route starts at the distribution center and 
    #takes the best sequence to visit the store locations.
    outNALayer = arcpy.na.MakeRouteLayer(inNetworkDataset, outNALayerName,
                                         impedanceAttribute, "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.
    outNALayer = outNALayer.getOutput(0)
    
    #Get the names of all the sublayers within the route layer.
    subLayerNames = arcpy.na.GetNAClassNames(outNALayer)
    #Stores the layer names that we will use later
    stopsLayerName = subLayerNames["Stops"]
    
    #Load the distribution center as the start location using default field 
    #mappings and search tolerance
    arcpy.na.AddLocations(outNALayer,stopsLayerName,startLocation,"","",
                          exclude_restricted_elements = "EXCLUDE")
    
    #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 using the field mappings
    fieldMappings = arcpy.na.NAClassFieldMappings(outNALayer, stopsLayerName)
    fieldMappings["Name"].mappedFieldName = "Name"
    fieldMappings["Attr_" + impedanceAttribute].mappedFieldName = "ServiceTime"
    arcpy.na.AddLocations(outNALayer, stopsLayerName, storeLocations,
                          fieldMappings, "", append="APPEND",
                          exclude_restricted_elements = "EXCLUDE")
    
    #Generate driving directions in a HTML file
    arcpy.na.Directions(outNALayer,"HTML",outDirectionsFile,"Miles",
                        "REPORT_TIME",impedanceAttribute)
    
    #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 occurred on line %i" % tb.tb_lineno
    print str(e)

Entornos

• Espacio de trabajo actual

Información sobre licencias

• Basic: Requiere Network Analyst
• Standard: Requiere Network Analyst
• Advanced: Requiere Network Analyst