Обновить данные трафика (Update Traffic Data) (Network Analyst)

Уровень лицензии:BasicStandardAdvanced

Краткая информация

Загружает данные трафика из веб-сервиса и сохраняет их в файле формата динамического трафика (DTF). Наборы сетевых данных могут прочесть этот файл для анализа и отображения трафика в реальном режиме времени.

Использование

Синтаксис

UpdateTrafficData_na (provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age}, {Speed_Unit})
ПараметрОбъяснениеТип данных
provider

Выберите название поставщика данных трафика. Инструмент поддерживает загрузку данных трафика от следующих поставщиков:

  • NAVTEQ North America
  • NAVTEQ Europe
  • NAVTEQ South America
  • NAVTEQ Oceania
  • NAVTEQ Middle East & Africa
  • NAVTEQ India
  • NAVTEQ South East Asia
  • TomTom North America
  • TomTom Europe
  • INRIX
  • INRIX California

String
user_name

Имя пользователя, предоставленное поставщиком данных, необходимое для загрузки данных трафика. Если имя пользователя не пройдет аутентификацию на стороне поставщика, то инструмент прекратит работу.

Если в качестве параметра Провайдер (Provider) указан TomTom North America или TomTom Europe, используйте значение "APIKEY".

String
password

Пароль, предоставленный поставщиком данных, необходимый для загрузки данных трафика. Если пароль пользователя будет введен неверно, то инструмент прекратит работу.

Encrypted String
regions
[regions,...]

Введите необходимые регионы, для которых будут загружаться данные трафика. Чтобы загрузить все доступные регионы, введите "#".

String
traffic_data_output_folder

Папка, в которой будет создан файл DTF. Если папка пуста, инструмент создает файл DTF, а также файл TrafficIndex.xml. В ходе последующих запусков инструмент обновляет файл TrafficIndex.xml и создает файл DTF.

Если данные загружаются от нескольких поставщиков, для каждого из них необходимо указать отдельную папку.

Folder
expected_update_interval

Промежуток времени в минутах, после которого загруженные данные трафика считаются устаревшими, а у поставщика появляются обновленные данные. По истечении этого времени рекомендуется перезапустить инструмент и загрузить свежие данные.

Long
prediction_cutoff

Промежуток времени (в минутах), для которого инструмент обрабатывает данные прогноза. Поставщики данных могут предоставлять прогноз на ближайшие 24 часа, неделю или какой-либо другой промежуток времени. Значение этого промежутка времени используется для ограничения объема прогнозных данных трафика, обрабатываемых инструментом, чтобы ускорить его работу. Например, если глубина прогноза провайдера трафика равна 24 часам, а вам требуется глубина прогноза один час, то вы можете сэкономить время, указав здесь 60.

Long
compress_data
  • COMPRESSЗагружает файлы DTF и TrafficIndex.xml, после чего создает копии файлов DTF в архивированной папке. Используйте эту опцию, если наборы сетевых данных подключаются к данным трафика в режиме реального времени через сервис геообработки. Передать архивированную папку с файлами DTF быстрее, чем передавать сами файлы.
  • NO_COMPRESSЗагружает файлы DTF и TrafficIndex.xml без создания их копий в архивированной папке. Используйте эту опцию, если наборы сетевых данных подключаются к данным трафика в режиме реального времени через подключение папки. Это значение выбрано по умолчанию.
Boolean
maximum_file_age
(дополнительно)

Промежуток времени (в минутах), в течение которого файлы трафика (т. е. файлы DTF) будут храниться в выходной папке данных трафика. Этот параметр упрощает удаление ненужных файлов трафика. При перезапуске инструмента все файлы данных трафика, возраст которых превышает максимальное значение, автоматически удаляются. По умолчанию указано значение 720 минут (12 часов).

Long
Speed_Unit
(дополнительно)

Единицы скорости при загрузке данных трафика из пользовательского канала данных трафика. Этот параметр игнорируется, если вы используете один из стандартных коммерческих каналов, документированных в параметре Поставщик (Provider)

  • миль/чМиль в час. Это значение выбрано по умолчанию.
  • км/чКилометров в час

Указание правильных единиц скорости пользовательских данных трафика обеспечивает правильную интерпретацию значений скорости в наборе сетевых данных.

String

Пример кода

Обновить данные трафика UpdateTrafficData. Пример 1 (Окно Python)

В следующем скрипте окна Python показано, как использовать инструмент Обновить данные трафика (Update Traffic Data).

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 показано, как можно использовать инструмент Обновить данные трафика (Update Traffic Data) для загрузки от поставщика данных трафика в режиме реального времени. Скрипт можно запустить как задачу Планировщика 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 occured on line %i" % tb.tb_lineno
    print str(e)

Параметры среды

Этот инструмент не использует параметры среды геообработки

Связанные темы

Информация о лицензировании

ArcGIS for Desktop Basic: Да
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
5/10/2014