GetTravelCostMatrix

GetTravelCostMatrix calcule le temps et les distances de trajet entre différents emplacements de départ et d'arrivée. Vous pouvez vous servir de GetTravelCostMatrix pour trouver les chemins les plus courts ou les plus rapides entre un certain nombre de points de départ et un certain nombre de points d'arrivée, et déterminer le total de temps et de distance des itinéraires au niveau individuel (coûts de l'itinéraire). Par exemple, si vous entrez quatre points de départ (de S1 à S4) et quatre points d'arrivée (de E1 à E4), 16 itinéraires au total seront renvoyés comme dans la figure suivante :

Cette méthode est souvent employée en vue de déterminer le temps de réponse d'un service et les couvertures de tels services, comme une caserne de pompiers ou un commissariat de police. Vous aurez peut-être besoin de ces calculs pour vous assurer qu'ils peuvent fournir une couverture adéquate pour les accords de niveau de service, par exemple avoir au moins une personne capable de répondre à un incident dans les 20 minutes suivant la première notification. Ce calcul peut servir d'outil d'analyse pour déterminer le risque d'une propriété ou d'une personne assurée en fonction de la probabilité qu'une ambulance, un agent de la sécurité publique ou un pompier puisse atteindre la propriété/personne dans un délai de temps raisonnable.
Remarque : Get Travel Cost Matrix est disponible uniquement sous forme de Service Web SOAP. Get Travel Cost Matrix n'est pas disponible via REST. Il n'est pas non plus disponible via les API Java, C++, C, .NET ni COM.

GetTravelCostMatrix fait partie du module Enterprise Routing.

URL de la ressource

http://server:port/soap/GetTravelCostMatrix

Exemple

Voici une demande SOAP :

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:get="http://www.pb.com/spectrum/services/GetTravelCostMatrix"
    xmlns:spec="http://spectrum.pb.com/"
    xmlns:get1="http://www.g1.com/services/GetTravelCostMatrix"
    xmlns:typ="http://www.g1.com/services/erm/types">
    <soapenv:Header/>
    <soapenv:Body>
        <get:GetTravelCostMatrixRequest>
            <get:input_port>
                <get:RouteMatrixRequest>
                    <get:StartPoints>
                        <get:StartPoint>
                            <get:Latitude>33.751748</get:Latitude>                            
                            <get:Longitude>-84.364014</get:Longitude>
                        </get:StartPoint>
                        <get:StartPoint>
                            <get:Latitude>33.870416</get:Latitude>
                            <get:Longitude>-78.62915</get:Longitude>
                        </get:StartPoint>
                        <get:StartPoint>
                            <get:Latitude>35.025498</get:Latitude>
                            <get:Longitude>-80.864868</get:Longitude>
                        </get:StartPoint>
                    </get:StartPoints>
                    <get:EndPoints>
                        <get:EndPoint>
                            <get:Latitude>33.664925</get:Latitude>
                            <get:Longitude>-80.90332</get:Longitude>
                        </get:EndPoint>
                        <get:EndPoint>
                            <get:Latitude>34.40691</get:Latitude>
                            <get:Longitude>-80.062866</get:Longitude>
                        </get:EndPoint>
                        <get:EndPoint>
                            <get:Latitude>34.921971</get:Latitude>
                            <get:Longitude>-81.013184</get:Longitude>
                        </get:EndPoint>
                    </get:EndPoints>
                </get:RouteMatrixRequest>
            </get:input_port>
        </get:GetTravelCostMatrixRequest>
    </soapenv:Body>
</soapenv:Envelope>

Voici la réponse :

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns5:GetTravelCostMatrixResponse xmlns:ns2="http://spectrum.pb.com/"
       xmlns:ns3="http://www.g1.com/services/erm/types"
       xmlns:ns4="http://www.g1.com/services/GetTravelCostMatrix"
       xmlns:ns5="http://www.pb.com/spectrum/services/GetTravelCostMatrix">
         <ns5:output_port>
            <ns5:RouteMatrixResponse>
               <ns5:TimeUnits>Minutes</ns5:TimeUnits>
               <ns5:DistanceUnits>Miles</ns5:DistanceUnits>
               <ns5:RouteCosts>
                  <ns5:RouteCost>
                     <ns5:StartPointRef>1</ns5:StartPointRef>
                     <ns5:EndPointRef>1</ns5:EndPointRef>
                     <ns5:Time>215.82</ns5:Time>
                     <ns5:Distance>218.441</ns5:Distance>
                  </ns5:RouteCost>
                  <ns5:RouteCost>
                     <ns5:StartPointRef>2</ns5:StartPointRef>
                     <ns5:EndPointRef>2</ns5:EndPointRef>
                     <ns5:Time>124.82</ns5:Time>
                     <ns5:Distance>103.437</ns5:Distance>
                  </ns5:RouteCost>
                  <ns5:RouteCost>
                     <ns5:StartPointRef>3</ns5:StartPointRef>
                     <ns5:EndPointRef>3</ns5:EndPointRef>
                     <ns5:Time>22.53</ns5:Time>
                     <ns5:Distance>15.005</ns5:Distance>
                  </ns5:RouteCost>
               </ns5:RouteCosts>
               <ns5:user_fields/>
            </ns5:RouteMatrixResponse>
         </ns5:output_port>
      </ns5:GetTravelCostMatrixResponse>
   </soap:Body>
</soap:Envelope>