PersistentUpdate - web_services - 23 - 23.1

Spectrum-Webdienste-Handbuch
Product type
Software
Portfolio
Integrate
Product family
Spectrum™ software
Product
Spectrum™ software > Web Services
Version
23.1
ft:locale
de-DE
Product name
Spectrum Technology Platform
ft:title
Spectrum-Webdienste-Handbuch
First publish date
2007
ft:lastEdition
2023-10-25
ft:lastPublication
2023-10-25T07:20:03.279000

Beschreibung

Mit dem PersistentUpdate-Dienst kann ein Benutzer Aspekte des Netzwerks außer Kraft setzen. Die Außerkraftsetzungen können pro Straßentyp, an einem bestimmten Punkt oder bei einem bestimmten Segment, durchgeführt werden. Das Persistent Update gilt nur für eine angegebene Datenressource und könnte nach einer Datenaktualisierung nicht mehr gültig sein.

Bei Verwendung von Persistent Updates zum Durchführen von Änderungen dieser Art haben Sie folgende Möglichkeiten:

  • Ausschließen eines Punktes
  • Ausschließen eines Segments
  • Festlegen der Geschwindigkeit eines Punktes, Segments oder Straßentyps
  • Ändern (Erhöhen oder Verringern) der Geschwindigkeit eines Punktes, Segments oder Straßentyps durch einen Wert
  • Ändern (Erhöhen oder Verringern) der Geschwindigkeit eines Punktes, Segments oder Straßentyps durch einen Prozentsatz
  • Auflisten von Persistent Updates
Anmerkung: Da bei Persistent Updates systemweite Änderungen an Routenführungsdaten vorgenommen werden und alle Aktualisierungen persistent sind, sollten diese mit Vorsicht verwendet werden. Die Antwort vom REST-Dienst ist eine Erfolgsnachricht. Wenn eine Anforderung ungültige Abfrageparameter in der GET URL oder eine ungültige Nutzlast für POST enthält, wird eine gesammelte Fehlerantwort in einem JSON-Array zurückgegeben. Der Knoten value in der Antwort-JSON ist veraltet. Bei der Fehlerüberprüfung sollte nur der Knoten errors verwendet werden.

Versionsspezifische Fehlerreaktion

Wenn Sie in einem Auftrag einen ungültigen Parameterwert (z. B. mehrere Aktualisierungen) eingeben, hängt die Fehlerreaktion von der von Ihnen angegebenen Version ab. Wenn die Version 1 ist, erhalten Sie Wert und Fehler. Wenn dahingegen die Version 2 ist, enthält die Antwort nur den Fehler.

  • Abfrage, wenn version 1 ist:
    http://<server>:<port>/rest/Spatial/erm/databases/usroutedatabase.json? velocity=15.912&velocityUnit=KPH&velocityAdjustment=34&velocityPercentage=56&version=1
  • Antwort:
    {   "value": "One of either Velocity or SpeedIncrease or SpeedDecrease is expected.",   "errors": [     {       "errorCode": 3733,       "userMessage": "One of either Velocity or SpeedIncrease or SpeedDecrease is expected."     }   ] }
  • Abfrage, wenn version 2 ist:
    http://<server>:<port>/rest/Spatial/erm/databases/usroutedatabase.json? velocity=15.912&velocityUnit=KPH&velocityAdjustment=34&velocityPercentage=56&version=2
  • Antwort: 
    {   "errors": [     {       "errorCode": 3733,       "userMessage": "One of either Velocity or SpeedIncrease or SpeedDecrease is expected."     }   ] }

Typen von Persistent Updates

In den folgenden Abschnitten finden Sie Informationen zu und Beispiele für die Anforderungstypen von Persistent Updates: