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 una secuencia de comandos de Python que invoca esta herramienta.
Sintaxis
UpdateTrafficData_na (provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age}, {speed_unit})| Parámetro | Explicación | Tipo de datos |
provider | Elija el nombre de su proveedor de datos de tráfico y la región.
| 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 |
| 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.
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)
La siguiente secuencia de comandos 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 la siguiente secuencia de comandos 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. La secuencia de comandos 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 sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí