13.1.2 単純マルチアドレス・ルート・リクエスト

単純マルチアドレス・ルート・リクエストには、必須の<start_location>要素など、少なくとも3つの場所が含まれている必要があります。マルチアドレス・ルート・リクエストには、1つ以上の<location>要素も含まれている必要があり、オプションで<end_location>要素が含まれます。

単純マルチアドレス・ルート・リクエストの結果は、各中間地を通る、出発地から目的地までの単一のルートです。この単一ルートは複数のサブルートで構成されます。サブルートは、個々の場所間のルートです。

単純マルチアドレス・ルート・リクエストでは、optimize_route属性が存在しないかFALSEに設定されている必要があります。単純マルチアドレス・ルート・リクエストでは、すべての場所が固定されます。場所を訪れる順序の最適化は試行されません。ルート内の場所は、リクエストで指定された順序で訪問されます。

単純マルチアドレス・ルート・リクエストでは、route_type属性を使用して、ルートを開いた行程または閉じた行程として分類します。

• 開いた行程: ルートは最終中間地または指定した目的地で終了します。

• 閉じた行程: ルートは出発地に戻ります。

  単純マルチアドレスの閉じた行程ルートがリクエストされた場合、ルート計算中に<start_location>要素指定は目的地としても使用されます。単純マルチアドレスの閉じた行程ルート・リクエストで<end_location>要素が指定されている場合は、エラーが戻されます。

例: 単純マルチアドレスの開いた行程ルート・リクエスト

職場から顧客Aまで運転し、次に顧客B、その次に顧客Cまで運転する必要があるとします。

• ルート・リクエストには、職場が出発地、顧客AとBが中間地、そして顧客Cが目的地として含まれます。

• 戻されるルートには、(1)職場から顧客A、(2)顧客Aから顧客Bおよび(3)顧客Bから顧客Cという3つのサブルートが含まれます。

• 各サブルートには、複数のセグメントが含まれる場合があり、各セグメントは、特定の運転方向ステップに関連付けられます。

例: 単純マルチアドレスの閉じた行程ルート・リクエスト

職場から顧客Aまで運転し、次に顧客B、その次に顧客Cまで運転してから、職場に戻る必要があるとします。

• ルート・リクエストには、職場が出発地、顧客A、B、Cが中間地として含まれます。職場は目的地としても使用されます。<end_location>要素はルート・リクエストで指定しないでください。ルーティング・エンジンは、閉じた行程のリクエストを検出すると、顧客Cから職場までのサブルートを自動的に追加します。

• 戻されるルートには、(1)職場から顧客A、(2)顧客Aから顧客B、(3)顧客Bから顧客Cおよび(4)顧客Cから職場という4つのサブルートが含まれます。

• 各サブルートには、複数のセグメントが含まれる場合があり、各セグメントは、特定の運転方向ステップに関連付けられます。

単純マルチアドレス・リクエストには、各サブルートに固有の複数の属性を含めることができます。これらの属性には、return_subroutes、return_subroute_edge_idsおよびreturn_subroute_geometryが含まれます。これらの属性については、「ルート・リクエストXMLスキーマ定義」で説明しています。