GetTravelBoundary
Beschreibung
„GetTravelBoundary“ bestimmt eine Fahrt-/Gehzeit oder einen Entfernungsrahmen von einem Ort. Dieser Vorgang gibt Polygone entsprechend einer Isochron- oder Isodistanz-Berechnung zurück. Ein Isochron ist ein Polygon oder Satz von Punkten und stellt ein Gebiet dar, das in einem Netz von einem Startpunkt in einer gegebenen Zeitdauer traversiert werden kann. Eine Isodistanz ist ein Polygon oder Satz von Punkten und stellt das Gebiet dar, das eine bestimmte Entfernung vom Startpunkt hat. Der Vorgang „GetTravelBoundary“ (auch bekannt als Isodefinition) verwendet einen Startpunkt, eine Einheit (linear oder Zeit) und einen oder mehr Kostenwerte als Eingabe und gibt den resultierenden Reiserahmen zurück. Kosten beziehen sich auf den Betrag der Zeit oder Entfernung, der zum Berechnen einer Iso verwendet werden soll.
Dienst-URL-Formate
Der URL-Endpunkt für den Routing-SOAP-Dienst hat das folgende allgemeine Format:
http://<server>:<port>/soap/RoutingService
Die URL für die Routing-WSDL hat das folgende allgemeine Format:
http://<server>:<port>/soap/RoutingService?wsdl
Nachrichten
In der folgenden Tabelle sind die Anforderungs- und Antwortnachrichten für den Vorgang GetTravelBoundary aufgelistet.
Klicken Sie auf einen Nachrichtennamen, um mehr Informationen zu dieser Nachricht zu erhalten.
| Nachricht | Beschreibung |
|---|---|
| GetTravelBoundaryRequest | Die Anforderungsnachricht für den Vorgang GetTravelBoundary. |
| GetTravelBoundaryResponse | Die Antwortnachricht für den Vorgang GetTravelBoundary. |
Beispiel für einzelnen Kostenwert
Anforderung für einen Reiserahmen mit einem einzelnen Kostenwert.
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.mapinfo.com/routing/service/v1" xmlns:v11="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:v12="http://www.mapinfo.com/midev/service/units/v1">
<soapenv:Header/>
<soapenv:Body>
<v1:GetTravelBoundaryRequest id="">
<v1:DatasetResourceName>US</v1:DatasetResourceName>
<v1:Point srsName="epsg:4326">
<v1:Point srsName="epsg:4326">
<v11:Pos>
<v11:X>-74.099876</v11:X>
<v11:Y>40.814618</v11:Y>
</v11:Pos>
</v1:Point>
<v1:Costs>
<v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">5</v1:Time>
</v1:Cost>
</v1:Costs>
<!--optionals-->
<v1:BandingStyle>Donut</v1:BandingStyle>
<v1:MaxOffroadDistance uom="Mile">1</v1:MaxOffroadDistance>
<v1:ReturnHoles>false</v1:ReturnHoles>
<v1:ReturnIslands>false</v1:ReturnIslands>
<v1:SimplificationFactor>0.5</v1:SimplificationFactor>
<v1:DestinationSrs>epsg:4326</v1:DestinationSrs>
<v1:MajorRoads>true</v1:MajorRoads>
<v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>
<v1:AmbientSpeeds>
<v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessSuburban</v1:AmbientSpeedRoadType>
<v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
<v12:Speed uom="KPH">30</v12:Speed>
</v1:AmbientSpeedCost>
</v1:AmbientCostEntry>
<v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessRural</v1:AmbientSpeedRoadType>
<v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
<v12:Speed uom="MPH">30</v12:Speed>
</v1:AmbientSpeedCost>
</v1:AmbientCostEntry>
</v1:AmbientSpeeds>
<!--optionals-->
</v1:GetTravelBoundaryRequest>
</soapenv:Body>
</soapenv:Envelope>
Antwort für einen Reiserahmen mit einem einzelnen Kostenwert.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetTravelBoundaryResponse xmlns="http://www.mapinfo.com/routing/service/v1" xmlns:ns2="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:ns3="http://www.mapinfo.com/midev/service/units/v1" xmlns:ns4="http://www.mapinfo.com/midev/service/common/v1" xmlns:ns5="http://www.mapinfo.com/routing/service/common/v1">
<TravelBoundary xsi:type="IsoChroneTravelBoundary" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns2:MultiPolygon srsName="epsg:4326">
<ns2:Polygon srsName="epsg:4326">
<ns2:Exterior>
<ns2:LineString>
<ns2:Pos>
<ns2:X>-74.12239074707031</ns2:X>
<ns2:Y>40.78827667236328</ns2:Y>
</ns2:Pos>
<ns2:Pos>
<ns2:X>-74.1226806640625</ns2:X>
<ns2:Y>40.788719177246094</ns2:Y>
</ns2:Pos>
…….
<ns2:Pos>
<ns2:X>-74.1220932006836</ns2:X>
<ns2:Y>40.78827667236328</ns2:Y>
</ns2:Pos>
<ns2:Pos>
<ns2:X>-74.12239074707031</ns2:X>
<ns2:Y>40.78827667236328</ns2:Y>
</ns2:Pos>
</ns2:LineString>
</ns2:Exterior>
</ns2:Polygon>
</ns2:MultiPolygon>
<IsoChroneCost>
<ns3:Time uom="Minute">5.0</ns3:Time>
</IsoChroneCost>
</TravelBoundary>
</GetTravelBoundaryResponse>
</soap:Body>
</soap:Envelope>
Beispiel für mehrere Kostenwerte
Anforderung für einen Reiserahmen mit mehreren Kostenwerten.
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.mapinfo.com/routing/service/v1" xmlns:v11="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:v12="http://www.mapinfo.com/midev/service/units/v1">
<soapenv:Header/>
<soapenv:Body>
<v1:GetTravelBoundaryRequest id="" lang="">
<v1:DatasetResourceName>US</v1:DatasetResourceName>
<v1:Point srsName="epsg:4326">
<v1:Point srsName="epsg:4326">
<v11:Pos>
<v11:X>-74.099876</v11:X>
<v11:Y>40.814618</v11:Y>
</v11:Pos>
</v1:Point>
<v1:Costs>
<v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">5</v1:Time>
</v1:Cost>
<v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">15</v1:Time>
</v1:Cost>
<v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">20</v1:Time>
</v1:Cost>
<v1:Cost xsi:type="v1:IsoChrone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<v1:Time uom="Minute" xmlns:v1="http://www.mapinfo.com/midev/service/units/v1">13</v1:Time>
</v1:Cost>
</v1:Costs>
<!--optionals-->
<v1:BandingStyle>Donut</v1:BandingStyle>
<v1:MaxOffroadDistance uom="Mile">1</v1:MaxOffroadDistance>
<v1:ReturnHoles>false</v1:ReturnHoles>
<v1:ReturnIslands>false</v1:ReturnIslands>
<v1:SimplificationFactor>0.5</v1:SimplificationFactor>
<v1:DestinationSrs>epsg:4326</v1:DestinationSrs>
<v1:MajorRoads>true</v1:MajorRoads>
<v1:HistoricTrafficTimeBucket>none</v1:HistoricTrafficTimeBucket>
<v1:AmbientSpeeds>
<v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessSuburban</v1:AmbientSpeedRoadType>
<v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
<v12:Speed uom="KPH">30</v12:Speed>
</v1:AmbientSpeedCost>
</v1:AmbientCostEntry>
<v1:AmbientCostEntry>
<v1:AmbientSpeedRoadType>AmbientSpeed.RoadType.LimitedAccessRural</v1:AmbientSpeedRoadType>
<v1:AmbientSpeedCost xsi:type="v1:AmbientSpeedCost">
<v12:Speed uom="MPH">30</v12:Speed>
</v1:AmbientSpeedCost>
</v1:AmbientCostEntry>
</v1:AmbientSpeeds>
<!--optionals-->
</v1:GetTravelBoundaryRequest>
</soapenv:Body>
</soapenv:Envelope>
Antwort für einen Reiserahmen mit mehreren Kostenwerten.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetTravelBoundaryResponse xmlns="http://www.mapinfo.com/routing/service/v1" xmlns:ns2="http://www.mapinfo.com/midev/service/geometries/v1" xmlns:ns3="http://www.mapinfo.com/midev/service/units/v1" xmlns:ns4="http://www.mapinfo.com/midev/service/common/v1" xmlns:ns5="http://www.mapinfo.com/routing/service/common/v1">
<TravelBoundary xsi:type="IsoChroneTravelBoundary" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns2:MultiPolygon srsName="epsg:4326">
<ns2:Polygon srsName="epsg:4326">
<ns2:Exterior>
<ns2:LineString>
<ns2:Pos>
<ns2:X>-74.12239074707031</ns2:X>
<ns2:Y>40.78827667236328</ns2:Y>
</ns2:Pos>
<ns2:Pos>
<ns2:X>-74.1226806640625</ns2:X>
<ns2:Y>40.788719177246094</ns2:Y>
</ns2:Pos>
......
<ns2:Pos>
<ns2:X>-74.1853168033443</ns2:X>
<ns2:Y>40.65807664011055</ns2:Y>
</ns2:Pos>
<ns2:Pos>
<ns2:X>-74.18765315676006</ns2:X>
<ns2:Y>40.65807664011055</ns2:Y>
</ns2:Pos>
</ns2:LineString>
</ns2:Ring>
</ns2:InteriorList>
</ns2:Polygon>
</ns2:MultiPolygon>
<IsoChroneCost>
<ns3:Time uom="Minute">20.0</ns3:Time>
</IsoChroneCost>
</TravelBoundary>
<TravelBoundary xsi:type="IsoChroneTravelBoundary" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns2:MultiPolygon srsName="epsg:4326">
<ns2:Polygon srsName="epsg:4326">
<ns2:Exterior>
<ns2:LineString>
<ns2:Pos>
<ns2:X>-74.1646741097915</ns2:X>
<ns2:Y>40.686006605152414</ns2:Y>
</ns2:Pos>
<ns2:Pos>
<ns2:X>-74.1646741097915</ns2:X>
<ns2:Y>40.68675357686172</ns2:Y>
</ns2:Pos>
.......
<ns2:Pos>
<ns2:X>-74.1220932006836</ns2:X>
<ns2:Y>40.78827667236328</ns2:Y>
</ns2:Pos>
<ns2:Pos>
<ns2:X>-74.12239074707031</ns2:X>
<ns2:Y>40.78827667236328</ns2:Y>
</ns2:Pos>
</ns2:LineString>
</ns2:Ring>
</ns2:InteriorList>
</ns2:Polygon>
</ns2:MultiPolygon>
<IsoChroneCost>
<ns3:Time uom="Minute">13.0</ns3:Time>
</IsoChroneCost>
</TravelBoundary>
</GetTravelBoundaryResponse>
</soap:Body>
</soap:Envelope>