Straßentypaktualisierungen - 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

URL-Format von HTTP-POST-Anforderungen

Das folgende Format wird für HTTP POST-Anforderungen verwendet. HTTP POST wird verwendet, um ein Persistent Update für einen Straßentyp festzulegen.

HTTP POST:  /rest/Spatial/erm/databases/dbsource/persistentUpdates/roadTypes/roadtype.json?query_parameters

Dabei ist dbsource der Name der Datenbank zum Aktualisieren der Routendaten und roadtype der Typ der zu aktualisierenden Straße. Verwenden Sie den Datenbanknamen, der im Tool der Routing-Datenbankressource von Spectrum Spatial angegeben ist.

URL-Format von HTTP-GET-Anforderungen

Für HTTP-GET-Anforderungen wird das folgende Format verwendet. HTTP GET wird verwendet, um eine Liste von Persistent Updates für Straßentypen zurückzugeben.

HTTP GET:  /rest/Spatial/erm/databases/dbsource/persistentUpdates/roadTypes/road_type.json

oder

HTTP GET:  /rest/Spatial/erm/databases/dbsource/persistentUpdates/roadTypes.json?roadTypes=road_type

Dabei ist dbsource der Name der Datenbank, von der zu Persistent Updates zurückgekehrt werden soll, und roadtype der Typ der zurückgegebenen Straßenaktualisierungen.

Anmerkung: Das erste Format wird verwendet, um das Persistent Update nur für einen Straßentyp zurückzugeben. Das zweite Format wird verwendet, um entweder mehrere Straßentypen oder alle Straßentypen zurückzugeben. Verwenden Sie für mehrere Straßentypen eine durch Kommas getrennte Liste von Straßentypen. Verwenden Sie für alle Straßentypen einen leeren Parameter „roadtypes=“. Siehe dazu die Beispiele unten.

URL-Format von HTTP-DELETE-Anforderungen

Das folgende Format wird für HTTP DELETE-Anforderungen verwendet. HTTP DELETE wird verwendet, um ein bestimmtes Persistent Update für einen Straßentyp zu entfernen.

HTTP DELETE:  /rest/Spatial/erm/databases/dbsource/persistentUpdates/roadTypes/roadtype

Dabei ist dbsource der Name der Datenbank und roadtype der Straßentyp, der das zu entfernende Persistent Update enthält. Verwenden Sie den Datenbanknamen, der im Tool der Routing-Datenbankressource von Spectrum Spatial angegeben ist.

roadtype kann sowohl für HTTP POST als auch HTTP DELETE eines der folgenden Elemente sein:

  • Zugangsweg
  • Nebenstraße
  • Verbindungsstraße
  • Fähre
  • Fußweg
  • Zufahrtsbeschränkung, dicht, städtisch
  • Zufahrtsbeschränkung, ländlich
  • Zufahrtsbeschränkung, vorstädtisch
  • Zufahrtsbeschränkung, städtisch
  • Lokale Straße, dicht, städtisch
  • Lokale Straße, ländlich
  • Lokale Straße, vorstädtisch
  • Lokale Straße, städtisch
  • Lokale Hauptverkehrsstraße, dicht, städtisch
  • Lokale Hauptverkehrsstraße, ländlich
  • Lokale Hauptverkehrsstraße, vorstädtisch
  • Lokale Hauptverkehrsstraße, städtisch
  • Hauptverkehrsstraße, dicht, städtisch
  • Hauptverkehrsstraße, ländlich
  • Hauptverkehrsstraße, vorstädtisch
  • Hauptverkehrsstraße, städtisch
  • Lokale Nebenstraße, dicht, städtisch
  • Lokale Nebenstraße, ländlich
  • Lokale Nebenstraße, vorstädtisch
  • Lokale Nebenstraße, städtisch
  • Normale Straße, dicht, städtisch
  • Normale Straße, ländlich
  • Normale Straße, ländlich
  • Normale Straße, städtisch
  • Autobahn/Bundesstraße, dicht, städtisch
  • Autobahn/Bundesstraße, ländlich
  • Autobahn/Bundesstraße, vorstädtisch
  • Autobahn/Bundesstraße, städtisch
  • Auffahrt, dicht, städtisch
  • Auffahrt, Zufahrtsbeschränkung
  • Auffahrt Hauptverkehrsstraße
  • Auffahrt Autobahn/Bundesstraße
  • Auffahrt, ländlich
  • Auffahrt Landstraße
  • Auffahrt, städtisch
  • Auffahrt, vorstädtisch
  • Landstraße, dicht, städtisch
  • Landstraße, ländlich
  • Landstraße, vorstädtisch
  • Landstraße, städtisch

Abfrageparameter

Der HTTP POST-Vorgang unterstützt die folgenden Abfrageparameter.

Parameter Typ Erforderlich Beschreibung
velocity Zeichenfolge no Eine Geschwindigkeitsaktualisierung, bei der Sie die neue Geschwindigkeit des Straßentyps definieren, indem Sie die neue Geschwindigkeit angeben. Die Standardeinheit ist mph (Meilen pro Stunde), außer wenn Sie den Parameter velocityUnit festlegen.
velocityUnit Zeichenfolge no

Dies ist eine Geschwindigkeitseinheit für den Parameter velocity oder velocityAdjustment. Bei Geschwindigkeitsaktualisierungen kann die Geschwindigkeitseinheit einen der folgenden Werte haben: mph (Meilen pro Stunde) oder kph (Kilometer pro Stunde). Der Standardwert ist „mph“.
velocityAdjustment Zeichenfolge no Eine Geschwindigkeitsaktualisierung, bei der Sie eine Änderung der Geschwindigkeit des Straßentyps definieren, indem Sie die Änderung der Geschwindigkeit (Einheit und Wert) angeben. Geschwindigkeitswerte können erhöht (positiver Wert) oder verringert (negativer Wert) werden. Die Standardeinheit ist mph (Meilen pro Stunde), außer wenn Sie den Parameter velocityUnit festlegen.
velocityPercentage Ganze Zahl no Eine Geschwindigkeitsaktualisierung, bei der Sie eine Erhöhung der Geschwindigkeit des Straßentyps definieren, indem Sie einen Prozentsatz zur Erhöhung (positiver Wert) oder zur Verringerung (negativer Wert) der Geschwindigkeit angeben.

Beispiele

Neue Geschwindigkeit eines Straßentyps festlegen (HTTP POST)

http://<server>:<port>/rest/Spatial/erm/databases/usroutedatabase/persistentUpdates/roadTypes/ferry.json?velocity=5&velocityUnits=mph

Liste von Aktualisierungen für den Straßentyp „Fähre“ zurückgeben (HTTP GET)

http://<server>:<port>/rest/Spatial/erm/databases/US_NE/persistentUpdates/roadTypes/ferry.json?velocityUnit=kph

Liste aller Straßentypaktualisierungen für die Routing-Datenbankressource US_NE zurückgeben (HTTP GET)

http://<server>:<port>/rest/Spatial/erm/databases/US_NE/persistentUpdates/roadTypes.json?roadTypes=

Eine Liste von Aktualisierungen für die Straßentypen „Fähre“, „Verbindungsstraße“ und „Normale Straße, städtisch“ zurückgeben (HTTP GET)

http://<server>:<port>/rest/Spatial/erm/databases/US_NE/persistentUpdates/roadTypes.json?roadTypes=ferry,connector,normal road urban

Persistent Update für Straßentyp entfernen (HTTP DELETE)

http://<server>:<port>/rest/Spatial/erm/databases/US_NE/persistentUpdates/roadTypes/back road