Zusammenfassung
Lädt Live-Verkehrsdaten von einem Web-Service herunter und speichert diese in einer dynamischen Verkehrsformatdatei (DTF), d. h. einer Datei, die Netzwerk-Datasets zur Analyse und Anzeige des Live-Verkehrs lesen können.
Verwendung
Sie benötigen ein Konto bei einem der im Parameter "Provider" aufgeführten Datenanbieter, bevor Sie mit diesem Werkzeug Verkehrsdaten herunterladen können.
Durch Planung der regelmäßigen oder strategisch gesetzten Ausführung dieses Werkzeugs können Sie sicherstellen, dass die neuesten Verkehrsdaten verfügbar sind. Eine häufig verwendete Planungsmethode besteht in der Verwendung des Windows-Taskplanerdienstes in einem Python-Skript zum Aufrufen dieses Werkzeugs.
Syntax
UpdateTrafficData(provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age}, {speed_unit})
Parameter | Erklärung | Datentyp |
provider | Wählen Sie den Namen des Verkehrsdatenanbieters und der Region aus.
| String |
user_name | Der Benutzername, der vom Datenanbieter zum Herunterladen der Verkehrsdaten 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 Verkehrsdaten. 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 Verkehrsdaten herunterladen möchten. Zum Herunterladen aller verfügbaren Regionen geben Sie "#" ein. | String |
traffic_data_output_folder | Der Ordner, in dem die DTF-Datei erstellt wird. Wenn der Ordner leer ist, wird vom Werkzeug zusammen mit der DTF-Datei die Datei TrafficIndex.xml erstellt. Beim späteren Ausführen des Werkzeugs wird TrafficIndex.xml vom Werkzeug aktualisiert und eine DTF-Datei erstellt. Wenn Sie Daten von mehreren Datenanbietern herunterladen, muss für jeden Datenanbieter ein eindeutiger Ordner angegeben werden. | Folder |
expected_update_interval | Das Zeitintervall in Minuten, nach dem die heruntergeladenen Verkehrsdaten nicht mehr aktuell sind und der Datenanbieter aktualisierte Daten verfügbar macht. Es wird empfohlen, das Werkzeug nach Ablauf dieses Intervalls erneut auszuführen und die neuesten Daten herunterzuladen. | Long |
prediction_cutoff | Das Zeitintervall (in Minuten), für das die Verkehrsvorhersagedaten vom Werkzeug verarbeitet werden. Datenanbieter können Vorhersagedaten für die nächsten 24 Stunden, die nächste Woche oder einen anderen Zeitraum bereitstellen. Der Zeitspannenwert für diesen Parameter wird zum Begrenzen der Menge der vom Werkzeug zu verarbeitenden Verkehrsvorhersagedaten verwendet, um die Ausführung des Werkzeugs zu beschleunigen. Wenn der Verkehrsdatenanbieter beispielsweise eine Vorhersagetiefe von 24 Stunden hat, Sie jedoch nur eine Vorhersagetiefe von einer Stunde benötigen, können Sie Zeit sparen, indem Sie hier 60 angeben. | Long |
compress_data |
| Boolean |
maximum_file_age (optional) | Das Zeitintervall (in Minuten), für das die Verkehrsdaten (d. h. die DTF-Dateien) im Ausgabeordner für Verkehrsdaten gespeichert werden. Dieser Parameter erleichtert das Löschen nicht mehr benötigter Verkehrsdateien. Wenn das Werkzeug erneut ausgeführt wird, werden sämtliche Datendateien, die das maximale Dateialter überschritten haben, automatisch gelöscht. Der Standardwert beträgt 720 Minuten (12 Stunden). | Long |
speed_unit (optional) | Die Geschwindigkeitseinheiten beim Herunterladen von Daten aus einem benutzerdefinierten Verkehrs-Feed. Dieser Parameter wird ignoriert, wenn Sie einen der standardmäßigen kommerziellen Feeds verwenden, die im Parameter Anbieter dokumentiert sind.
Durch die Angabe der richtigen Geschwindigkeitseinheiten eines benutzerdefinierten Verkehrs-Feeds wird sichergestellt, dass die Geschwindigkeitswerte vom Netzwerk-Dataset richtig interpretiert werden. | String |
Codebeispiel
UpdateTrafficData – Beispiel 1 (Python-Fenster)
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs UpdateTrafficData im Python-Fenster.
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 – Beispiel 2 (Workflow)
Das folgende eigenständige Python-Skript beschreibt, wie Sie mit dem Werkzeug UpdateTrafficData Live-Verkehrsdaten von einem Anbieter herunterladen. Das Skript kann als geplanter Windows-Task oder als cron-Auftrag unter Linux ausgeführt werden, sodass die Live-Verkehrsdaten regelmäßig aktualisiert werden.
# 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)
Umgebungen
Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja