Zusammenfassung
Erstellt eine Point-Feature-Class mit Live-Verkehrsereignisdaten von einem Web-Service. Zu Verkehrsereignissen zählen beispielsweise Unfälle und Baustellen.
Verwendung
Sie benötigen ein Konto bei einem der im Parameter Provider aufgeführten Datenanbieter, bevor Sie mit diesem Werkzeug Verkehrsdaten herunterladen können.
Wenn Sie dieses Werkzeug mehrmals mit demselben Ausgabe-Workspace und demselben Feature-Class-Namen ausführen, werden alle vorherigen Features gelöscht, bevor neue erstellt werden.
Syntax
UpdateTrafficIncidents(provider, user_name, password, regions, incidents_feature_class_location, incidents_feature_class_name, {time_zone_boundaries}, {time_zone_id_field})
Parameter | Erklärung | Datentyp |
provider | Wählen Sie den Namen des Anbieters von Verkehrsereignisdaten und der Region aus.
| String |
user_name | Der Benutzername, der vom Datenanbieter zum Herunterladen der Verkehrsereignisdaten autorisiert wurde. Das Werkzeug kann nicht ausgeführt werden, wenn der Benutzername vom Datenanbieter nicht authentifiziert werden kann. Wenn der Parameter Provider TomTom North America oder TomTom Europe lautet, verwenden Sie als Parameterwert APIKEY. | String |
password | Das vom Datenanbieter angegebene Kennwort zum Herunterladen der Verkehrsereignisdaten autorisiert wurde. Das Werkzeug kann nicht ausgeführt werden, wenn das Kennwort vom Datenanbieter nicht authentifiziert werden kann. | Encrypted String |
regions [regions,...] | Geben Sie die Regionen ein, für die Sie Verkehrsereignisdaten herunterladen möchten. Zum Herunterladen aller verfügbaren Regionen geben Sie "#" ein. | String |
incidents_feature_class_location | Die Geodatabase, in der die Ausgabe-Feature-Class erstellt wird. Dieser Workspace muss bereits vorhanden sein. | Workspace; Feature Dataset |
incidents_feature_class_name | Der Name der zu erstellenden Feature-Class. Wenn das Werkzeug bereits ausgeführt wurde und die Feature-Class bereits vorhanden ist, werden vorhandene Features gelöscht und anhand der aktuellen Ereignisdaten neue erstellt. | String |
time_zone_boundaries (optional) | Die Polygon-Feature-Class, deren Features Zeitzonen begrenzen. Durch Bereitstellen dieser Feature-Class können Ereignisse, die innerhalb der Zeitzonengrenzen auftreten, in lokaler Zeit angegeben werden und nicht nur in koordinierter Weltzeit (Coordinated Universal Time, UTC). Wenn Sie keine Feature-Class für Zeitzonengrenzen bereitstellen, können die Anfangs- und Endzeiten für Ereignisse nur in koordinierter Weltzeit (Coordinated Universal Time, UTC) angegeben werden, allen Feldern für die lokale Zeit werden NULL-Werte zugewiesen. In manchen Fällen weisen Ereignisse aus Verkehrs-Feeds, z. B. Wetterereignisse, NULL-Geometrien auf. In diesem Fall werden den Feldern für die lokale Zeit auch dann NULL-Werte zugewiesen, wenn die Feature-Class für Zeitzonengrenzen bereitgestellt wurde. Wenn Sie eine Feature-Class für Zeitzonengrenzen bereitstellen, müssen Sie auch die Feldeigenschaft für die Zeitzonen-ID festlegen. | Feature Layer |
time_zone_id_field (optional) | Das Textfeld aus der Feature-Class für Zeitzonengrenzen, das die Zeitzonenkennungen von Windows enthält. Die Werte in diesem Feld entsprechen den Zeitzonenschlüsseln in der Windows-Registrierung. Mit ähnlichen Schritten wie den im Thema Hinzufügen von Zeitzonen zu einem Netzwerk-Dataset beschriebenen finden Sie die richtigen Zeitzonennamen für die Polygone in Ihrer Eingabe-Feature-Class. | Field |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
traffic_incidents | Die Ausgabe-Verkehrsereignisse. | Feature-Layer |
update_succeeded | Gibt an, ob die Aktualisierung erfolgreich war. | Boolesch |
Codebeispiel
UpdateTrafficIncidents – Beispiel 1 (Python-Fenster)
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs UpdateTrafficIncidents im Python-Fenster.
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 – Beispiel 2 (Workflow)
Das folgende eigenständige Python-Skript beschreibt, wie Sie mit dem Werkzeug UpdateTrafficIncidents Verkehrsereignisse als Feature-Class in eine Enterprise-Geodatabase herunterladen. Das Skript kann als geplanter Windows-Task oder als cron-Auftrag unter Linux ausgeführt werden, sodass die Verkehrsereignisse regelmäßig aktualisiert werden. Die Feature-Class kann zum Veröffentlichen eines Feature-Service verwendet werden.
# 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)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja