ArcMap

Verkehrsdaten aktualisieren

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

arcpy.na.UpdateTrafficData(provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age}, {speed_unit})
ParameterErklärungDatentyp
provider

Wählen Sie den Namen des Verkehrsdatenanbieters und der Region aus.

  • HERE North America
  • HERE Europe
  • HERE South America
  • HERE Middle East & Africa
  • HERE Asia Pacific
  • TomTom North America
  • TomTom Europe
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
  • COMPRESS —Lädt die TrafficIndex.xml- und DTF-Dateien herunter und erstellt dann Kopien der DTF-Dateien in einem gezippten Ordner. Verwenden Sie diese Option, wenn Netzwerk-Datasets Verbindungen mit den Live-Verkehrsdaten über einen Geoverarbeitungs-Service herstellen – die Übertragung des gezippten Ordners von DTF-Dateien erfolgt schneller als die Übertragung der DTF-Dateien selbst.
  • NO_COMPRESS —Lädt die TrafficIndex.xml- und DTF-Dateien herunter, ohne Kopien von diesen in einem gezippten Ordner zu erstellen. Verwenden Sie diese Option, wenn Netzwerk-Datasets Verbindungen mit den Live-Verkehrsdaten über eine Ordnerverbindung herstellen. Dies ist der Standardwert.
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.

  • MPH —Meilen pro Stunde. Dies ist die Standardeinstellung.
  • KPH —Kilometer pro Stunde.

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

Verwandte Themen