GetRouteCostMatrix への一時更新の追加

一時更新とは

各要求向けのルーティング データに対して加えることができる変更であり、そのリクエストの処理後は持続しない変更です。例えば、サーバーがすべての幹線道路タイプを回避したり、何らかの基準に基づいて特定のポイントでの速度を変更したりするように要求できます。要求ごとに 1 つ以上の更新を含めることができます。速度更新の場合、正の速度値は速度の増加、負の速度値は速度の減少です。主に次の 3 種類の更新があります。

  1. ポイント (割合、速度、速度調整、および除外更新をサポート)
  2. セグメント (割合、速度、速度調整、除外、および道路タイプ更新をサポート)
  3. 道路タイプ (割合、速度、および速度調整更新をサポート)

ポイントの更新は、対応するポイント (緯度、経度) に適用される変更です。特定のポイントに対して、ポイントの除外、ポイントの速度の設定、値または割合によるポイントの速度の変更 (増加または減少) を行うことができます。セグメントの更新は、対応するセグメント ID に適用される変更です。特定のセグメントに対して、セグメントの除外、セグメントの速度の設定、値または割合によるセグメントの速度の変更 (増加または減少)、セグメントの道路タイプの変更を行うことができます。道路タイプの更新は、対応する道路タイプに適用される変更です。特定の道路タイプに対して、道路タイプの速度の設定、値または割合による道路タイプの速度の変更 (増加または減少) を行うことができます。

構文とオプションの詳細については、ルーティング スキーマの「TransientUpdates」を参照してください。

以下では、更新のさまざまなタイプについて説明します。

更新タイプ

説明

割合

速度を増加 (正の値) または減少 (負の値) させる割合を指定して速度の増加を定義する速度更新です。

速度

速度単位と新しい速度を指定して新しい速度を定義する速度更新です。速度更新の場合、速度単位には kph (キロメートル/時)、mph (マイル/時)、mps (メートル/秒)、mtpm (メートル/分) のいずれかの値を指定できます。

速度調整

速度の変化 (単位と値) を指定して速度変化を定義する速度更新です。速度値は増加 (正の値) または減少 (負の値) させることができます。速度更新の場合、速度単位には kph (キロメートル/時)、mph (マイル/時)、mps (メートル/秒)、mtpm (メートル/分) のいずれかの値を指定できます。

除外

ルートの指定部分を計算から除外するための boolean 値です。

道路タイプ

ルート計算に使用する道路タイプの値を変更する文字列値です。

例

45 kph (キロメートル/時) の速度調整が含まれているポイント更新を含む完全なコスト マトリクス要求。

<soapenv:Envelope 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">
   <soapenv:Header/>
   <soapenv:Body>
      <v1:RouteCostMatrixRequest id="?" locale="?">
         <v1:StartPoints srsName="epsg:4326">
            <v11:Point srsName="epsg:4326">
               <v11:Pos>
                  <v11:X>-73.972033</v11:X>
                  <v11:Y>40.794928</v11:Y>
               </v11:Pos>
            </v11:Point>             
		</v1:StartPoints>
		<v1:EndPoints srsName="epsg:4326">
            <v11:Point srsName="">
               <v11:Pos>
                  <v11:X> -73.985617</v11:X>
                  <v11:Y>40.747</v11:Y>
               </v11:Pos>
            </v11:Point>
		</v1:EndPoints>
		<v1:DistanceUnit>Meter</v1:DistanceUnit>
		<v1:TimeUnit>Second</v1:TimeUnit>
		<v1:ReturnOptimalRoutesOnly/>
		<v1:TransientUpdates>
			<v1:PointUpdateList>
				<v1:Point srsName="epsg:4326">
				<v11:Pos>
					<v11:X>-73.985516</v11:X>
					<v11:Y>40.747157</v11:Y>
				</v11:Pos>
				</v1:Point>
                <v1:PointTypeUpdates>
					<v1:SpeedUpdate>
						<v1:SpeedAdjustment uom="KPH">45</v1:SpeedAdjustment>
					</v1:SpeedUpdate>
				</v1:PointTypeUpdates>
			</v1:PointUpdateList>
		</v1:TransientUpdates>
	   <v1:DatasetResourceName>US_NE</v1:DatasetResourceName>
	   </v1:RouteCostMatrixRequest>
   </soapenv:Body>
</soapenv:Envelope>

減速割合の変化 50 が含まれているセグメント更新を含むコスト マトリクス要求の TransientUpdates セクションのみ。

<v1:TransientUpdates>
	<v1:SegmentUpdateList>
			<v1:SegmentID>7e3396fc:1511c75</v1:SegmentID>
			<v1:SegmentTypeUpdates>
				<v1:SpeedUpdate>
					<v1:Percentage>-50</v1:Percentage>
				</v1:SpeedUpdate>
			</v1:SegmentTypeUpdates>
	</v1:SegmentUpdateList>
</v1:TransientUpdates>

増加の速度調整 13 mps (マイル/秒) が含まれている道路タイプ更新を含むコスト マトリクス要求の TransientUpdates セクションのみ。

<v1:TransientUpdates>
	<v1:RoadTypeUpdateList>
		<v1:RoadType>normal road dense urban</v1:RoadType>
		<v1:RoadTypeUpdates>
			<v1:SpeedUpdate>
				<v1:SpeedAdjustment uom="MPS">13</v1:SpeedAdjustment>
			</v1:SpeedUpdate>
		</v1:RoadTypeUpdates>
	</v1:RoadTypeUpdateList>
</v1:TransientUpdates>