BasicServices Web Service

BasicServices

Click here for a complete list of operations.

GetBestRoute

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /RoutingServices/BasicServices.asmx HTTP/1.1
Host: routing.coconline.nl
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.speerit.nl/RoutingServices/BasicServices/GetBestRoute"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetBestRoute xmlns="http://www.speerit.nl/RoutingServices/BasicServices">
      <strEnvironment>string</strEnvironment>
      <strCulture>string</strCulture>
      <strRequestUser>string</strRequestUser>
      <strPassword>string</strPassword>
      <strRequestId>string</strRequestId>
      <strFlags>string</strFlags>
      <sngX1>float</sngX1>
      <sngY1>float</sngY1>
      <sngX2>float</sngX2>
      <sngY2>float</sngY2>
      <strLocationName>string</strLocationName>
      <intRoutingType>int</intRoutingType>
      <strCostsTemplate>string</strCostsTemplate>
      <intMaximumAddressJump>int</intMaximumAddressJump>
      <intMaximumBBJump>int</intMaximumBBJump>
      <strProduct>string</strProduct>
      <strBandWidth>string</strBandWidth>
      <arrBoundsInfo>
        <BoundsInformation>
          <Use>int</Use>
          <X>
            <float>float</float>
            <float>float</float>
          </X>
          <Y>
            <float>float</float>
            <float>float</float>
          </Y>
        </BoundsInformation>
        <BoundsInformation>
          <Use>int</Use>
          <X>
            <float>float</float>
            <float>float</float>
          </X>
          <Y>
            <float>float</float>
            <float>float</float>
          </Y>
        </BoundsInformation>
      </arrBoundsInfo>
    </GetBestRoute>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetBestRouteResponse xmlns="http://www.speerit.nl/RoutingServices/BasicServices">
      <GetBestRouteResult>
        <RequestUser>string</RequestUser>
        <RequestId>string</RequestId>
        <Flags>string</Flags>
        <RequestRoutingType>int</RequestRoutingType>
        <MaximumAddressJump>int</MaximumAddressJump>
        <MaximumBackboneJump>int</MaximumBackboneJump>
        <Product>string</Product>
        <BandWidth>string</BandWidth>
        <CostTemplate>string</CostTemplate>
        <LocationType1>string</LocationType1>
        <LocationType2>string</LocationType2>
        <RoutingAPTypes>string</RoutingAPTypes>
        <RoutingPatchTypes>string</RoutingPatchTypes>
        <AvailableFrameNeededForConnect>int</AvailableFrameNeededForConnect>
        <Id>int</Id>
        <Created>dateTime</Created>
        <ElapsedMilliSeconds>int</ElapsedMilliSeconds>
        <RoutingCosts>
          <MaxCosts>int</MaxCosts>
          <DigAddress>int</DigAddress>
          <Dig>int</Dig>
          <DigDrilling>int</DigDrilling>
          <PaveBuildupArea>int</PaveBuildupArea>
          <PaveNoBuildupArea>int</PaveNoBuildupArea>
          <DigBuildupArea>int</DigBuildupArea>
          <DigNoBuildupArea>int</DigNoBuildupArea>
          <DigHighWay>int</DigHighWay>
          <DigRailWay>int</DigRailWay>
          <DigTramWay>int</DigTramWay>
          <MaxAddressStreets>int</MaxAddressStreets>
          <ShortcutMaxDistance>int</ShortcutMaxDistance>
          <ShortcutFactor>int</ShortcutFactor>
          <BlowStartup>int</BlowStartup>
          <BlowType1>int</BlowType1>
          <BlowType2>int</BlowType2>
          <BlowType3>int</BlowType3>
          <BBRouting>int</BBRouting>
          <WaterWayDrilling>int</WaterWayDrilling>
          <WaterWayDrillingFixed>int</WaterWayDrillingFixed>
          <MotorWayDrillingFixed>int</MotorWayDrillingFixed>
          <MajorRoadDrillingFixed>int</MajorRoadDrillingFixed>
          <SecondaryRoadDrillingFixed>int</SecondaryRoadDrillingFixed>
          <ConnectingRoadDrillingFixed>int</ConnectingRoadDrillingFixed>
          <LocalRoadDrillingFixed>int</LocalRoadDrillingFixed>
          <RailwayDrillingFixed>int</RailwayDrillingFixed>
          <TramwayDrillingFixed>int</TramwayDrillingFixed>
          <NewHandHole>int</NewHandHole>
          <NewEnclosure>int</NewEnclosure>
          <CoreHandHole>int</CoreHandHole>
          <BBNetworkFixed>int</BBNetworkFixed>
          <BBEquipmentUntilLimit>int</BBEquipmentUntilLimit>
          <BBEquipmentAboveLimit>int</BBEquipmentAboveLimit>
          <BBSplice>int</BBSplice>
          <BBPatch>int</BBPatch>
          <StartUp>int</StartUp>
          <StartUpOnNetCustomer>int</StartUpOnNetCustomer>
          <StartUpOnNet>int</StartUpOnNet>
          <BlowOwnerChange>int</BlowOwnerChange>
          <BBOwnerChange>int</BBOwnerChange>
          <RiskPercentage>int</RiskPercentage>
          <ExtraHHDistance>int</ExtraHHDistance>
          <MaxStraightBlowLength>int</MaxStraightBlowLength>
          <BBEquipmentLimit>int</BBEquipmentLimit>
          <NewHandHole2>int</NewHandHole2>
          <NewHandHole3>int</NewHandHole3>
          <NewHandHole4>int</NewHandHole4>
          <NewHandHole5>int</NewHandHole5>
          <NewHandHole6>int</NewHandHole6>
          <NewHandHole7>int</NewHandHole7>
          <CoreHandHole2>int</CoreHandHole2>
          <CoreHandHole3>int</CoreHandHole3>
          <CoreHandHole4>int</CoreHandHole4>
          <CoreHandHole5>int</CoreHandHole5>
          <CoreHandHole6>int</CoreHandHole6>
          <CoreHandHole7>int</CoreHandHole7>
          <BBRouting2>int</BBRouting2>
          <BBRouting3>int</BBRouting3>
          <BBRouting4>int</BBRouting4>
          <BBRouting5>int</BBRouting5>
          <BBRouting6>int</BBRouting6>
          <BBRouting7>int</BBRouting7>
          <DigAddressRaise>int</DigAddressRaise>
          <DistAddressRaise>int</DistAddressRaise>
        </RoutingCosts>
        <FromLocationInfo>
          <LocationName>string</LocationName>
          <NodeX>float</NodeX>
          <NodeY>float</NodeY>
          <ErrorString>string</ErrorString>
          <NewHH>int</NewHH>
          <NewEnclosure>int</NewEnclosure>
          <CoreHH>int</CoreHH>
          <Connected>int</Connected>
          <CustomerLocation>int</CustomerLocation>
          <LocationType>int</LocationType>
          <OwnerId>int</OwnerId>
          <BBLocation>string</BBLocation>
        </FromLocationInfo>
        <ToLocationInfo>
          <LocationName>string</LocationName>
          <NodeX>float</NodeX>
          <NodeY>float</NodeY>
          <ErrorString>string</ErrorString>
          <NewHH>int</NewHH>
          <NewEnclosure>int</NewEnclosure>
          <CoreHH>int</CoreHH>
          <Connected>int</Connected>
          <CustomerLocation>int</CustomerLocation>
          <LocationType>int</LocationType>
          <OwnerId>int</OwnerId>
          <BBLocation>string</BBLocation>
        </ToLocationInfo>
        <RoutingPOP>string</RoutingPOP>
        <PatchCosts>float</PatchCosts>
        <Sections>
          <RoutingResultSection>
            <ObjsourceId>int</ObjsourceId>
            <FromNodeId>int</FromNodeId>
            <SectionId>int</SectionId>
            <Name>string</Name>
            <Transport>int</Transport>
            <SectionType>string</SectionType>
            <RoutePart>string</RoutePart>
            <Length>float</Length>
            <InsideBuilding>int</InsideBuilding>
            <BuildUpArea>int</BuildUpArea>
            <Drilling>int</Drilling>
            <Tramway>int</Tramway>
            <Railway>int</Railway>
            <Highway>int</Highway>
            <DuctCapacity>int</DuctCapacity>
            <Topology>int</Topology>
            <WaterWay>int</WaterWay>
            <RailWays>int</RailWays>
            <TramWays>int</TramWays>
            <MotorWays>int</MotorWays>
            <MajorRoads>int</MajorRoads>
            <SecondaryRoads>int</SecondaryRoads>
            <ConnectingRoads>int</ConnectingRoads>
            <LocalRoads>int</LocalRoads>
            <Roads>int</Roads>
            <FixedBlockedCosts>float</FixedBlockedCosts>
            <MeterBlockedCosts>float</MeterBlockedCosts>
            <BBSplice>int</BBSplice>
            <BBPatch>int</BBPatch>
            <OwnerId>int</OwnerId>
            <OwnerChange>int</OwnerChange>
            <Costs>int</Costs>
            <X xsi:nil="true" />
            <Y xsi:nil="true" />
          </RoutingResultSection>
          <RoutingResultSection>
            <ObjsourceId>int</ObjsourceId>
            <FromNodeId>int</FromNodeId>
            <SectionId>int</SectionId>
            <Name>string</Name>
            <Transport>int</Transport>
            <SectionType>string</SectionType>
            <RoutePart>string</RoutePart>
            <Length>float</Length>
            <InsideBuilding>int</InsideBuilding>
            <BuildUpArea>int</BuildUpArea>
            <Drilling>int</Drilling>
            <Tramway>int</Tramway>
            <Railway>int</Railway>
            <Highway>int</Highway>
            <DuctCapacity>int</DuctCapacity>
            <Topology>int</Topology>
            <WaterWay>int</WaterWay>
            <RailWays>int</RailWays>
            <TramWays>int</TramWays>
            <MotorWays>int</MotorWays>
            <MajorRoads>int</MajorRoads>
            <SecondaryRoads>int</SecondaryRoads>
            <ConnectingRoads>int</ConnectingRoads>
            <LocalRoads>int</LocalRoads>
            <Roads>int</Roads>
            <FixedBlockedCosts>float</FixedBlockedCosts>
            <MeterBlockedCosts>float</MeterBlockedCosts>
            <BBSplice>int</BBSplice>
            <BBPatch>int</BBPatch>
            <OwnerId>int</OwnerId>
            <OwnerChange>int</OwnerChange>
            <Costs>int</Costs>
            <X xsi:nil="true" />
            <Y xsi:nil="true" />
          </RoutingResultSection>
        </Sections>
      </GetBestRouteResult>
    </GetBestRouteResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /RoutingServices/BasicServices.asmx HTTP/1.1
Host: routing.coconline.nl
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetBestRoute xmlns="http://www.speerit.nl/RoutingServices/BasicServices">
      <strEnvironment>string</strEnvironment>
      <strCulture>string</strCulture>
      <strRequestUser>string</strRequestUser>
      <strPassword>string</strPassword>
      <strRequestId>string</strRequestId>
      <strFlags>string</strFlags>
      <sngX1>float</sngX1>
      <sngY1>float</sngY1>
      <sngX2>float</sngX2>
      <sngY2>float</sngY2>
      <strLocationName>string</strLocationName>
      <intRoutingType>int</intRoutingType>
      <strCostsTemplate>string</strCostsTemplate>
      <intMaximumAddressJump>int</intMaximumAddressJump>
      <intMaximumBBJump>int</intMaximumBBJump>
      <strProduct>string</strProduct>
      <strBandWidth>string</strBandWidth>
      <arrBoundsInfo>
        <BoundsInformation>
          <Use>int</Use>
          <X>
            <float>float</float>
            <float>float</float>
          </X>
          <Y>
            <float>float</float>
            <float>float</float>
          </Y>
        </BoundsInformation>
        <BoundsInformation>
          <Use>int</Use>
          <X>
            <float>float</float>
            <float>float</float>
          </X>
          <Y>
            <float>float</float>
            <float>float</float>
          </Y>
        </BoundsInformation>
      </arrBoundsInfo>
    </GetBestRoute>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetBestRouteResponse xmlns="http://www.speerit.nl/RoutingServices/BasicServices">
      <GetBestRouteResult>
        <RequestUser>string</RequestUser>
        <RequestId>string</RequestId>
        <Flags>string</Flags>
        <RequestRoutingType>int</RequestRoutingType>
        <MaximumAddressJump>int</MaximumAddressJump>
        <MaximumBackboneJump>int</MaximumBackboneJump>
        <Product>string</Product>
        <BandWidth>string</BandWidth>
        <CostTemplate>string</CostTemplate>
        <LocationType1>string</LocationType1>
        <LocationType2>string</LocationType2>
        <RoutingAPTypes>string</RoutingAPTypes>
        <RoutingPatchTypes>string</RoutingPatchTypes>
        <AvailableFrameNeededForConnect>int</AvailableFrameNeededForConnect>
        <Id>int</Id>
        <Created>dateTime</Created>
        <ElapsedMilliSeconds>int</ElapsedMilliSeconds>
        <RoutingCosts>
          <MaxCosts>int</MaxCosts>
          <DigAddress>int</DigAddress>
          <Dig>int</Dig>
          <DigDrilling>int</DigDrilling>
          <PaveBuildupArea>int</PaveBuildupArea>
          <PaveNoBuildupArea>int</PaveNoBuildupArea>
          <DigBuildupArea>int</DigBuildupArea>
          <DigNoBuildupArea>int</DigNoBuildupArea>
          <DigHighWay>int</DigHighWay>
          <DigRailWay>int</DigRailWay>
          <DigTramWay>int</DigTramWay>
          <MaxAddressStreets>int</MaxAddressStreets>
          <ShortcutMaxDistance>int</ShortcutMaxDistance>
          <ShortcutFactor>int</ShortcutFactor>
          <BlowStartup>int</BlowStartup>
          <BlowType1>int</BlowType1>
          <BlowType2>int</BlowType2>
          <BlowType3>int</BlowType3>
          <BBRouting>int</BBRouting>
          <WaterWayDrilling>int</WaterWayDrilling>
          <WaterWayDrillingFixed>int</WaterWayDrillingFixed>
          <MotorWayDrillingFixed>int</MotorWayDrillingFixed>
          <MajorRoadDrillingFixed>int</MajorRoadDrillingFixed>
          <SecondaryRoadDrillingFixed>int</SecondaryRoadDrillingFixed>
          <ConnectingRoadDrillingFixed>int</ConnectingRoadDrillingFixed>
          <LocalRoadDrillingFixed>int</LocalRoadDrillingFixed>
          <RailwayDrillingFixed>int</RailwayDrillingFixed>
          <TramwayDrillingFixed>int</TramwayDrillingFixed>
          <NewHandHole>int</NewHandHole>
          <NewEnclosure>int</NewEnclosure>
          <CoreHandHole>int</CoreHandHole>
          <BBNetworkFixed>int</BBNetworkFixed>
          <BBEquipmentUntilLimit>int</BBEquipmentUntilLimit>
          <BBEquipmentAboveLimit>int</BBEquipmentAboveLimit>
          <BBSplice>int</BBSplice>
          <BBPatch>int</BBPatch>
          <StartUp>int</StartUp>
          <StartUpOnNetCustomer>int</StartUpOnNetCustomer>
          <StartUpOnNet>int</StartUpOnNet>
          <BlowOwnerChange>int</BlowOwnerChange>
          <BBOwnerChange>int</BBOwnerChange>
          <RiskPercentage>int</RiskPercentage>
          <ExtraHHDistance>int</ExtraHHDistance>
          <MaxStraightBlowLength>int</MaxStraightBlowLength>
          <BBEquipmentLimit>int</BBEquipmentLimit>
          <NewHandHole2>int</NewHandHole2>
          <NewHandHole3>int</NewHandHole3>
          <NewHandHole4>int</NewHandHole4>
          <NewHandHole5>int</NewHandHole5>
          <NewHandHole6>int</NewHandHole6>
          <NewHandHole7>int</NewHandHole7>
          <CoreHandHole2>int</CoreHandHole2>
          <CoreHandHole3>int</CoreHandHole3>
          <CoreHandHole4>int</CoreHandHole4>
          <CoreHandHole5>int</CoreHandHole5>
          <CoreHandHole6>int</CoreHandHole6>
          <CoreHandHole7>int</CoreHandHole7>
          <BBRouting2>int</BBRouting2>
          <BBRouting3>int</BBRouting3>
          <BBRouting4>int</BBRouting4>
          <BBRouting5>int</BBRouting5>
          <BBRouting6>int</BBRouting6>
          <BBRouting7>int</BBRouting7>
          <DigAddressRaise>int</DigAddressRaise>
          <DistAddressRaise>int</DistAddressRaise>
        </RoutingCosts>
        <FromLocationInfo>
          <LocationName>string</LocationName>
          <NodeX>float</NodeX>
          <NodeY>float</NodeY>
          <ErrorString>string</ErrorString>
          <NewHH>int</NewHH>
          <NewEnclosure>int</NewEnclosure>
          <CoreHH>int</CoreHH>
          <Connected>int</Connected>
          <CustomerLocation>int</CustomerLocation>
          <LocationType>int</LocationType>
          <OwnerId>int</OwnerId>
          <BBLocation>string</BBLocation>
        </FromLocationInfo>
        <ToLocationInfo>
          <LocationName>string</LocationName>
          <NodeX>float</NodeX>
          <NodeY>float</NodeY>
          <ErrorString>string</ErrorString>
          <NewHH>int</NewHH>
          <NewEnclosure>int</NewEnclosure>
          <CoreHH>int</CoreHH>
          <Connected>int</Connected>
          <CustomerLocation>int</CustomerLocation>
          <LocationType>int</LocationType>
          <OwnerId>int</OwnerId>
          <BBLocation>string</BBLocation>
        </ToLocationInfo>
        <RoutingPOP>string</RoutingPOP>
        <PatchCosts>float</PatchCosts>
        <Sections>
          <RoutingResultSection>
            <ObjsourceId>int</ObjsourceId>
            <FromNodeId>int</FromNodeId>
            <SectionId>int</SectionId>
            <Name>string</Name>
            <Transport>int</Transport>
            <SectionType>string</SectionType>
            <RoutePart>string</RoutePart>
            <Length>float</Length>
            <InsideBuilding>int</InsideBuilding>
            <BuildUpArea>int</BuildUpArea>
            <Drilling>int</Drilling>
            <Tramway>int</Tramway>
            <Railway>int</Railway>
            <Highway>int</Highway>
            <DuctCapacity>int</DuctCapacity>
            <Topology>int</Topology>
            <WaterWay>int</WaterWay>
            <RailWays>int</RailWays>
            <TramWays>int</TramWays>
            <MotorWays>int</MotorWays>
            <MajorRoads>int</MajorRoads>
            <SecondaryRoads>int</SecondaryRoads>
            <ConnectingRoads>int</ConnectingRoads>
            <LocalRoads>int</LocalRoads>
            <Roads>int</Roads>
            <FixedBlockedCosts>float</FixedBlockedCosts>
            <MeterBlockedCosts>float</MeterBlockedCosts>
            <BBSplice>int</BBSplice>
            <BBPatch>int</BBPatch>
            <OwnerId>int</OwnerId>
            <OwnerChange>int</OwnerChange>
            <Costs>int</Costs>
            <X xsi:nil="true" />
            <Y xsi:nil="true" />
          </RoutingResultSection>
          <RoutingResultSection>
            <ObjsourceId>int</ObjsourceId>
            <FromNodeId>int</FromNodeId>
            <SectionId>int</SectionId>
            <Name>string</Name>
            <Transport>int</Transport>
            <SectionType>string</SectionType>
            <RoutePart>string</RoutePart>
            <Length>float</Length>
            <InsideBuilding>int</InsideBuilding>
            <BuildUpArea>int</BuildUpArea>
            <Drilling>int</Drilling>
            <Tramway>int</Tramway>
            <Railway>int</Railway>
            <Highway>int</Highway>
            <DuctCapacity>int</DuctCapacity>
            <Topology>int</Topology>
            <WaterWay>int</WaterWay>
            <RailWays>int</RailWays>
            <TramWays>int</TramWays>
            <MotorWays>int</MotorWays>
            <MajorRoads>int</MajorRoads>
            <SecondaryRoads>int</SecondaryRoads>
            <ConnectingRoads>int</ConnectingRoads>
            <LocalRoads>int</LocalRoads>
            <Roads>int</Roads>
            <FixedBlockedCosts>float</FixedBlockedCosts>
            <MeterBlockedCosts>float</MeterBlockedCosts>
            <BBSplice>int</BBSplice>
            <BBPatch>int</BBPatch>
            <OwnerId>int</OwnerId>
            <OwnerChange>int</OwnerChange>
            <Costs>int</Costs>
            <X xsi:nil="true" />
            <Y xsi:nil="true" />
          </RoutingResultSection>
        </Sections>
      </GetBestRouteResult>
    </GetBestRouteResponse>
  </soap12:Body>
</soap12:Envelope>