Opciones de GetRoute HTTP POST
Formato de dirección URL de HTTP POST
Además de los parámetros regulares HTTP GET, puede agregar opciones de carga HTTP POST a su solicitud que especifica puntos intermedios, actualizaciones transitorias y prioridad de tipos de camino. El tipo de contenido se debe configurar en aplicación/json. El siguiente formato se utiliza para solicitudes HTTP POST:
HTTP POST: /rest/Spatial/erm/databases/dbsource.json?q=route&query_parameters
POST BODY: Content-Type:application/json {Route Data}
Puntos intermedios
Una lista de puntos intermedios para incluir junto con la ruta. Para incluir un conjunto de puntos intermedios en una solicitud HTTP POST, agregue una carga MultiPoint JSON que indique los puntos que debe incluir la ruta. Si los puntos intermedios se especifican en la URL y en la carga json, esta última tiene preferencia y se ignoran los que están en de la URL.
Ejemplos de carga de puntos intermedios HTTP POST.
{
"intermediatePoints": {"type": "MultiPoint","crs": {"type": "name","properties": {"name": "epsg:4326"}},"coordinates": [[ -73.976266,40.788717],[ -73.973562,40.792193],[ -73.971802,40.794630]]}
}
Actualizaciones transitorias
Este conjunto de preferencias le permite definir actualizaciones transitorias para cada solicitud. Por ejemplo, usted puede solicitar que el servidor intente evitar todos los tipos de caminos principales. Cada solicitud puede contener una o más actualizaciones. Para actualizaciones de velocidad, el valor de velocidad positivo es un aumento de velocidad y el valor de velocidad negativo es una disminución de velocidad. A continuación se ofrece una descripción de los tipos de actualización transitoria:
Tipo de actualización |
Descripción |
---|---|
point |
Las actualizaciones de punto son cambios que se aplican a un punto correspondiente (latitud, longitud). Para un punto en particular, puede: excluir el punto, definir la velocidad del punto o cambiar (aumentar o disminuir) la velocidad del punto en un valor o porcentaje. Use uno de los siguientes tipos de actualizaciones:
|
segmentID |
Las actualizaciones de segmentos son los cambios que se aplican a una ID de segmento correspondiente. Para un segmento en particular, puede: excluir el segmento, definir la velocidad del segmento, cambiar (aumentar o disminuir) la velocidad del segmento en un valor o porcentaje o cambiar el tipo de camino del segmento. Use uno de los siguientes tipos de actualizaciones:
|
roadType |
Las actualizaciones de tipo de camino son cambios que se aplican al tipo de camino correspondiente. Para un tipo de camino en particular, puede: definir la velocidad del tipo de camino o cambiar (aumentar o disminuir) la velocidad del tipo de camino en un valor o porcentaje. Use uno de los siguientes tipos de actualizaciones:
|
Ejemplos de carga de actualizaciones transitorias HTTP POST.
{
"transientUpdates": [
{
"segmentID": "specify a segment id",
"updates": [
{"exclude": "Y"},
{"roadType": "a road type"},
{"percentage": 26.0},
{"speed": { "velocity": 25, "velocityUnit": "kph"}},
{"percentage": -13.5},
{"speedAdjustment" : { "velocity": 5, "velocityUnit": "kph"}}
]
},
{
"point": "specify a geojson point",
"updates": [
{"exclude": "Y"},
{"percentage": 26.0},
{"speed": { "velocity": 25, "velocityUnit": "kph"}},
{"percentage": -13.5},
{"speedAdjustment" : { "velocity": 5, "velocityUnit": "kph"}}
]
},
{
"roadType": "specify a road type",
"updates": [
{"percentage": 26.0},
{"speed": { "velocity": 25, "velocityUnit": "kph"}},
{"percentage": -13.5},
{"speedAdjustment" : { "velocity": 5, "velocityUnit": "kph"}}
]
}
]
}
Prioridad de tipo de camino
Especifica la prioridad que debe asignarse a los diferentes tipos de caminos al determinar la ruta. A continuación se ofrece una descripción de las opciones de prioridad de tipo de camino:
Opción |
Descripción |
---|---|
alta |
Se prefiere ese tipo de camino por sobre los demás. |
media |
Este tipo de camino tiene el mismo nivel de preferencia que los demás tipos de caminos. Si no se especifica una preferencia para un tipo de camino, esta será la opción predeterminada. |
baja |
Se prefieren otros tipos de caminos y no este tipo. |
evitar |
El tipo de camino se excluye de las rutas de ser posible. No siempre es posible excluir un tipo de camino de las indicaciones de viaje. Según la situación, si la alternativa para un tipo de camino evitado es demasiado deficiente, en ese caso el software elegirá una ruta que incluya el tipo de camino que se deseaba evitar. Asimismo, si el punto de partida o llegada se ubica en un segmento cuyo tipo de camino se había evitado, el software de todas formas utilizará ese segmento. |
Ejemplo de carga de prioridad de tipo de camino HTTP POST
{
" roadTypesPriority ": {
"RoadType.MajorRoadDenseUrban": "High",
"RoadType.LimitedAccessDenseUrban":"Low",
"RoadType.LimitedAccessRural":"Medium",
"RoadType.PrimaryHighwayUrban":"Avoid"
}
}