Сводка
Загружает данные трафика из веб-сервиса и сохраняет их в файле формата динамического трафика (DTF). Наборы сетевых данных могут прочесть этот файл для анализа и отображения трафика в реальном режиме времени.
Использование
Чтобы этот инструмент мог загружать данные трафика, необходимо иметь учетную запись у одного из поставщиков данных, указанных в параметре Поставщик.
Запуск инструмента через регулярные промежутки времени или по расписанию гарантирует, что доступны самые свежие данные трафика. Один из распространенных способов настройки расписания запуска инструмента – использование Планировщика задач Windows для скрипта Python, который запускает этот инструмент.
Синтаксис
arcpy.na.UpdateTrafficData(provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age}, {speed_unit})| Параметр | Объяснение | Тип данных |
provider | Выберите название поставщика данных о происшествиях на дорогах и нужный регион.
| String |
user_name | Имя пользователя, предоставленное поставщиком данных, необходимое для загрузки данных трафика. Если имя пользователя не пройдет аутентификацию на стороне поставщика, то инструмент прекратит работу. Если в качестве параметра Провайдер указан TomTom North America или TomTom Europe, используйте значение "APIKEY". | String |
password | Пароль, предоставленный поставщиком данных, необходимый для загрузки данных трафика. Если пароль пользователя будет введен неверно, то инструмент прекратит работу. | Encrypted String |
regions [regions,...] | Введите необходимые регионы, для которых будут загружаться данные трафика. Чтобы загрузить все доступные регионы, введите "#". | String |
traffic_data_output_folder | Папка, в которой будет создан файл DTF. Если папка пуста, инструмент создает файл TrafficIndex.xml, а также файл DTF. В ходе последующих запусков инструмент обновляет файл TrafficIndex.xml и создает файл DTF. Если данные загружаются от нескольких поставщиков, для каждого из них необходимо указать отдельную папку. | Folder |
expected_update_interval | Промежуток времени в минутах, после которого загруженные данные трафика считаются устаревшими, а у поставщика появляются обновленные данные. По истечении этого времени рекомендуется перезапустить инструмент и загрузить свежие данные. | Long |
prediction_cutoff | Промежуток времени (в минутах), для которого инструмент обрабатывает данные прогноза. Поставщики данных могут предоставлять прогноз на ближайшие 24 часа, неделю или какой-либо другой промежуток времени. Значение этого промежутка времени используется для ограничения объема прогнозных данных трафика, обрабатываемых инструментом, чтобы ускорить его работу. Например, если глубина прогноза провайдера трафика равна 24 часам, а вам требуется глубина прогноза один час, то вы можете сэкономить время, указав здесь 60. | Long |
compress_data |
| Boolean |
maximum_file_age (Дополнительный) | Промежуток времени (в минутах), в течение которого файлы трафика (т. е. файлы DTF) будут храниться в выходной папке данных трафика. Этот параметр упрощает удаление ненужных файлов трафика. При перезапуске инструмента все файлы данных трафика, возраст которых превышает максимальное значение, автоматически удаляются. По умолчанию указано значение 720 минут (12 часов). | Long |
speed_unit (Дополнительный) | Единицы скорости при загрузке данных трафика из пользовательского канала данных трафика. Этот параметр игнорируется в том случае, если вы используете один из стандартных коммерческих каналов, документированных в параметре Поставщик.
Указание правильных единиц скорости пользовательских данных трафика обеспечивает правильную интерпретацию значений скорости в наборе сетевых данных. | String |
Пример кода
UpdateTrafficData, пример 1 (Окно Python)
Следующий скрипт окна Python демонстрирует, как использовать инструмент 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)
UpdateTrafficData, пример 2 (рабочий процесс)
В следующем автономном скрипте Python показано, как можно использовать инструмент UpdateTrafficData для загрузки от поставщика данных трафика в режиме реального времени. Скрипт можно запустить как задачу Планировщика Windows или как задание в Linux, чтобы данные трафика обновлялись через определенные промежутки времени.
# 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)
Параметры среды
Этот инструмент не использует параметры среды геообработки
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да