GetTravelBoundary
GetTravelBoundary は、ロケーションから一定の時間または距離で、車両または徒歩で到達可能なエリアの境界を示します。この機能では、時間到達圏または距離到達圏の計算に基づくポリゴンを取得します。時間到達圏とは、始点から一定時間内に道路を通って到達できるエリアを表すポリゴンまたはポイントの集まりです。距離到達圏とは、始点から一定距離の移動で到達できるエリアを表すポリゴンまたはポイントの集まりです。Get Travel Boundary 操作 (到達圏定義とも呼ばれます) は、始点、単位 (距離または時間)、1 つ以上のコスト、およびそれらに関連付けられたタグを入力として受け取り、生成された経路境界を返します。コストとは、到達圏計算に使用する時間または距離の量を意味します。タグは、コストを一意に指す文字列で、対応する結果とのマッチングに使用されます。複数のコストを “;” 区切り文字列として提供することで、コストを入力として指定できます。
GetTravelBoundary は、Enterprise Routing モジュールに含まれています。
注: GetTravelBoundary は、Web サービスとしてのみ利用可能です。GetTravelBoundary を、Java、C++、C、.NET、または COM API を介して利用することはできません。
リソース URL
http://server:port/soap/GetTravelBoundary
例
ケース 1、単一のコスト:
<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>
応答は次のようになります。
注: この例では、短縮のため一部のポイントが削除されています。
<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>
ケース 2、複数のコスト:
<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>
応答は次のようになります。
注: この例では、短縮のため一部のポイントが削除されています。
<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>