Résumé
Télécharge les données de Trafic temps réel d’un service web et les stocke dans un fichier DTF (dynamic traffic format) que les jeux de données réseau peuvent lire pour l’analyse et l’affichage du trafic Temps réel.
Utilisation
Vous avez besoin d'un compte auprès de l'un des fournisseurs de données répertoriés dans le paramètre Fournisseur pour que cet outil puisse télécharger les données de trafic.
En planifiant cet outil de manière qu'il soit exécuté à des intervalles réguliers ou à des moments stratégiques, vous pouvez vérifier que les dernières données de trafic sont disponibles. L'une des méthodes les plus courantes de planification est le Planificateur de tâches de Windows dans un script Python qui appelle cet outil.
Syntaxe
arcpy.na.UpdateTrafficData(provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age}, {speed_unit})| Paramètre | Explication | Type de données |
provider | Choisissez le nom du fournisseur de données de trafic et la région.
| String |
user_name | Nom d'utilisateur autorisé par le fournisseur de données pour télécharger les données de trafic. L'outil ne s'exécute pas si le nom d'utilisateur ne peut pas être authentifié par le fournisseur de données. Si le paramètre Fournisseur est TomTom Amérique du Nord ou TomTom Europe, utilisez "APIKEY" comme valeur de paramètre. | String |
password | Mot de passe fourni par le fournisseur de données pour télécharger les données de trafic. L'outil ne s'exécute pas si le mot de passe ne peut pas être authentifié par le fournisseur de données. | Encrypted String |
regions [regions,...] | Saisissez les régions pour lesquelles vous souhaitez télécharger les données de trafic. Pour télécharger toutes les régions disponibles, entrez "#". | String |
traffic_data_output_folder | Dossier dans lequel le fichier DTF sera créé. Si le dossier est vide, l'outil crée un fichier TrafficIndex.xml avec le fichier DTF. Lors des exécutions suivantes de l'outil, celui-ci met à jour TrafficIndex.xml et crée un fichier DTF. Si vous téléchargez des données provenant de plusieurs fournisseurs, spécifiez un dossier unique pour chaque fournisseur. | Folder |
expected_update_interval | Intervalle de temps, exprimé en minutes, après lequel les données de trafic téléchargées ne sont plus à jour et après lequel le fournisseur fournit des données actualisées. Une fois ce laps de temps écoulé, il est recommandé d'exécuter à nouveau l'outil et de télécharger les données les plus récentes. | Long |
prediction_cutoff | Intervalle (en minutes) pendant lequel les données de trafic de prévision sont traitées par l'outil. Les fournisseurs de données peuvent fournir des données de prévision pour les 24 heures à venir, la semaine à venir ou une autre période. La valeur temporelle de ce paramètre permet de limiter la quantité de données de trafic de prévision traitée par l'outil pour accélérer l'exécution de l'outil. Par exemple, si votre fournisseur de données de trafic a une profondeur de prévision de 24 heures mais que vous avez seulement besoin d'une profondeur d'une heure, vous pouvez gagner du temps en spécifiant 60 ici. | Long |
compress_data |
| Boolean |
maximum_file_age (Facultatif) | Intervalle (en minutes) pendant lequel les fichiers de trafic (c'est-à-dire les fichiers DTF) sont conservés dans le dossier de données de trafic en sortie. Ce paramètre facilite la suppression des fichiers de trafic qui ne sont plus nécessaires. Lorsque l'outil est exécuté à nouveau, tous les fichiers de données de trafic plus anciens que l'âge maximal des fichiers sont supprimés automatiquement. La valeur par défaut est de 720 minutes, soit 12 heures. | Long |
speed_unit (Facultatif) | Unités de vitesse lors du téléchargement de données à partir d'un flux de trafic personnalisé. Ce paramètre est ignoré si vous utilisez un des flux commerciaux standard documentés dans le paramètre Fournisseur.
Si vous spécifiez les unités de vitesse appropriées d'un flux de trafic personnalisé, le jeu de données réseau interprète correctement les valeurs de vitesse. | String |
Exemple de code
Exemple 1 d'utilisation de l'outil Mettre à jour les données de trafic (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil UpdateTrafficData.
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)
Exemple 2 d'utilisation de l'outil Mettre à jour les données de trafic (workflow)
Le script Python autonome suivant montre comment l'outil UpdateTrafficData permet de télécharger des données de trafic dynamique provenant d'un fournisseur. Le script peut être exécuté en tant que Planificateur de tâches de Windows ou que script planifié sous Linux, de manière que les données de trafic dynamique sont mises à jour à intervalles réguliers.
# 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)
Environnements
Cet outil n'utilise pas d’environnement de géotraitement.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui