URL-Format von HTTP-POST-Anforderungen
Zusätzlich zu den regulären HTTP-GET-Parametern können Sie eine HTTP-POST-Nutzlastoption zu Ihrer Anforderung hinzufügen, in denen Änderungen der Umgebungsgeschwindigkeit für Straßentypen angegeben werden. Der Inhaltstyp muss auf „application/json“ festgelegt werden. Für HTTP-POST-Anforderungen wird das folgende Format verwendet:
HTTP POST: /rest/Spatial/erm/databases/dbsource.json?q=travelBoundary&query_parameters POST BODY: Content-Type:application/json {Route Data} Umgebungsgeschwindigkeiten
Diese Einstellungen ermöglichen es Ihnen, für jede Anforderung Änderungen der Umgebungsgeschwindigkeit festzulegen. Eine Umgebungsgeschwindigkeit stellt die Änderung der Geschwindigkeit in den normalen Daten dar, in der ein Straßennetzwerk bei der Suche nach der Fahrtgrenze verlassen wird. Zu Beispielen für Fahrten außerhalb des Netzwerks zählen Einfahrten und Zugangsstraßen. Im Folgenden wird eine Beschreibung der Parameter für die Umgebungsgeschwindigkeit dargestellt:
|
Parameter |
Beschreibung |
|---|---|
|
DefaultAmbientSpeed |
Gibt die Fahrtgeschwindigkeit bei Verlassen eines Straßennetzes an, um die Fahrtgrenze zu suchen (bei allen Straßentypen). Um zu steuern, wie Fahrten außerhalb des Netzwerks bei der Berechnung der Fahrtgrenze verwendet werden, müssen Sie die Fahrtgeschwindigkeit außerhalb des Straßennetzwerks angeben (die Umgebungsgeschwindigkeit). Die Umgebungsgeschwindigkeit kann Auswirkungen auf die Größe und den Shape des Polygons der Fahrtgrenze haben. Im Allgemeinen gilt: Je schneller die Umgebungsgeschwindigkeit, desto größer das Polygon. Wenn Sie sich beispielsweise an einem Punkt befinden, an dem Ihnen noch 5 Minuten zur Verfügung stehen und die Umgebungsgeschwindigkeit 15 Meilen pro Stunde beträgt, werden die Grenzpunkte bei einer Entfernung von 1,25 Meilen gesetzt. Wenn die Umgebungsgeschwindigkeit auf 10 Meilen pro Stunde verringert würde, würden Grenzpunkte auf eine Entfernung von 0,83 Meilen festgelegt.
Anmerkung: Der Standardwert für „DefaultAmbientSpeed“ ist 15.
|
|
AmbientSpeedUnit |
Gibt die Maßeinheit für die Berechnung der Umgebungsgeschwindigkeit an. Verfügbare Geschwindigkeitseinheiten sind:
Anmerkung: Der Standardwert für „AmbientSpeedUnit“ ist MPH.
|
|
AmbientSpeed.RoadType |
Gibt die für Fahrten außerhalb des Straßennetzwerks zu verwendende Umgebungsgeschwindigkeit basierend auf dem Straßentyp an. Sie müssen den Straßentyp und die neue Geschwindigkeit für diesen Straßentyp angeben. Die Geschwindigkeit wird im definierten AmbientSpeedUnit definiert. Straßentypen können in allen unterstützten Typen zurückgegeben werden. Folgende Straßentypen können verwendet werden:
|
| propagationFactor | Siehe Abfrageparameter für die Beschreibung von propagationFactor. Anmerkung: Dieser Parameter wird nur unterstützt, wenn getTravelBoundary Version 2 angegeben ist.
|
| RoadType | Gibt die für Fahrten außerhalb des Straßennetzwerks zu verwendende propagationFactor basierend auf dem Straßentyp an. Sie müssen den Straßentyp und den neuen Wert für „propagationFactor“ des Straßentyps angeben. Weitere Informationen finden Sie unter propagationFactor. Straßentypen können in allen unterstützten Typen zurückgegeben werden. Folgende Straßentypen können verwendet werden:
Anmerkung: Dieser Parameter wird nur unterstützt, wenn getTravelBoundary Version 2 angegeben ist.
|
| avoid | Gibt eine durch Kommas getrennte Liste von Straßentypen an, die bei der Fahrtgrenzenberechnung vermieden werden sollen. Dies ist ein String-Parameter. Wenn ein Straßentyp als Wert des Parameters bereitgestellt wird, wird dieser Straßentyp bei der Fahrtgrenzenberechnung aus der Route ausgeschlossen. Wenn beispielsweise tollRoad als Parameterwert angegeben wird, hat die berechnete Grenze keine Mautstraßen. |
Beispiel mit Umgebungsgeschwindigkeitsparametern in HTTP POST-Nutzlast in Version 1 von gettravelboundary
{ "DefaultAmbientSpeed": 45, "AmbientSpeedUnit": "MPH" "AmbientSpeed.RoadType.PrimaryHighwayUrban": 15, "AmbientSpeed.RoadType.SecondaryHighwayUrban": 10 }Beispiel mit Umgebungsgeschwindigkeitsparametern und Parametern des Typs propagationFactor in HTTP POST-Nutzlast in gettravelboundary Version 2.
{ "ambientSpeeds": { "defaultAmbientSpeed": 24, "ambientSpeedUnit": "MPH", "ambientSpeedOverrides": { "Primary Highway Urban": ".51", "Secondary Highway Urban": ".1" } }, "propagationFactors": { "propagationFactor": "1", "propagationFactorOverrides": { "Primary Highway Urban": ".51", "Secondary Highway Urban": ".1" } } } { "ambientSpeeds": { "ambientSpeedOverrides": { "Primary Highway Urban": 25, "Secondary Highway Urban": 10 } }, "propagationFactors": { "propagationFactor": "0.2", "propagationFactorOverrides": { "Primary Highway Urban": "0.51", "Secondary Highway Urban": "0.1" } } }Anmerkung: Die Antwort der REST-Anforderung erscheint im JSON-Format, und die Geometry-Daten erscheinen im GEOJSON-Format.