Getting Information on a Link in the Routing Network

The linkInfo operation returns information about a link in the routing network. A link in the routing network is usually a line that leads from one junction to the next junction. In case of ferries a link may lead from one harbour to another harbour. The shape of the line is defined by a sequence of coordinates.

A WGS 84 compliant coordinate must be passed in the linkInfo request. As a result the Map24 Routing Service will return the link in the routing network that is closest to the given coordinate. The Map24 Routing Service distinguishes between roads of different types (e.g. highways, secondary roads, etc.). It is possible to limit the search to certain road types.

The following listing shows the general structure of the operation in the WSDL file of the Map24 Routing Service:

...
  <message name="linkInfoRequest" >
    <part name="RequestHeader" type="tns:RequestHeader" />
    <part name="LinkInfoRequest" type="tns:LinkInfoRequest" />
  </message>
  <message name="linkInfoResponse" >
    <part name="LinkInfoResponse" type="tns:LinkInfoResponse" />
  </message> 
  ...
 <portType name="Map24RoutingPortType" > 
   <operation name="linkInfo" >
      <input message="tns:linkInfoRequest" />
      <output message="tns:linkInfoResponse" />
    </operation>
    ...
  </portType>
  ...

Request

LinkInfoRequest is used to provide the parameters of a linkInfo operation.

Fields:

Field	Mandatory / Optional	Description
Coordinate	mandatory	The coordinate to find the link in the routing network for. The coordinate must be WGS 84 compliant and within the boundaries of the map. If the Map24 Routing Service does not find a link at the given coordinate, it will return the link that is closest to the given coordinate.
MaxRoadType	optional	The routing service distinguishes between different road types. The road types and associated IDs are listed here. MaxRoadType can be used to exclude roads of minor importance from the search. For example, if you set MaxRoadType to 20, only highways (ID = 10) and roads of major importance (ID = 20) will be included in the search.
RequestProperties	optional	For future use. Currently, only the SynchronizeClient key can be set. If set to true, the map in the Map24 Web Service demo pages will show the result.
RoutingServiceID	optional	ID of the Map24 Routing Service. This field can be set to overwrite the default Map24 Routing Service attached to the customer's Map24 ID.

Response

LinkInfoResponse contains the result of a linkInfo operation.

Field	Description
Status	Status of the operation on the server. OK: The operation was processed successfully. COORDS_INVALID_OR_MISSING: No coordinate was passed in the request, or the given coordinate was invalid. See the description of Coordinate in the Request section. OUTSIDE_MAP: No link can be found for the given coordinate within a certain distance. This can happen if the routing network is wide meshed in the area around the given coordinate. UNDEF: Undefined error. FAILED: Undefined error. INTERNAL_ERROR: Unexpected internal processing error.
LinkID	Unique ID of the link in the routing network.
RoadType	Type of the road to which the link belongs. The RoadType is specified with an ID.
SpeedCategory	The maximum speed defined for a road within this speed category. SpeedCategory consists of a value for the speed limit (MaxSpeed field) and the measuring unit (Unit field). Roads without speed limit are denoted with value "999". The Unit field can have the following values: KPH (kilometers per hour), MPH (miles per hour), undef (undefined).
SpeedLimit	The maximum speed defined for this road. The value given in SpeedLimit is more precise than the SpeedCategory value. For example, in Great Britain all highways have a SpeedCategory value of 130 km per hour, but a SpeedLimit value of 100 km per hour which is the actual speed limit on British highways. This field contains of two subelements: SpeedLimit and Unit. The Unit field can have the following values: KPH (kilometers per hour), MPH (miles per hour), undef (undefined).
MultiCarriage	True if the link is part of a multi carriage road, false otherwise. Toll: True if the link is part of a toll road, false otherwise.
Toll	True if the link is part of a toll road, false otherwise.
MatchingPoint	The MatchingPoint element contains information about the position and geometry of the link.
Country	The country in which the link is located. The country is specfied with a two-letter country code as specified in ISO 3166.
RoadName	The name of the road on which the link is located. This field may be empty.
RoadNumber	The Road number, for example A5, E50, I90.
AlternateName	Alternative road name. This can be a commonly used name of a street, for example "Deutsche Weinstraße".
Name1	Field for providing information on the city in which the link is located. The content of this field may vary among differenct map data formats.
Name2	Another field for providing information on the city in which the link is located. The content of this field may vary among differenct map data formats.
InsideBuildup	True if the link is located within a buildup area, false otherwise.
Buildup	Name of the buildup area. The content of this field may vary among differenct map data formats.
Junction	Name of a motorway junction that the link is part of. Example: <Junction>AS FRANKFURT-OST</Junction>
TMCCode	One or multple TMC codes. A TMC code is a numeric code for defining the position of an incident. This field is only provided if the user has a license for getting traffic information. Multiple TMC codes are separated with commas. Example: <TMCCode>+D01+37145,+D01-37144</TMCCode>
SignPost	Sign posts along the link.
Tourist	Alternative road name for tourists.
Tunnel	True if the link is part of a tunnel, false otherwise.
TunnelName	Name of the tunnel.
Bridge	True if the link is part of a bridge, false otherwise.
BridgeName	Name of the bridge.
PedestriansOnly	True if the link is located on a road that can not be used by cars, for example pedestrian zones.
ResidentsOnly	True if the link is located on a road on which only residents are allowed to drive.
LinkProperties	For future use.

Examples

An example SOAP request is provided here.