GetTravelBoundary
GetTravelBoundary détermine une limite de distance ou de temps de marche ou de conduite en voiture à partir d'un emplacement. Cette fonctionnalité obtient des polygones correspondant à un calcul d'isochrone ou d'isodistance. Un isochrone est un polygone ou ensemble de points représentant une zone pouvant être traversée à partir d'un point de départ en un temps donné via un réseau routier. Un isodistance est un polygone ou ensemble de points représentant la zone située à une certaine distance par rapport à un point de départ. L'opération Get Travel Boundary (également appelée une définition iso) prend comme entrée un point de départ, une unité (linéaire ou temporelle), un ou plusieurs coûts et leurs balises associées, et renvoie la limite de chemin à parcourir ainsi obtenue. Le coût fait référence à la quantité de temps ou de distance à utiliser pour calculer un iso. Une balise est une chaîne qui identifie le coût et permet de mettre en correspondance le résultat correspondant. Plusieurs coûts peuvent être fournis en entrée, à condition qu'ils le soient sous forme de liste délimitée par des « ; ».
GetTravelBoundary fait partie du module Enterprise Routing.
Remarque : GetTravelBoundary est disponible uniquement sous forme de Service Web. GetTravelBoundary n'est pas disponible via les API Java, C++, C, .NET ou COM.
URL de la ressource
http://server:port/soap/GetTravelBoundaryExemple
Cas 1, un seul coût :
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:get="http://www.pb.com/spectrum/services/GetTravelBoundary">
<soapenv:Header/>
<soapenv:Body>
<get:GetTravelBoundaryRequest>
<get:input_port>
<get:IsoRouteRequest>
<get:Latitude>33.751748</get:Latitude>
<get:Longitude>-84.364014</get:Longitude>
<get:TravelBoundaryCost>10</get:TravelBoundaryCost>
<get:TravelBoundaryCostUnits>Kilometers</get:TravelBoundaryCostUnits>
</get:IsoRouteRequest>
</get:input_port>
</get:GetTravelBoundaryRequest>
</soapenv:Body>
</soapenv:Envelope>Voici la réponse :
Remarque : Certains points ont été supprimés de cet exemple à des fins de raccourci.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns4:GetTravelBoundaryResponse xmlns:ns2="http://spectrum.pb.com/"
xmlns:ns3="http://www.mapinfo.com/midev/service/geometries/v1"
xmlns:ns4="http://www.pb.com/spectrum/services/GetTravelBoundary">
<ns4:output_port>
<ns4:IsoRouteResponse>
<ns4:IsoNodeResponse/>
<ns4:IsoPolygonResponse
xsi:type="ns3:MultiPolygon"
srsName="epsg:4326"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns3:Polygon srsName="epsg:4326">
<ns3:Exterior>
<ns3:LineString>
<ns3:Pos>
<ns3:X>-84.34868168466456</ns3:X>
<ns3:Y>33.68373169496257</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.36945064055561</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69303002973829</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.69391558543121</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.6936408692491</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.42163929894845</ns3:X>
<ns3:Y>33.716054477754355</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.4440058668311</ns3:X>
<ns3:Y>33.710741143596806</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.43921303085625</ns3:X>
<ns3:Y>33.72800947960886</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.45678676276404</ns3:X>
<ns3:Y>33.73376559161287</ns3:Y>
</ns3:Pos>
...
</ns3:LineString>
</ns3:Exterior>
</ns3:Polygon>
</ns4:IsoPolygonResponse>
<ns4:user_fields/>
</ns4:IsoRouteResponse>
</ns4:output_port>
</ns4:GetTravelBoundaryResponse>
</soap:Body>
</soap:Envelope>Cas 2, plusieurs coûts :
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:get="http://www.pb.com/spectrum/services/GetTravelBoundary">
<soapenv:Header/>
<soapenv:Body>
<get:GetTravelBoundaryRequest>
<get:input_port>
<get:IsoRouteRequest>
<get:Latitude>33.751748</get:Latitude>
<get:Longitude>-84.364014</get:Longitude>
<get:TravelBoundaryCost>5;10</get:TravelBoundaryCost>
<get:TravelBoundaryCostUnits>Kilometers</get:TravelBoundaryCostUnits>
</get:IsoRouteRequest>
</get:input_port>
</get:GetTravelBoundaryRequest>
</soapenv:Body>
</soapenv:Envelope>Voici la réponse :
Remarque : Certains points ont été supprimés de cet exemple à des fins de raccourci.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns4:GetTravelBoundaryResponse xmlns:ns2="http://spectrum.pb.com/"
xmlns:ns3="http://www.mapinfo.com/midev/service/geometries/v1"
xmlns:ns4="http://www.pb.com/spectrum/services/GetTravelBoundary">
<ns4:output_port>
<ns4:IsoRouteResponse>
<ns4:cost>5</ns4:cost>
<ns4:costUnits>Kilometers</ns4: costUnits >
<ns4:IsoNodeResponse/>
<ns4:IsoPolygonResponse
xsi:type="ns3:MultiPolygon"
srsName="epsg:4326"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns3:Polygon srsName="epsg:4326">
<ns3:Exterior>
<ns3:LineString>
<ns3:Pos>
<ns3:X>-84.34868168466456</ns3:X>
<ns3:Y>33.68373169496257</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.36945064055561</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69303002973829</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.69391558543121</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.6936408692491</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.42163929894845</ns3:X>
<ns3:Y>33.716054477754355</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.4440058668311</ns3:X>
<ns3:Y>33.710741143596806</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.43921303085625</ns3:X>
<ns3:Y>33.72800947960886</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.45678676276404</ns3:X>
<ns3:Y>33.73376559161287</ns3:Y>
</ns3:Pos>
...
</ns3:LineString>
</ns3:Exterior>
</ns3:Polygon>
</ns4:IsoPolygonResponse>
<ns4:user_fields/>
</ns4:IsoRouteResponse>
<ns4:IsoRouteResponse>
<ns4:cost>10</ns4:cost>
<ns4:costUnits>Kilometers</ns4: costUnits >
<ns4:IsoNodeResponse/>
<ns4:IsoPolygonResponse
xsi:type="ns3:MultiPolygon"
srsName="epsg:4326"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns3:Polygon srsName="epsg:4326">
<ns3:Exterior>
<ns3:LineString>
<ns3:Pos>
<ns3:X>-84.34868168466456</ns3:X>
<ns3:Y>33.68373169496257</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.36945064055561</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69293307108579</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.3694506405556</ns3:X>
<ns3:Y>33.69303002973829</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.69391558543121</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.37104825254721</ns3:X>
<ns3:Y>33.6936408692491</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.42163929894845</ns3:X>
<ns3:Y>33.716054477754355</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.4440058668311</ns3:X>
<ns3:Y>33.710741143596806</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.43921303085625</ns3:X>
<ns3:Y>33.72800947960886</ns3:Y>
</ns3:Pos>
<ns3:Pos>
<ns3:X>-84.45678676276404</ns3:X>
<ns3:Y>33.73376559161287</ns3:Y>
</ns3:Pos>
...
</ns3:LineString>
</ns3:Exterior>
</ns3:Polygon>
</ns4:IsoPolygonResponse>
<ns4:user_fields/>
</ns4:IsoRouteResponse>
</ns4:output_port>
</ns4:GetTravelBoundaryResponse>
</soap:Body>
</soap:Envelope>