単純マルチアドレス・ルート・リクエストには、必須の<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スキーマ定義」で説明しています。