ArcMap

Actualizar datos de tráfico

Resumen

Descarga los datos de tráfico en vivo de un servicio Web y los almacena en un archivo de formato de tráfico dinámico (DTF), que es un archivo que los datasets de red pueden leer para conocer el análisis y visualización del tráfico en vivo.

Uso

  • Debe tener una cuenta con uno de los proveedores de datos enumerados en el parámetro del Proveedor antes de que esta herramienta pueda descargar datos de tráfico.

  • Al programar esta herramienta para que se ejecute en intervalos regulares o tiempos estratégicos, puede garantizar que estén disponibles los últimos datos del tráfico. Un método común de programación es utilizar el Programador de tareas de Windows en un script de Python que invoca esta herramienta.

Sintaxis

arcpy.na.UpdateTrafficData(provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age}, {speed_unit})
ParámetroExplicaciónTipo de datos
provider

Elija el nombre de su proveedor de datos de tráfico y la región.

  • HERE North America
  • HERE Europe
  • HERE South America
  • HERE Middle East & Africa
  • HERE Asia Pacific
  • TomTom North America
  • TomTom Europe
String
user_name

El nombre de usuario autorizado por el proveedor de datos para descargar datos de tráfico. La herramienta no se puede ejecutar si el nombre de usuario no puede ser autentificado por el proveedor de datos.

Si el parámetro Proveedor es TomTom Norteamérica o TomTom Europa, utilice "APIKEY" como el valor de parámetro.

String
password

La contraseña proporcionada por el proveedor de datos para descargar datos de tráfico. La herramienta no se puede ejecutar si la contraseña no puede ser autentificada por el proveedor de datos.

Encrypted String
regions
[regions,...]

Introduzca las regiones para las que desea descargar los datos del tráfico. Para descargar todas las regiones disponibles, introduzca " #".

String
traffic_data_output_folder

La carpeta en la que se creará el archivo DTF. Si la carpeta está vacía, la herramienta crea un archivo TrafficIndex.xml junto con el archivo DTF. Para ejecuciones subsiguientes de la herramienta, la herramienta actualiza TrafficIndex.xml y crea un archivo DTF.

Si usted descarga datos de varios proveedores de datos, se debe especificar una carpeta única para cada proveedor de datos.

Folder
expected_update_interval

El intervalo de tiempo en minutos después de que los datos de tráfico descargados ya no están actualizados y el proveedor de datos pone a su disposición datos actualizados. Después de que ha transcurrido este intervalo, se recomienda que vuelva a ejecutar la herramienta y descargue los datos más recientes.

Long
prediction_cutoff

El intervalo de tiempo (en minutos) para el cual la herramienta procesa los datos predictivos de tráfico. Los proveedores de datos pueden suministrar datos predictivos para las próximas 24 horas, para la semana siguiente o para otro intervalo de tiempo. El valor de intervalo de tiempo de este parámetro se utiliza para limitar la cantidad de datos de tráfico predictivos que procesa la herramienta para acelerar su ejecución. Por ejemplo, si el proveedor de tráfico tiene una profundidad de predicción de 24 horas, pero solo necesita una profundidad de predicción de una hora, puede ahorrar tiempo especificando 60 aquí.

Long
compress_data
  • COMPRESS —Descarga los archivos TrafficIndex.xml y archivos DTF, luego crea copias de los archivos DTF en una carpeta comprimida. Utilice esta opción si los datasets de red se conectarán a los datos de tráfico en vivo a través de un servicio de geoprocesamiento; la transferencia de la carpeta comprimida de archivos DTF es más rápida que la transferencia de los archivos DTF en sí.
  • NO_COMPRESS —Descarga los archivos TrafficIndex.xml y archivos DTF sin crear copias de los archivos en una carpeta comprimida. Utilice esta opción si los datasets de red se conectarán a los datos de tráfico en vivo a través de una conexión a carpetas. Este es el valor predeterminado.
Boolean
maximum_file_age
(Opcional)

El intervalo de tiempo (en minutos) para el que los archivos de tráfico (es decir, los archivos DTF) se mantendrán en la carpeta de salida de datos de tráfico. Este parámetro permite eliminar los archivos de tráfico que ya no son necesarios. Cuando la herramienta se vuelve a ejecutar, los archivos de datos de tráfico que superen la antigüedad máxima del archivo se eliminan automáticamente. El valor predeterminado es 720 minutos (12 horas).

Long
speed_unit
(Opcional)

Unidades de velocidad que se utilizan cuando se descargan datos de un feed de tráfico personalizado. Si se utiliza uno de los feeds estándar comerciales documentados en el parámetro Proveedor, este parámetro se pasa por alto.

  • MPH —Millas por hora. Esta es la opción predeterminada.
  • KPH —Kilómetros por hora.

Especificar las unidades de velocidad adecuada de un feed personalizado de tráfico garantiza que el dataset de red interprete correctamente los valores de la velocidad.

String

Muestra de código

Ejemplo 1 de UpdateTrafficData (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta UpdateTrafficData.

import arcpy
arcpy.na.UpdateTrafficData("NAVTEQ North America", "myUserName", "myPassword",
                           ["New England", "New York/Northern NJ/Connecticut"],
                           "d:/data/dtfs", 15, 120,"NO_COMPRESS", 720)
Ejemplo 2 de UpdateTrafficData (flujo de trabajo)

En el siguiente script independiente de Python se describe cómo se puede utilizar la herramienta UpdateTrafficData para descargar los datos de tráfico en vivo de un proveedor. El script se puede ejecutar como un Programador de tareas de Windows o un trabajo cron en Linux para que los datos de tráfico en vivo se actualicen en intervalos regulares.

# Name: UpdateTrafficData_Workflow.py
# Description: Downloads live traffic data from a provider. The script can be run
#              as a Windows Scheduler Task or a cron job on Linux so that the 
#              live traffic data is updated at regular intervals. 

#Import system modules
import arcpy

#Set local variables
trafficDataFolder = "C:/data/TrafficData"
provider = "NAVTEQ North America"
username = "Replace with your username"
password = "Replace with your password"
#download data for all regions
regions = "#"

try:
    #Update Traffic Data. Use default values for remaining parameters
    arcpy.na.UpdateTrafficData(provider,username,password, regions,
                               trafficDataFolder)

    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

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados