transferSolutions

URI

<transferNetwork_uri>/solutions[.<format>]

Supported methods

GET, HEAD

Parent resource

transferNetwork

Introduction

Used to perform traffic transfer analysis, return all the solutions.

Supported Methods:

Supported output formats: rjson, json, html, xml.

GIS Services Resource Hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

http://supermapiserver:8090/iserver/services/traffictransferanalyst-sample/restjsr/traffictransferanalyst/Traffic-Changchun/solutions.rjson?solutionCount=5&transferTactic=LESS_TIME&transferPreference=NONE&walkingRatio=10&points=[175,164]

GET request

Get all the transfer solution, that is perform the traffic transfer analysis once.

Request parameter

Pass the following parameters after the "?" behind URI:

Name Type Description
points int[]
Point2D[]		 Two query methods:
1. According to the start ID of the bus stops, the points parameter type is int[], in form of: [Start point ID, End point ID];
2. According to the coordinate of the start point, the points parameter type is Point2D[], in form of [{"x":44,"y":39},{"x":45,"y":40}].
transferTactic TransferTactic Transfer tactics, including least time, least distance, least transfer and least walk.
transferPreference TransferPreference Transfer preference enumeration.
solutionCount int The count of transfer solutions.
walkingRatio double The cost weight ratio for walking to take bus, the default value is 10. The greater this value, the more influence walking has on the analysis.
For instance, there are two transfer solutions:
1. Take bus for 10 km and walk 1 km;
2. take bus for 15 km and walk 0.5 km;
Suppose the walkingRation is 15:
  • The cost of solution 1: 10 + 1*15 = 25
  • The cost of solution 2: 15 + 0.5*15 = 22.5
The cost of solution 2 is lower.
2 Suppose the walkingRation is 2:
  • The cost of solution 1: 10 + 1*2 = 12
  • The cost of solution 2: 15 + +0.5*2 = 17
The cost of solution 1 is lower.

Response structure

Field Type Description
defaultGuide TransferGuide The default transfer solution and related information.
items TransferSolution[] The transfer solution set returned.

Respose example

Perform GET request on the transferSolutions resource:

http://supermapiserver:8090/iserver/services/traffictransferanalyst-sample/restjsr/traffictransferanalyst/Traffic-Changchun/solutions.rjson?solutionCount=5&transferTactic=LESS_TIME&transferPreference=NONE&walkingRatio=10&points=[175,164]

The rjson representation returned is as follows:

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the transferSolutions resource exists, or if the resource can be accessed by clients. It can also determine if the transferSolutions resource supports an output format <format> if performed on a URI with .<format> included.

See