Сводка
Создает класс точечных объектов, содержащий данные об инцидентах трафика в режиме реального времени с веб-сервиса. Инцидентами могут быть такие события, как дорожное строительство и аварии.
Использование
Чтобы этот инструмент мог загружать данные трафика, необходимо иметь учетную запись у одного из поставщиков данных, перечисленных в параметре Поставщик.
Если неоднократно запускать инструмент, используя одну и ту же выходную рабочую область и имя класса пространственных объектов, все предыдущие объекты удаляются, после чего создаются новые.
Синтаксис
arcpy.na.UpdateTrafficIncidents(provider, user_name, password, regions, incidents_feature_class_location, incidents_feature_class_name, {time_zone_boundaries}, {time_zone_id_field})
Параметр | Объяснение | Тип данных |
provider | Выберите название поставщика данных о происшествиях на дорогах и нужный регион.
| String |
user_name | Имя пользователя, предоставленное поставщиком данных, необходимое для загрузки данных об инцидентах. Если имя пользователя не пройдет аутентификацию на стороне поставщика, то инструмент прекратит работу. Если в качестве параметра Поставщик указан TomTom North America или TomTom Europe, используйте значение APIKEY в качестве значения параметра. | String |
password | Пароль, предоставленный поставщиком данных, необходимый для загрузки данных об инцидентах. Если пароль пользователя будет введен неверно, то инструмент прекратит работу. | Encrypted String |
regions [regions,...] | Введите регионы, для которых будут загружаться данные об инцидентах. Чтобы загрузить все доступные регионы, введите "#". | String |
incidents_feature_class_location | База геоданных, в которой будет создан выходной класс объектов. Рабочая область должна существовать. | Workspace; Feature Dataset |
incidents_feature_class_name | Имя создаваемого класса пространственных объектов. Если инструмент уже запускался, и класс пространственных объектов уже существует, инструмент удалит существующие объекты и создаст новые на основе самых свежих данных об инцидентах. | String |
time_zone_boundaries (Дополнительный) | Полигональный класс пространственных объектов, объекты которого определяют часовые пояса. При предоставлении этого класса пространственных объектов инциденты, которые происходили внутри границ часового пояса, могут отображаться в формате местного времени, а не только в формате времени по Гринвичу (UTC). Если класс объектов границ часовых поясов не предоставлен, время начала и завершения инцидентов будет отображаться только в формате времени по Гринвичу (UTC), полям местного времени будет присвоено значение null. Иногда у определенных инцидентов, полученных от поставщиков (например, метеорологические явления), отсутствует геометрия (null). В этом случае полям местного времени будет присвоено значение null, даже если предоставлен класс пространственных объектов границ часовых поясов. При предоставлении класса пространственных объектов границ часовых поясов необходимо задать свойство Поле ID часового пояса. | Feature Layer |
time_zone_id_field (Дополнительный) | Текстовое поле из класса пространственных объектов границ часовых поясов, содержащее кодовые обозначения часовых поясов в системе Windows. Значения в этом поле соответствуют ключам часовых поясов в реестре Windows. Чтобы узнать, как найти правильные названия часовых поясов для полигонов во входном классе пространственных объектов, см. раздел Добавление часовых поясов в набор сетевых данных. | Field |
Производные выходные данные
Имя | Объяснение | Тип данных |
traffic_incidents | Выходные инциденты трафика. | Векторный слой |
update_succeeded | Успешность выполнения. | Логические |
Пример кода
UpdateTrafficIncidents, пример 1 (Окно Python)
Следующий скрипт окна Python демонстрирует, как использовать инструмент UpdateTrafficIncidents.
import arcpy
arcpy.na.UpdateTrafficIncidents("NAVTEQ North America", "myUserName",
"myPassword",
["New England", "New York/Northern NJ/Connecticut"],
"C:/Data/Traffic.gdb","Traffic_Incidents",
"C:/data/TimeZones.gdb/NATimeZones", "MSTIMEZONE")
UpdateTrafficIncidents, пример 2 (рабочий процесс)
В следующем автономном скрипте Python показано, как использовать инструмент UpdateTrafficIncidents для загрузки инцидентов в виде класса пространственных объектов в многопользовательскую базу геоданных. Скрипт можно запустить как задачу Планировщика Windows или как задание в Linux, чтобы инциденты обновлялись через определенные промежутки времени. Класс пространственных объектов может использоваться для публикации сервиса объектов.
# Name: UpdateTrafficIncidents_Workflow.py
# Description: Downloads traffic incidents as a feature class in an ArcSDE
# geodatabase. The script can be run as a Windows Scheduler Task or
# a cron job on Linux so that the traffic incidents are updated at
# regular intervals. The feature class can be used to publish a
# feature service.
#Import system modules
import arcpy
from arcpy import env
#Set local variables
trafficIncidentsStorage = "C:/data/TrafficIncidentsStorage.sde"
incidentsFeatureClass = "NAVTEQ_NorthAmerica_Incidents"
provider = "NAVTEQ North America"
username = "Replace with your username"
password = "Replace with your password"
#download data for all regions
regions = "#"
timeZoneBoundaries = "C:/data/TimeZones.gdb/NATimeZones"
timeZonesID = "MSTIMEZONE"
try:
#Update Traffic Data. Use default values for remaining parameters
arcpy.na.UpdateTrafficIncidents(provider,username,password, regions,
trafficIncidentsStorage, incidentsFeatureClass,
timeZoneBoundaries, timeZonesID)
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: Да