Package google.maps.routeoptimization.v1

int32

실행된 배송 수입니다. 픽업 및 배송 쌍은 한 번만 집계됩니다.

Duration

경로 또는 솔루션의 총 이동 시간입니다.

Duration

경로 또는 솔루션의 총 대기 시간입니다.

Duration

경로 또는 솔루션의 총 지연 시간입니다.

Duration

경로 또는 솔루션의 총 휴식 시간입니다.

Duration

경로 또는 솔루션의 총 방문 시간입니다.

Duration

총 지속 시간은 위의 모든 지속 시간의 합과 같아야 합니다. 경로의 경우 다음에도 해당합니다.

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

경로 또는 솔루션의 총 이동 거리입니다.

map<string, VehicleLoad>

전체 경로 (또는 솔루션)에서 달성된 최대 부하입니다. 이 경로 (또는 솔루션)의 각 수량에 대해 모든 Transition.vehicle_loads (또는 ShipmentRoute.metrics.max_loads.

int32

실행된 필수 배송 수입니다.

실험적: 이 필드의 동작 또는 존재는 향후 변경될 수 있습니다.

double

실행된 배송의 Shipment.penalty_cost 합계입니다.

실험적: 이 필드의 동작 또는 존재는 향후 변경될 수 있습니다.

string

필수 항목입니다. 전화를 걸 프로젝트와 위치를 타겟팅합니다.

형식:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

위치를 지정하지 않으면 리전이 자동으로 선택됩니다.

AsyncModelConfig

필수 항목입니다. 파일 경로, 데이터 형식 등 각 구매 모델의 입력/출력 정보

string

선택사항입니다. 사용자가 모델을 추적하기 위해 별칭으로 사용할 수 있는 사용자 정의 모델 이름입니다.

InputConfig

필수 항목입니다. 입력 모델에 관한 정보입니다.

OutputConfig

필수 항목입니다. 원하는 출력 위치 정보입니다.

BreakRequest

휴식 시간의 순서입니다. BreakRequest 메시지를 확인합니다.

FrequencyConstraint

여러 FrequencyConstraint가 적용될 수 있습니다. 이 BreakRule의 BreakRequest로 모두 충족되어야 합니다. FrequencyConstraint를 참고하세요.

Timestamp

필수 항목입니다. 광고 시점 시작의 하한 (포함)입니다.

Timestamp

필수 항목입니다. 광고 시작의 상한 (포함)입니다.

Duration

필수 항목입니다. 광고 시점의 최소 길이입니다. 양수여야 합니다.

Duration

필수 항목입니다. 이 제약 조건의 최소 휴식 시간입니다. 음수가 아님 FrequencyConstraint의 설명을 참고하세요.

Duration

필수 항목입니다. duration >= min_break_duration 휴식이 적어도 부분적으로 포함되지 않은 경로의 시간 간격에서 허용되는 최대 범위입니다. 양수여야 합니다.

int64

거리가 최대 max_meters가 되도록 제한하는 하드 제한입니다. 한도는 음수가 아니어야 합니다.

int64

최대 거리 제한을 적용하지 않는 소프트 제한이지만 위반 시 모델에 정의된 다른 비용에 합산되는 비용이 발생합니다(단위는 동일).

soft_max_meters가 정의된 경우 max_meters보다 작아야 하고 음수가 아니어야 합니다.

double

발생한 킬로미터당 비용으로, 최대 soft_max_meters까지 증가하며 공식은 다음과 같습니다.

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

이 비용은 route_distance_limit에서 지원되지 않습니다.

double

거리가 soft_max_meters 한도를 초과하는 경우 발생하는 킬로미터당 비용입니다. 거리가 한도 미만이면 추가 비용은 0입니다. 그렇지 않으면 비용을 계산하는 데 사용되는 공식은 다음과 같습니다.

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

비용은 음수가 아니어야 합니다.

string

필수 항목입니다. Google Cloud Storage URI입니다.

string

필수 항목입니다. gs://bucket/path/to/object 형식의 Google Cloud Storage 객체의 URI입니다.

ShipmentRoute

삽입할 솔루션의 경로입니다. 일부 경로는 원래 솔루션에서 누락될 수 있습니다. 경로와 건너뛴 배송은 injected_first_solution_routes에 나열된 기본 유효성 가정을 충족해야 합니다.

SkippedShipment

삽입할 솔루션의 배송을 건너뛰었습니다. 일부는 원래 솔루션에서 누락될 수 있습니다. routes 필드를 참고하세요.

ConstraintRelaxation

0개 이상의 차량 그룹에 대해 제약 조건을 완화할 시기와 완화할 양을 지정합니다. 이 필드가 비어 있으면 비어 있지 않은 모든 차량 경로가 완전히 제한됩니다.

Relaxation

vehicle_indices에 있는 차량이 있는 경로의 방문에 적용되는 모든 방문 제약 조건 완화입니다.

int32

방문 제약 조건 relaxations가 적용되는 차량 색인을 지정합니다. 비어 있으면 기본값으로 간주되며 relaxations이 다른 constraint_relaxations에 지정되지 않은 모든 차량에 적용됩니다. 기본값은 최대 하나일 수 있습니다. 즉, 제약 조건 완화 필드는 최대 하나만 비어 있는 vehicle_indices이 허용됩니다. 차량 색인은 여러 constraint_relaxations 내에서도 한 번만 등록할 수 있습니다.

interpret_injected_solutions_using_labels이 true인 경우 차량 색인은 ShipmentRoute.vehicle_index와 동일하게 매핑됩니다 (fields 주석 참고).

Level

threshold_time 이상 및 threshold_visit_count 이상의 조건이 충족될 때 적용되는 제약 조건 완화 수준입니다.

Timestamp

완화 level를 적용할 수 있는 시간 또는 그 이후의 시간입니다.

int32

완화 level가 적용될 수 있는 방문 수입니다. threshold_visit_count가 0이거나 설정되지 않은 경우 level이 차량 시작 시 직접 적용될 수 있습니다.

route.visits_size() + 1인 경우 level은 차량 끝에만 적용할 수 있습니다. route.visits_size() + 1을 초과하면 해당 경로에 level이 전혀 적용되지 않습니다.

DataFormat

필수 항목입니다. 입력 데이터 형식입니다.

GcsSource

Google Cloud Storage 위치입니다. 단일 객체 (파일)여야 합니다.

LatLng

경유지의 지리 좌표입니다.

int32

트래픽 흐름 방향과 연결된 나침반 방향입니다. 이 값은 승차 및 하차에 사용할 도로 측면을 지정하는 데 사용됩니다. 방향 값은 0~360이며, 0은 북쪽, 90은 동쪽 등을 나타냅니다.

string

필수 항목입니다. 전화를 걸 프로젝트 또는 위치를 타겟팅합니다.

형식:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

위치를 지정하지 않으면 리전이 자동으로 선택됩니다.

Duration

이 제한 시간이 설정되면 제한 시간이 경과하거나 동기 요청의 서버 기한에 도달하기 전에 서버에서 응답을 반환합니다(둘 중 더 빠른 시점).

비동기 요청의 경우 서버는 제한 시간이 경과하기 전에 솔루션을 생성합니다 (가능한 경우).

ShipmentModel

해결할 배송 모델입니다.

SolvingMode

기본적으로 해결 모드는 DEFAULT_SOLVE (0)입니다.

SearchMode

요청을 해결하는 데 사용된 검색 모드입니다.

ShipmentRoute

최적화 알고리즘이 이전 솔루션과 유사한 첫 번째 솔루션을 찾도록 안내합니다.

첫 번째 솔루션을 빌드할 때 모델이 제한됩니다. 경로에서 수행되지 않은 배송은 첫 번째 솔루션에서 암시적으로 건너뛰지만 후속 솔루션에서는 수행될 수 있습니다.

솔루션은 몇 가지 기본적인 유효성 가정을 충족해야 합니다.

• 모든 경로에서 vehicle_index이 범위 내에 있어야 하며 중복되지 않아야 합니다.
• 모든 방문에서 shipment_index 및 visit_request_index이 범위 내에 있어야 합니다.
• 배송은 하나의 경로에서만 참조할 수 있습니다.
• 수령-배송 상품의 수령은 배송 전에 이루어져야 합니다.
• 하나 이상의 수령 대안 또는 배송 대안을 수행할 수 있습니다.
• 모든 경로에서 시간이 증가하고 있습니다 (즉, vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time)
• 배송은 허용된 차량에서만 수행할 수 있습니다. Shipment.allowed_vehicle_indices이 비어 있거나 vehicle_index이 Shipment.allowed_vehicle_indices에 포함된 경우 차량이 허용됩니다.

삽입된 솔루션이 불가능한 경우 유효성 검사 오류가 반환되지 않을 수 있으며 불가능함을 나타내는 오류가 대신 반환될 수 있습니다.

InjectedSolutionConstraint

최적화 알고리즘이 이전 솔루션과 유사한 최종 솔루션을 찾도록 제한합니다. 예를 들어 이미 완료되었거나 완료될 예정이지만 수정해서는 안 되는 경로의 일부를 고정하는 데 사용할 수 있습니다.

삽입된 솔루션이 불가능한 경우 유효성 검사 오류가 반환되지 않을 수 있으며 불가능함을 나타내는 오류가 대신 반환될 수 있습니다.

ShipmentRoute

비어 있지 않으면 지정된 경로가 새로고침되며, 방문 또는 이동 시간의 기본 순서는 수정되지 않습니다. 다른 세부정보만 업데이트됩니다. 이렇게 해도 모델이 해결되지는 않습니다.

2020년 11월부터는 비어 있지 않은 경로의 폴리라인만 채우며 populate_polylines이 true여야 합니다.

전달된 경로의 route_polyline 필드가 경로 transitions와 일치하지 않을 수 있습니다.

이 필드는 injected_first_solution_routes 또는 injected_solution_constraint와 함께 사용할 수 없습니다.

Shipment.ignore 및 Vehicle.ignore는 동작에 영향을 미치지 않습니다. 관련 배송 또는 차량이 무시되는지 여부와 관계없이 비어 있지 않은 모든 경로의 모든 방문 사이에 폴리라인이 계속 채워집니다.

bool

참인 경우:

• vehicle_index 대신 ShipmentRoute.vehicle_label를 사용하여 삽입된 솔루션의 경로를 요청의 차량과 일치시킵니다. 원래 ShipmentRoute.vehicle_index의 매핑을 새 ShipmentRoute.vehicle_index에 재사용하여 비어 있지 않은 경우 ConstraintRelaxation.vehicle_indices를 업데이트하지만 매핑은 명확해야 합니다 (즉, 여러 ShipmentRoute가 동일한 원래 vehicle_index를 공유해서는 안 됨).
• 삽입된 솔루션의 방문을 요청의 배송과 일치시키기 위해 shipment_index 대신 ShipmentRoute.Visit.shipment_label을 사용합니다.
• 삽입된 솔루션의 건너뛴 배송을 요청 배송과 일치시키기 위해 SkippedShipment.index 대신 SkippedShipment.label을 사용합니다.

이 해석은 injected_first_solution_routes, injected_solution_constraint, refresh_details_routes 필드에 적용됩니다. 요청의 배송 또는 차량 색인이 솔루션이 생성된 이후 변경된 경우에 사용할 수 있습니다. 예를 들어 배송 또는 차량이 요청에서 삭제되거나 요청에 추가된 경우입니다.

true인 경우 다음 카테고리의 라벨이 카테고리에 최대 한 번 표시되어야 합니다.

• 요청의 Vehicle.label
• 요청의 Shipment.label
• 삽입된 솔루션의 ShipmentRoute.vehicle_label
• SkippedShipment.label 및 ShipmentRoute.Visit.shipment_label가 삽입된 솔루션에 표시됩니다 (shipment_label가 두 번 표시되어야 하는 수령/배송 방문 쌍 제외).

삽입된 솔루션의 vehicle_label이 요청 차량에 해당하지 않으면 해당 경로가 방문과 함께 솔루션에서 삭제됩니다. 삽입된 솔루션의 shipment_label이 요청된 배송과 일치하지 않으면 해당 방문이 솔루션에서 삭제됩니다. 삽입된 솔루션의 SkippedShipment.label이 요청된 배송과 일치하지 않으면 SkippedShipment이 솔루션에서 삭제됩니다.

삽입된 솔루션에서 경로 방문 또는 전체 경로를 삭제하면 암시된 제약 조건에 영향을 미쳐 솔루션 변경, 유효성 검사 오류 또는 불가능성이 발생할 수 있습니다.

참고: 호출자는 각 Vehicle.label (또는 Shipment.label)은 삽입된 솔루션에 사용된 OptimizeToursResponse을 생성한 이전 요청과 삽입된 솔루션을 포함하는 현재 요청이라는 두 관련 요청에서 사용되는 차량 (또는 배송) 엔티티를 고유하게 식별합니다. 위에서 설명한 고유성 검사만으로는 이 요구사항을 보장할 수 없습니다.

bool

ShipmentRoute 필드 Transition.travel_duration, Visit.start_time, vehicle_end_time을 계산하고, ShipmentRoute.has_traffic_infeasibilities 필드를 설정하고, OptimizeToursResponse.total_cost 필드를 계산할 때 트래픽 추정치를 고려합니다.

bool

true인 경우 폴리라인이 응답 ShipmentRoute에 채워집니다.

bool

true인 경우 폴리라인과 경로 토큰이 응답 ShipmentRoute.transitions에 채워집니다.

bool

이 값이 설정되면 요청의 기한 (https://grpc.io/blog/deadlines 참고)이 최대 60분까지 될 수 있습니다. 그렇지 않으면 최대 기한은 30분입니다. 장기 실행 요청은 중단될 위험이 훨씬 더 크지만 여전히 작습니다.

bool

true인 경우 이동 거리는 Google 지도 거리 대신 측지선 거리를 사용하여 계산되고 이동 시간은 geodesic_meters_per_second에 정의된 속도로 측지선 거리를 사용하여 계산됩니다.

string

이 요청을 식별하는 데 사용할 수 있는 라벨로, OptimizeToursResponse.request_label에 다시 보고됩니다.

double

use_geodesic_distances가 true인 경우 이 필드를 설정해야 하며 이동 시간 계산에 적용되는 속도를 정의합니다. 값은 1.0미터/초 이상이어야 합니다.

int32

반환된 유효성 검사 오류 수를 자릅니다. 이러한 오류는 일반적으로 solving_mode=VALIDATE_ONLY가 아닌 경우 BadRequest 오류 세부정보 (https://cloud.google.com/apis/design/errors#error_details)로 INVALID_ARGUMENT 오류 페이로드에 연결됩니다. OptimizeToursResponse.validation_errors 필드를 참고하세요. 기본값은 100이며 최대값은 10,000입니다.

ShipmentRoute

각 차량에 대해 계산된 경로입니다. i번째 경로는 모델의 i번째 차량에 해당합니다.

string

요청에 라벨이 지정된 경우 OptimizeToursRequest.label의 사본입니다.

SkippedShipment

건너뛴 모든 배송 목록입니다.

OptimizeToursValidationError

Google에서 독립적으로 감지할 수 있는 모든 검사 오류의 목록입니다. OptimizeToursValidationError 메시지의 'MULTIPLE ERRORS' 설명을 참고하세요. 오류 대신 solving_mode가 DEFAULT_SOLVE인 경우 경고가 포함됩니다.

OptimizeToursRequest

경우에 따라 문제를 해결하기 전에 수신 요청을 수정합니다(예: 비용 추가). solving_mode == TRANSFORM_AND_RETURN_REQUEST인 경우 수정된 요청이 여기에 반환됩니다.

실험 단계: 자세한 내용은 https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request를 참고하세요.

Metrics

이 솔루션의 기간, 거리, 사용량 측정항목입니다.

AggregatedMetrics

경로를 통해 집계됩니다. 각 측정항목은 이름이 동일한 모든 ShipmentRoute.metrics 필드의 합계 (또는 로드의 경우 최대값)입니다.

int32

건너뛴 필수 배송 수입니다.

int32

사용된 차량 수입니다. 참고: 차량 경로가 비어 있고 Vehicle.used_if_route_is_empty이 true이면 차량이 사용된 것으로 간주됩니다.

Timestamp

사용된 차량의 가장 빠른 시작 시간으로, 모든 사용된 차량의 최소값인 ShipmentRoute.vehicle_start_time로 계산됩니다.

Timestamp

사용된 차량의 최신 종료 시간으로, 모든 사용된 차량의 ShipmentRoute.vehicle_end_time 중 최댓값으로 계산됩니다.

map<string, double>

비용 관련 요청 필드별로 분류된 솔루션 비용입니다. 키는 입력 OptimizeToursRequest를 기준으로 하는 프로토 경로입니다(예: 'model.shipments.pickups.cost'). 값은 전체 솔루션에서 집계된 해당 비용 필드로 생성된 총비용입니다. 즉, costs["model.shipments.pickups.cost"] 는 솔루션 전반의 모든 수령 비용의 합계입니다. 모델에 정의된 모든 비용은 여기에 자세히 보고됩니다. 단, 2022년 1월부터 집계된 방식으로만 보고되는 TransitionAttributes와 관련된 비용은 예외입니다.

double

솔루션의 총비용입니다. 비용 맵에 있는 모든 값의 합계입니다.

string

필수 항목입니다. 전화를 걸 프로젝트 또는 위치를 타겟팅합니다.

형식:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

위치를 지정하지 않으면 리전이 자동으로 선택됩니다.

Uri

필수 항목입니다. OptimizeToursRequest가 포함된 Cloud Storage 객체의 URI입니다.

Uri

필수 항목입니다. OptimizeToursResponse가 포함될 Cloud Storage 객체의 URI입니다.

Uri

선택사항입니다. JSON 또는 textproto로 인코딩된 OptimizeToursResponse가 포함된 Cloud Storage 객체의 URI입니다. 객체가 JSON으로 인코딩된 경우 객체 이름의 확장 프로그램은 .json입니다. 객체가 textproto로 인코딩된 경우 객체 이름의 확장 프로그램은 .txtpb입니다.

리소스의 crc32_checksum를 사용하여 리소스의 콘텐츠가 수정되지 않았는지 확인할 수 있습니다.

int32

유효성 검사 오류는 항상 존재하는 (code, display_name) 쌍으로 정의됩니다.

이 섹션 다음에 나오는 필드에는 오류에 관한 자세한 컨텍스트가 제공됩니다.

여러 오류: 오류가 여러 개 있는 경우 검증 프로세스에서 여러 오류를 출력하려고 합니다. 컴파일러와 마찬가지로 완벽한 프로세스는 아닙니다. 일부 검증 오류는 '심각'하여 전체 검증 프로세스를 중지합니다. display_name="UNSPECIFIED" 오류의 경우가 여기에 해당됩니다. 일부 오류로 인해 유효성 검사 프로세스에서 다른 오류를 건너뛸 수 있습니다.

안정성: code 및 display_name는 매우 안정적이어야 합니다. 하지만 시간이 지남에 따라 새 코드와 표시 이름이 표시될 수 있으며, 이로 인해 새 오류가 이전 오류를 숨겨 특정 (유효하지 않은) 요청에서 다른 (code, display_name) 쌍이 생성될 수 있습니다. 예를 들어 'MULTIPLE ERRORS'를 참고하세요.

string

오류 표시 이름입니다.

FieldReference

오류 컨텍스트에는 0개, 1개 (대부분의 경우) 또는 그 이상의 필드가 포함될 수 있습니다. 예를 들어 차량 4번과 배송 2번의 첫 번째 수령을 다음과 같이 참조할 수 있습니다.

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

하지만 특정 오류 코드의 경우 fields의 카디널리티는 변경되지 않습니다.

string

사람이 읽을 수 있는 오류를 설명하는 문자열입니다. code과 error_message 사이에는 1:1 매핑이 있습니다 (code != 'UNSPECIFIED'인 경우).

안정성: 불안정함: 특정 code와 연결된 오류 메시지가 시간이 지남에 따라 변경될 수 있습니다 (명확하게 하기 위함). 대신 display_name 및 code를 사용하세요.

string

필드의 값을 포함할 수 있습니다. 이 기능은 항상 제공되는 것은 아닙니다. 이 API를 사용해서는 안 되며 수동 모델 디버깅에만 사용해야 합니다.

string

필드 이름입니다(예: 'vehicles'

FieldReference

필요한 경우 재귀적으로 중첩된 하위 필드입니다.

int32

반복되는 경우 필드의 색인입니다.

string

필드가 맵인 경우 키입니다.

DataFormat

필수 항목입니다. 출력 데이터 형식입니다.

GcsDestination

출력을 기록할 Google Cloud Storage 위치입니다.

bool

합리적인 경우 유료도로를 피할지 여부를 지정합니다. 통행료가 포함되지 않은 경로가 우선적으로 표시됩니다. 모터로 작동하는 이동 수단에만 적용됩니다.

bool

합리적인 경우 고속도로를 피할지 여부를 지정합니다. 고속도로가 포함되지 않은 경로가 우선적으로 표시됩니다. 모터로 작동하는 이동 수단에만 적용됩니다.

bool

합리적인 경우 페리를 피할지 여부를 지정합니다. 페리를 이용하지 않는 경로가 우선적으로 표시됩니다. 모터로 작동하는 이동 수단에만 적용됩니다.

bool

선택사항입니다. 가능한 경우 실내 탐색을 피할지 여부를 지정합니다. 실내 탐색이 포함되지 않은 경로가 우선적으로 표시됩니다. WALKING 이동 모드에만 적용됩니다.

string

배송의 사용자 정의 표시 이름입니다. 최대 길이는 63자(영문 기준)이며 UTF-8 문자를 사용할 수 있습니다.

VisitRequest

배송과 연결된 픽업 대안 집합입니다. 지정하지 않으면 차량이 배송에 해당하는 위치만 방문하면 됩니다.

VisitRequest

배송과 관련된 배송 대안 집합입니다. 지정하지 않으면 차량이 픽업에 해당하는 위치만 방문하면 됩니다.

map<string, Load>

배송의 부하 요구사항 (예: 무게, 부피, 팔레트 수 등) 지도에 있는 키는 해당 로드의 유형을 설명하는 식별자여야 하며, 단위도 포함하는 것이 좋습니다. 예: 'weight_kg', 'volume_gallons', 'pallet_count' 등. 지정된 키가 맵에 표시되지 않으면 해당 로드는 null로 간주됩니다.

int32

이 배송을 수행할 수 있는 차량 집합입니다. 비어 있으면 모든 차량이 실행할 수 있습니다. 차량은 ShipmentModel의 vehicles 목록에 있는 색인으로 지정됩니다.

double

이 배송이 각 차량으로 배송될 때 발생하는 비용을 지정합니다. 지정된 경우 다음 중 하나가 있어야 합니다.

• costs_per_vehicle_indices와 동일한 수의 요소를 갖습니다. costs_per_vehicle[i]는 모델의 차량 costs_per_vehicle_indices[i]에 해당합니다.
• 모델에 있는 차량 수와 동일한 수의 요소가 있습니다. i번째 요소는 모델의 i번째 차량에 해당합니다.

이러한 비용은 penalty_cost와 동일한 단위여야 하며 음수여서는 안 됩니다. 이러한 비용이 없는 경우 이 필드를 비워 둡니다.

int32

costs_per_vehicle이 적용되는 차량의 색인입니다. 비어 있지 않은 경우 요소의 수가 costs_per_vehicle와 동일해야 합니다. 차량 색인은 두 번 이상 지정할 수 없습니다. 차량이 costs_per_vehicle_indices에서 제외되면 비용은 0입니다.

Duration

픽업에서 배송까지의 최단 경로와 비교한 최대 절대 우회 시간을 지정합니다. 지정된 경우 음수가 아니어야 하며 배송에는 수령과 배송이 하나 이상 포함되어야 합니다.

예를 들어 t를 선택한 수령 대체 옵션에서 선택한 배송 대체 옵션으로 직접 이동하는 데 걸리는 가장 짧은 시간이라고 가정해 보겠습니다. 그런 다음 pickup_to_delivery_absolute_detour_limit를 설정하면 다음이 적용됩니다.

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

동일한 배송에 상대적 한도와 절대적 한도가 모두 지정된 경우 가능한 각 수령/배송 쌍에 더 제한적인 한도가 사용됩니다. 2017년 10월 현재 우회는 이동 시간이 차량에 따라 달라지지 않는 경우에만 지원됩니다.

Duration

발송물의 수령 시작부터 배송 시작까지의 최대 기간을 지정합니다. 지정된 경우 음수가 아니어야 하며 배송에는 수령과 배송이 하나 이상 포함되어야 합니다. 이는 수령 및 배송에 선택된 대체 경로 또는 차량 속도와는 관련이 없습니다. 최대 우회 제약 조건과 함께 지정할 수 있습니다. 솔루션은 두 사양을 모두 준수합니다.

string

이 배송의 '유형'을 지정하는 비어 있지 않은 문자열입니다. 이 기능은 shipment_types 간의 비호환성 또는 요구사항을 정의하는 데 사용할 수 있습니다 (ShipmentModel의 shipment_type_incompatibilities 및 shipment_type_requirements 참고).

단일 방문에 지정된 visit_types와는 다릅니다. 동일한 배송에 속하는 모든 픽업/배송은 동일한 shipment_type를 공유합니다.

string

이 배송의 라벨을 지정합니다. 이 라벨은 해당 ShipmentRoute.Visit의 shipment_label에 응답으로 보고됩니다.

bool

true인 경우 이 배송을 건너뛰지만 penalty_cost을 적용하지는 않습니다.

모델에 shipment_type_requirements가 있는 경우 배송을 무시하면 유효성 검사 오류가 발생합니다.

injected_first_solution_routes 또는 injected_solution_constraint에서 수행된 배송을 무시할 수 있습니다. 솔버는 수행 경로에서 관련 수령/배송 방문을 삭제합니다. 무시된 배송을 참조하는 precedence_rules도 무시됩니다.

double

배송이 완료되지 않으면 이 페널티가 경로의 전체 비용에 추가됩니다. 수령 및 배송 대안 중 하나를 방문하면 배송이 완료된 것으로 간주됩니다. 비용은 모델의 다른 모든 비용 관련 필드에 사용되는 동일한 단위로 표현될 수 있으며 양수여야 합니다.

중요: 이 페널티가 지정되지 않으면 무한대로 간주됩니다. 즉, 배송이 완료되어야 합니다.

double

픽업 위치에서 배송 위치까지의 최단 경로와 비교한 최대 상대 우회 시간을 지정합니다. 지정된 경우 음수가 아니어야 하며 배송에는 수령과 배송이 하나 이상 포함되어야 합니다.

예를 들어 t를 선택한 수령 대체 옵션에서 선택한 배송 대체 옵션으로 직접 이동하는 데 걸리는 가장 짧은 시간이라고 가정해 보겠습니다. 그런 다음 pickup_to_delivery_relative_detour_limit를 설정하면 다음이 적용됩니다.

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

동일한 배송에 상대적 한도와 절대적 한도가 모두 지정된 경우 가능한 각 수령/배송 쌍에 더 제한적인 한도가 사용됩니다. 2017년 10월 현재 우회는 이동 시간이 차량에 따라 달라지지 않는 경우에만 지원됩니다.

int64

해당 방문을 수행하는 차량의 부하가 달라집니다. 정수이므로 사용자는 정밀도 손실을 방지하기 위해 적절한 단위를 선택하는 것이 좋습니다. 0 이상이어야 합니다.

LatLng

이 VisitRequest을 실행할 때 차량이 도착하는 지리적 위치입니다. 배송 모델에 기간 거리 행렬이 있는 경우 arrival_location을 지정하면 안 됩니다.

Waypoint

이 VisitRequest을 실행할 때 차량이 도착하는 경유지입니다. 배송 모델에 기간 거리 행렬이 있는 경우 arrival_waypoint을 지정하면 안 됩니다.

LatLng

이 VisitRequest을 완료한 후 차량이 출발하는 지리적 위치입니다. arrival_location과 동일한 경우 생략할 수 있습니다. 배송 모델에 기간 거리 행렬이 있는 경우 departure_location을 지정하면 안 됩니다.

Waypoint

이 VisitRequest를 완료한 후 차량이 출발하는 경유지입니다. arrival_waypoint과 동일한 경우 생략할 수 있습니다. 배송 모델에 기간 거리 행렬이 있는 경우 departure_waypoint을 지정하면 안 됩니다.

string

방문 요청에 연결된 태그를 지정합니다. 빈 문자열 또는 중복 문자열은 허용되지 않습니다.

TimeWindow

방문 도착 시간을 제한하는 시간대입니다. 차량이 도착 시간대 외에 출발할 수 있습니다. 즉, 도착 시간 + 기간이 시간대 내에 있을 필요는 없습니다. 차량이 TimeWindow.start_time 전에 도착하면 대기 시간이 발생할 수 있습니다.

TimeWindow가 없으면 차량이 언제든지 이 방문을 수행할 수 있습니다.

시간 범위는 서로 겹치거나 인접해서는 안 되며 오름차순이어야 합니다.

cost_per_hour_after_soft_end_time 및 soft_end_time은 시간대가 하나인 경우에만 설정할 수 있습니다.

Duration

방문 시간, 즉 차량이 도착과 출발 사이에 소비한 시간입니다 (가능한 대기 시간에 추가됨, time_windows 참고).

double

차량 경로에서 이 방문 요청을 처리하는 데 드는 비용입니다. 이를 사용하면 배송의 대체 수령 또는 배송마다 다른 비용을 지불할 수 있습니다. 이 비용은 Shipment.penalty_cost와 동일한 단위여야 하며 음수가 아니어야 합니다.

map<string, Load>

이 방문 요청의 로드 수요입니다. 이는 전체 Shipment이 아닌 이 VisitRequest에만 적용된다는 점을 제외하고 Shipment.load_demands 필드와 같습니다. 여기에 나열된 요구사항은 Shipment.load_demands에 나열된 요구사항에 추가됩니다.

string

방문 유형을 지정합니다. 이는 차량이 이 방문을 완료하는 데 필요한 추가 시간을 할당하는 데 사용될 수 있습니다 (Vehicle.extra_visit_duration_for_visit_type 참고).

유형은 한 번만 표시될 수 있습니다.

string

이 VisitRequest의 라벨을 지정합니다. 이 라벨은 해당 ShipmentRoute.Visit의 응답에서 visit_label로 보고됩니다.

bool

이 위치의 운전 경로에서 U턴을 피해야 하는지 여부를 지정합니다. U턴 방지는 최선을 다해 수행되며 완전한 방지는 보장되지 않습니다. 실험용 기능이며 동작이 변경될 수 있습니다.

실험 단계: 자세한 내용은 https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request를 참고하세요.

Shipment

모델에서 실행해야 하는 배송 세트입니다.

Vehicle

방문에 사용할 수 있는 차량 집합입니다.

Objective

이 모델의 목표 집합으로, 비용으로 변환됩니다. 비어 있지 않은 경우 입력 모델은 비용이 없어야 합니다. 수정된 요청을 가져오려면 solving_mode = TRANSFORM_AND_RETURN_REQUEST를 사용하세요. 이 경우 요청이 해결되지 않습니다. 해당 문서를 참고하세요.

실험 단계: 자세한 내용은 https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request를 참고하세요.

Timestamp

모델의 전역 시작 및 종료 시간: 이 범위를 벗어나는 시간은 유효한 것으로 간주할 수 없습니다.

모델의 기간은 1년 미만이어야 합니다. 즉, global_end_time와 global_start_time이 서로 31536000초 이내여야 합니다.

cost_per_*hour 필드를 사용하는 경우 성능을 높이기 위해 이 기간을 더 작은 간격으로 설정하는 것이 좋습니다 (예: 하루를 모델링하는 경우 전역 시간 제한을 해당 날짜로 설정해야 함). 설정하지 않으면 1970년 1월 1일 00:00:00 UTC (즉, 초: 0, 나노초: 0)가 기본값으로 사용됩니다.

Timestamp

설정하지 않으면 1971년 1월 1일 00:00:00 UTC (즉, 초: 31536000, 나노: 0)가 기본값으로 사용됩니다.

double

전체 계획의 '전체 기간'은 모든 차량의 가장 빠른 유효 시작 시간과 가장 늦은 유효 종료 시간의 차이입니다. 사용자는 해당 수량에 시간당 비용을 할당하여 예를 들어 가장 빠른 작업 완료를 위해 최적화할 수 있습니다. 이 비용은 Shipment.penalty_cost과 동일한 단위여야 합니다.

DurationDistanceMatrix

모델에서 사용되는 시간 및 거리 행렬을 지정합니다. 이 필드가 비어 있으면 use_geodesic_distances 필드의 값에 따라 Google 지도 또는 측지선 거리가 대신 사용됩니다. 비어 있지 않은 경우 use_geodesic_distances은 true일 수 없으며 duration_distance_matrix_src_tags 또는 duration_distance_matrix_dst_tags도 비어 있을 수 없습니다.

사용 예:

• 위치는 locA와 locB 두 곳입니다.
• locA에서 경로를 시작하고 locA에서 경로를 종료하는 차량 1대
• locB에서 1건의 수거 방문 요청

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• 위치는 locA, locB, locC의 세 곳입니다.
• locA에서 경로를 시작하고 locB에서 경로를 종료하는 차량 1대가 'fast' 매트릭스를 사용합니다.
• locB에서 경로를 시작하여 locB에서 종료하는 차량 1대가 'slow' 매트릭스를 사용합니다.
• locB에서 경로를 시작하고 locB에서 경로를 종료하며 'fast' 매트릭스를 사용하는 차량 1대
• locC에서 1건의 수거 방문 요청

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

기간 및 거리 행렬의 소스를 정의하는 태그입니다. duration_distance_matrices(i).rows(j)는 태그가 duration_distance_matrix_src_tags(j)인 방문에서 행렬 i의 다른 방문까지의 기간과 거리를 정의합니다.

태그는 VisitRequest.tags 또는 Vehicle.start_tags에 해당합니다. 지정된 VisitRequest 또는 Vehicle는 이 필드의 태그 하나와 정확히 일치해야 합니다. Vehicle의 소스, 대상, 매트릭스 태그는 동일할 수 있습니다. 마찬가지로 VisitRequest의 소스 및 대상 태그도 동일할 수 있습니다. 모든 태그는 서로 달라야 하며 빈 문자열일 수 없습니다. 이 필드가 비어 있지 않으면 duration_distance_matrices이 비어 있지 않아야 합니다.

string

기간 및 거리 행렬의 목적지를 정의하는 태그입니다. duration_distance_matrices(i).rows(j).durations(k) (resp. duration_distance_matrices(i).rows(j).meters(k))는 태그가 duration_distance_matrix_src_tags(j)인 방문에서 태그가 duration_distance_matrix_dst_tags(k)인 방문까지의 이동 시간 (또는 거리)을 행렬 i에서 정의합니다.

태그는 VisitRequest.tags 또는 Vehicle.start_tags에 해당합니다. 지정된 VisitRequest 또는 Vehicle는 이 필드의 태그 하나와 정확히 일치해야 합니다. Vehicle의 소스, 대상, 매트릭스 태그는 동일할 수 있습니다. 마찬가지로 VisitRequest의 소스 및 대상 태그도 동일할 수 있습니다. 모든 태그는 서로 달라야 하며 빈 문자열일 수 없습니다. 이 필드가 비어 있지 않으면 duration_distance_matrices이 비어 있지 않아야 합니다.

TransitionAttributes

모델에 전환 속성이 추가되었습니다.

ShipmentTypeIncompatibility

호환되지 않는 shipment_type 세트입니다 (ShipmentTypeIncompatibility 참고).

ShipmentTypeRequirement

shipment_type 요구사항 세트입니다 (ShipmentTypeRequirement 참고).

PrecedenceRule

모델에서 시행해야 하는 우선순위 규칙 집합입니다.

중요: 우선순위 규칙을 사용하면 최적화할 수 있는 문제의 크기가 제한됩니다. 배송이 많이 포함된 우선순위 규칙을 사용하는 요청은 거부될 수 있습니다.

int32

활성 차량의 최대 수를 제한합니다. 차량이 하나 이상의 배송을 수행하는 경우 차량은 활성 상태입니다. 차량보다 운전자가 적고 차량의 차량이 이질적인 경우 경로 수를 제한하는 데 사용할 수 있습니다. 그러면 최적화에서 사용할 최적의 차량 하위 집합을 선택합니다. 엄격하게 양수여야 합니다.

Row

기간 및 거리 행렬의 행을 지정합니다. ShipmentModel.duration_distance_matrix_src_tags만큼의 요소가 있어야 합니다.

string

이 기간 및 거리 매트릭스가 적용되는 차량을 정의하는 태그입니다. 비어 있으면 모든 차량에 적용되며 매트릭스는 하나만 있을 수 있습니다.

각 차량 시작은 정확히 하나의 매트릭스와 일치해야 합니다. 즉, start_tags 필드 중 정확히 하나가 매트릭스의 vehicle_start_tag와 일치해야 합니다 (해당 매트릭스만 해당).

모든 행렬은 서로 다른 vehicle_start_tag을 가져야 합니다.

Duration

특정 행의 기간 값입니다. ShipmentModel.duration_distance_matrix_dst_tags만큼의 요소가 있어야 합니다.

double

특정 행의 거리 값입니다. 비용이나 제약 조건이 모델의 거리를 참조하지 않는 경우 비워 둘 수 있습니다. 그렇지 않으면 durations만큼의 요소가 있어야 합니다.

Type

목표의 유형입니다.

double

이 목표가 다른 목표에 비해 얼마나 중요해야 하는지입니다. 음수가 아닌 모든 숫자일 수 있으며 가중치의 합이 1일 필요는 없습니다. 가중치는 기본적으로 1.0입니다.

bool

'첫 번째' 이벤트가 배송인지 여부를 나타냅니다.

bool

'두 번째' 이벤트가 배송인지 여부를 나타냅니다.

Duration

'첫 번째' 이벤트와 '두 번째' 이벤트 간의 오프셋입니다. 음수일 수 있습니다.

int32

'첫 번째' 이벤트의 배송 색인입니다. 이 필드를 지정해야 합니다.

int32

'두 번째' 이벤트의 배송 색인입니다. 이 필드를 지정해야 합니다.

int32

경로를 실행하는 차량으로, 소스 ShipmentModel의 색인으로 식별됩니다.

string

이 경로를 실행하는 차량의 라벨입니다. 지정된 경우 ShipmentModel.vehicles(vehicle_index).label와 같습니다.

Timestamp

차량이 경로를 시작하는 시간입니다.

Timestamp

차량이 경로를 완료하는 시간입니다.

Visit

경로를 나타내는 방문의 순서가 지정된 시퀀스입니다. visits[i] 는 경로의 i번째 방문입니다. 이 필드가 비어 있으면 차량이 사용되지 않은 것으로 간주됩니다.

Transition

경로의 전환 순서가 지정된 목록입니다.

bool

OptimizeToursRequest.consider_road_traffic이 true로 설정된 경우 이 필드는 교통 상황 기반 이동 시간 추정치를 사용하여 경로 시간의 불일치가 예측됨을 나타냅니다. 방문 및 차량 시간 범위를 충족하면서도 첫 번째 방문 전, 마지막 방문 후 또는 방문 사이에 교통 상황에 따라 조정된 이동, 지연, 휴식을 완료할 시간이 부족할 수 있습니다. 예를 들면 다음과 같습니다.

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

트래픽으로 인해 이동 시간 추정치가 travel_duration(previous_visit, next_visit)로 증가하여 next_visit이 현재 시간대보다 늦게 도착할 수 있습니다. 또한 이동 시간 추정치 증가 및 방문 또는 휴식 시간 창 제한으로 인해 휴식이 방문과 겹칠 수 있습니다.

EncodedPolyline

경로의 인코딩된 다중선 표현입니다. 이 필드는 OptimizeToursRequest.populate_polylines이 true로 설정된 경우에만 채워집니다.

Break

이 경로를 수행하는 차량에 예정된 휴식 시간입니다. breaks 시퀀스는 시간 간격을 나타내며 각 간격은 해당 start_time에서 시작하여 duration초 동안 지속됩니다.

AggregatedMetrics

이 경로의 시간, 거리, 부하 측정항목입니다. AggregatedMetrics 필드는 맥락에 따라 모든 ShipmentRoute.transitions 또는 ShipmentRoute.visits에 대해 합산됩니다.

VehicleFullness

상한이 적용된 측정항목이 각 차량 한도에 얼마나 근접한지 계산하는 VehicleFullness 필드 필드는 상한이 설정된 측정항목 필드 (예: AggregatedMetrics.travel_distance_meters)와 관련 차량 한도 (예: Vehicle.route_distance_limit) 간의 비율입니다.

실험적: 이 필드의 동작 또는 존재는 향후 변경될 수 있습니다.

map<string, double>

비용 관련 요청 필드로 분류된 경로의 비용입니다. 키는 입력 OptimizeToursRequest와 관련된 프로토 경로입니다(예: 'model.shipments.pickups.cost'). 값은 해당 비용 필드에서 생성된 총비용으로, 전체 경로에 걸쳐 집계됩니다. 즉, costs["model.shipments.pickups.cost"] 는 경로의 모든 수령 비용의 합계입니다. 모델에 정의된 모든 비용은 여기에 자세히 보고됩니다. 단, 2022년 1월부터 집계된 방식으로만 보고되는 TransitionAttributes와 관련된 비용은 예외입니다.

double

경로의 총비용입니다. 비용 지도에 있는 모든 비용의 합계입니다.

Timestamp

휴식 시간의 시작 시간입니다.

Duration

휴식 시간입니다.

string

다중선의 인코딩된 포인트를 나타내는 문자열입니다.

Duration

이 전환 기간의 여행 기간입니다.

double

전환 중에 이동한 거리입니다.

bool

OptimizeToursRequest.consider_road_traffic를 통해 교통정보가 요청되었는데 Transition의 교통정보를 가져올 수 없는 경우 이 불리언이 true로 설정됩니다. 일시적일 수도 있고 (실시간 교통 서버의 드문 문제) 영구적일 수도 있습니다 (이 위치에 대한 데이터가 없음).

Duration

이 전환에 적용된 지연 시간의 합계입니다. 지연이 있는 경우 다음 이벤트 (방문 또는 차량 종료)가 시작되기 정확히 delay_duration초 전에 시작됩니다. TransitionAttributes.delay 페이지를 참고하세요.

Duration

이 전환 중에 발생하는 휴식 시간의 합계입니다(있는 경우). 각 광고 시점의 시작 시간과 지속 시간은 ShipmentRoute.breaks에 저장됩니다.

Duration

이 전환 중에 대기한 시간입니다. 대기 시간은 유휴 시간에 해당하며 휴식 시간은 포함되지 않습니다. 이 대기 시간은 연속되지 않는 여러 간격으로 나뉠 수 있습니다.

Duration

편의를 위해 제공되는 전환의 총 지속 시간입니다. 다음과 같습니다.

• 다음 방문 start_time (또는 마지막 전환인 경우 vehicle_end_time) - 이 전환의 start_time
• ShipmentRoute.has_traffic_infeasibilities이 false인 경우 다음도 적용됩니다. `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

이 전환의 시작 시간입니다.

EncodedPolyline

전환 중에 따른 경로의 인코딩된 다중선 표현입니다. 이 필드는 populate_transition_polylines이 true로 설정된 경우에만 채워집니다.

string

출력 전용입니다. 탐색 중에 경로를 재구성하고 경로가 생성될 때 원래 의도를 존중하기 위해 Navigation SDK에 전달할 수 있는 불투명 토큰입니다. 경로가 변경되는 경우에도 원래 의도를 존중합니다. 이 토큰을 불투명 BLOB으로 처리합니다. 서비스에서 정확히 동일한 경로를 반환하더라도 값이 변경될 수 있으므로 요청 간에 값을 비교하지 마세요. 이 필드는 populate_transition_polylines이 true로 설정된 경우에만 채워집니다.

map<string, VehicleLoad>

이 전환 중에 차량이 로드됩니다. 이 차량의 Vehicle.load_limits에 표시되거나 이 경로에서 실행된 일부 배송에 0이 아닌 Shipment.load_demands이 있는 각 유형에 대해

첫 번째 전환 중의 로드는 차량 경로의 시작 로드입니다. 그런 다음 각 방문 후 방문의 load_demands가 방문이 픽업인지 배송인지에 따라 다음 전환의 로드에 추가되거나 차감됩니다.

int64

지정된 유형의 차량에 실린 하중입니다. 부하 단위는 일반적으로 유형으로 표시됩니다. Transition.vehicle_loads를 참조하세요.

int32

소스 ShipmentModel의 shipments 필드 색인입니다.

bool

true인 경우 방문이 Shipment 수령에 해당합니다. 그렇지 않으면 배송에 해당합니다.

int32

Shipment의 픽업 또는 배송 필드에 있는 VisitRequest의 색인입니다 (is_pickup 참고).

Timestamp

방문이 시작된 시간입니다. 차량이 방문 위치에 이 시간보다 일찍 도착할 수 있습니다. 시간은 ShipmentModel와 일치합니다.

map<string, Load>

배송 및 방문 요청 load_demands의 합계인 총 방문 부하 수요입니다. 방문이 배송인 경우 값은 음수입니다. 수요는 Transition.loads와 동일한 유형으로 보고됩니다 (이 필드 참고).

Duration

방문 전 경로에서 방문한 배송 및 시간대로 인해 발생할 수 있는 대기 시간으로 인한 추가 우회 시간입니다. 방문이 배송인 경우 우회는 해당 수령 방문에서 계산되며 다음과 같습니다.

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

그렇지 않으면 차량 start_location에서 계산되며 다음과 같습니다.

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Shipment에 지정된 경우 해당 Shipment.label의 사본

string

VisitRequest에 지정된 경우 해당 VisitRequest.label의 사본

int32

방문 위치에 관한 정보를 나타내는 불투명 토큰입니다.

이 필드는 이 방문에 대해 VisitRequest.avoid_u_turns가 true로 설정된 경우 또는 요청 OptimizeToursRequest에서 ShipmentModel.avoid_u_turns가 true로 설정된 경우 결과 경로의 방문에 채워질 수 있습니다.

실험 단계: 자세한 내용은 https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request를 참고하세요.

string

호환되지 않는 유형 목록입니다. 나열된 항목 중 shipment_types이 서로 다른 두 배송은 '호환되지 않습니다'.

IncompatibilityMode

비호환성에 적용된 모드입니다.

string

dependent_shipment_types에 필요한 대체 배송 유형 목록입니다.

string

dependent_shipment_types 필드에 유형이 있는 모든 배송은 동일한 경로에서 required_shipment_type_alternatives 유형의 배송을 하나 이상 방문해야 합니다.

참고: shipment_type가 자체에 종속되는 요구사항 체인은 허용되지 않습니다.

RequirementMode

요구사항에 적용된 모드입니다.

int32

색인은 소스 ShipmentModel의 배송 색인에 해당합니다.

string

Shipment에 지정된 경우 해당 Shipment.label의 사본

Reason

배송이 건너뛴 이유를 설명하는 이유 목록입니다. 위의 Reason 댓글을 참고하세요. 배송이 건너뛴 이유를 알 수 없는 경우 이유가 설정되지 않습니다.

double

이는 건너뛴 배송의 심각도를 더 쉽게 확인할 수 있도록 여기에 포함된 Shipment.penalty_cost의 사본입니다.

실험적: 이 필드의 동작 또는 존재는 향후 변경될 수 있습니다.

double

아래 이유 중 하나로 인해 이 배송을 수행할 수 없는 차량의 예상 비율입니다. 참고: 이유에 차량이 포함된 경우에만 입력됩니다.

실험적: 이 필드의 동작 또는 존재는 향후 변경될 수 있습니다.

Code

코드의 주석을 참고하세요.

int32

식별된 여러 차량의 목록을 제공한다는 점을 제외하고 example_vehicle_index와 동일합니다. 이 목록은 일부 예시일 뿐 모든 내용을 포함하지는 않습니다. [fill_example_vehicle_indices_in_skipped_reasons][] 가 true인 경우에만 채워집니다.

실험적: 이 필드의 동작 또는 존재는 향후 변경될 수 있습니다.

string

이유 코드가 DEMAND_EXCEEDS_VEHICLE_CAPACITY인 경우 초과된 용량 유형을 문서화합니다.

int32

이유가 배송-차량 비호환성과 관련된 경우 이 필드에는 관련 차량의 색인이 제공됩니다.

Timestamp

강제 기간 시작 시간입니다. 지정하지 않으면 ShipmentModel.global_start_time으로 설정됩니다.

Timestamp

강제 기간 종료 시간입니다. 지정하지 않으면 ShipmentModel.global_end_time으로 설정됩니다.

Timestamp

기간의 소프트 시작 시간입니다.

Timestamp

기간의 소프트 종료 시간입니다.

double

이벤트가 soft_start_time 전에 발생한 경우 모델의 다른 비용에 추가되는 시간당 비용입니다. 다음과 같이 계산됩니다.

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

이 비용은 양수여야 하며 soft_start_time이 설정된 경우에만 필드를 설정할 수 있습니다.

double

이벤트가 soft_end_time 이후에 발생한 경우 모델의 다른 비용에 추가되는 시간당 비용으로, 다음과 같이 계산됩니다.

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

이 비용은 양수여야 하며, soft_end_time이 설정된 경우에만 필드를 설정할 수 있습니다.

string

이 속성이 적용되는 (src->dst) 전환 집합을 정의하는 태그입니다.

소스 방문 또는 차량 시작은 VisitRequest.tags 또는 Vehicle.start_tags에 src_tag가 포함되거나 excluded_src_tag가 포함되지 않는 경우에만 일치합니다 (이 두 필드 중 비어 있지 않은 필드에 따라 다름).

string

src_tag를 참조하세요. src_tag 및 excluded_src_tag 중 정확히 하나는 비어 있지 않아야 합니다.

string

VisitRequest.tags 또는 Vehicle.end_tags에 dst_tag가 포함되거나 excluded_dst_tag가 포함되지 않는 경우 (이 두 필드 중 비어 있지 않은 필드에 따라 다름) 대상 방문 또는 차량 종료가 일치합니다.

string

dst_tag를 참조하세요. dst_tag 및 excluded_dst_tag 중 정확히 하나는 비어 있지 않아야 합니다.

double

이 전환을 실행하는 비용을 지정합니다. 이 값은 모델의 다른 모든 비용과 동일한 단위이며 음수여서는 안 됩니다. 다른 모든 기존 비용에 추가로 적용됩니다.

double

이 전환을 실행하는 동안 이동한 거리에 적용되는 킬로미터당 비용을 지정합니다. 차량에 지정된 Vehicle.cost_per_kilometer에 최대 100%까지 추가됩니다.

DistanceLimit

이 전환을 실행하는 동안 이동한 거리에 대한 제한을 지정합니다.

2021년 6월 현재 소프트 한도만 지원됩니다.

Duration

이 전환을 실행할 때 발생하는 지연 시간을 지정합니다.

이 지연은 항상 소스 방문이 완료된 후이자 대상 방문이 시작되기 전에 발생합니다.

string

리소스의 URI입니다. 리소스가 아직 존재하지 않을 수 있습니다.

리소스의 콘텐츠는 JSON 또는 textproto로 인코딩됩니다. Google Cloud Storage 리소스만 지원됩니다. 리소스가 JSON으로 인코딩된 경우 리소스 이름에 .json이 접미사로 붙어야 합니다. 리소스가 textproto로 인코딩된 경우 리소스 이름에 .txtpb이(가) 접미사로 붙어야 합니다. 예를 들어 JSON 인코딩 파일의 Google Cloud Storage URI는 gs://bucket/path/input/object.json와 같습니다.

string

사용자 정의 차량 표시 이름입니다. 최대 길이는 63자(영문 기준)이며 UTF-8 문자를 사용할 수 있습니다.

TravelMode

차량에서 사용할 수 있는 도로와 속도에 영향을 미치는 이동 모드입니다. travel_duration_multiple을 참고하세요.

RouteModifiers

지정된 차량의 경로 계산 방식에 영향을 미치는 충족해야 하는 조건 집합입니다.

LatLng

배송물을 수령하기 전에 차량이 출발하는 지리적 위치입니다. 지정하지 않으면 차량이 첫 번째 픽업에서 시작됩니다. 배송 모델에 기간 및 거리 매트릭스가 있는 경우 start_location을 지정하면 안 됩니다.

Waypoint

배송물을 픽업하기 전에 차량이 출발하는 지리적 위치를 나타내는 경유지입니다. start_waypoint도 start_location도 지정하지 않으면 차량이 첫 번째 탑승 지점에서 시작됩니다. 배송 모델에 기간 및 거리 매트릭스가 있는 경우 start_waypoint을 지정하면 안 됩니다.

LatLng

마지막 VisitRequest를 완료한 후 차량이 종료되는 지리적 위치입니다. 지정하지 않으면 차량의 ShipmentRoute이 마지막 VisitRequest을 완료하는 즉시 종료됩니다. 배송 모델에 기간 및 거리 매트릭스가 있는 경우 end_location을 지정하면 안 됩니다.

Waypoint

마지막 VisitRequest를 완료한 후 차량이 종료되는 지리적 위치를 나타내는 경유지입니다. end_waypoint도 end_location도 지정되지 않은 경우 차량의 ShipmentRoute는 마지막 VisitRequest를 완료하면 즉시 종료됩니다. 배송 모델에 기간 및 거리 매트릭스가 있는 경우 end_waypoint을 지정하면 안 됩니다.

string

차량 경로의 시작에 연결된 태그를 지정합니다.

빈 문자열 또는 중복 문자열은 허용되지 않습니다.

string

차량 경로의 끝에 연결된 태그를 지정합니다.

빈 문자열 또는 중복 문자열은 허용되지 않습니다.

TimeWindow

차량이 시작 위치에서 출발할 수 있는 시간대입니다. 전역 시간 제한 내에 있어야 합니다 (ShipmentModel.global_* 필드 참고). 지정하지 않으면 전역 시간 제한 외에는 제한이 없습니다.

동일한 반복 필드에 속하는 시간 창은 서로 분리되어야 합니다. 즉, 시간 창이 다른 시간 창과 겹치거나 인접할 수 없으며 시간 순서대로 표시되어야 합니다.

cost_per_hour_after_soft_end_time 및 soft_end_time은 시간대가 하나인 경우에만 설정할 수 있습니다.

TimeWindow

차량이 최종 위치에 도착할 수 있는 시간대입니다. 전역 시간 제한 내에 있어야 합니다 (ShipmentModel.global_* 필드 참고). 지정하지 않으면 전역 시간 제한 외에는 제한이 없습니다.

동일한 반복 필드에 속하는 시간 창은 서로 분리되어야 합니다. 즉, 시간 창이 다른 시간 창과 겹치거나 인접할 수 없으며 시간 순서대로 표시되어야 합니다.

cost_per_hour_after_soft_end_time 및 soft_end_time은 시간대가 하나인 경우에만 설정할 수 있습니다.

UnloadingPolicy

차량에 적용된 하차 정책

map<string, LoadLimit>

차량의 용량 (예: 중량, 부피, 팔레트 수) 맵의 키는 Shipment.load_demands 필드의 키와 일치하는 로드 유형의 식별자입니다. 이 맵에 특정 키가 없으면 해당 용량은 무제한으로 간주됩니다.

double

차량 비용: 모든 비용이 합산되어야 하며 Shipment.penalty_cost와 동일한 단위여야 합니다.

차량 경로의 시간당 비용입니다. 이 비용은 경로에 소요된 총 시간에 적용되며 이동 시간, 대기 시간, 방문 시간이 포함됩니다. cost_per_traveled_hour만 사용하는 대신 cost_per_hour를 사용하면 지연 시간이 추가될 수 있습니다.

double

차량 경로의 이동 시간당 비용입니다. 이 비용은 경로에서 소요된 이동 시간 (즉, ShipmentRoute.transitions에 보고됨)에만 적용되며 대기 시간과 방문 시간은 제외됩니다.

double

차량 경로의 킬로미터당 비용입니다. 이 비용은 ShipmentRoute.transitions에 보고된 거리에 적용되며 단일 VisitRequest의 arrival_location에서 departure_location까지 암시적으로 이동한 거리에는 적용되지 않습니다.

double

이 차량이 배송을 처리하는 데 사용되는 경우 적용되는 고정 비용입니다.

bool

이 필드는 경로가 배송을 처리하지 않는 차량에만 적용됩니다. 이 경우 차량을 사용한 것으로 간주해야 하는지 여부를 나타냅니다.

true인 경우 차량이 배송을 처리하지 않더라도 시작 위치에서 종료 위치로 이동하며 시작 위치에서 종료 위치로 이동하는 데 걸리는 시간과 거리 비용이 고려됩니다.

그렇지 않으면 시작 위치에서 종료 위치로 이동하지 않으며 이 차량에 대해 break_rule 또는 지연 (TransitionAttributes에서)이 예약되지 않습니다. 이 경우 차량의 ShipmentRoute에는 차량 색인과 라벨을 제외한 정보가 포함되지 않습니다.

DurationLimit

차량 경로의 총 지속 시간에 적용되는 제한입니다. 특정 OptimizeToursResponse에서 차량의 경로 지속 시간은 vehicle_end_time와 vehicle_start_time의 차이입니다.

DurationLimit

차량 경로의 이동 시간에 적용되는 제한입니다. 특정 OptimizeToursResponse에서 경로 이동 시간은 모든 transitions.travel_duration의 합계입니다.

DistanceLimit

차량 경로의 총 거리에 적용되는 제한입니다. 특정 OptimizeToursResponse에서 경로 거리는 모든 transitions.travel_distance_meters의 합계입니다.

map<string, Duration>

visit_types 문자열에서 기간으로의 지도를 지정합니다. 지정된 visit_types로 방문할 때 VisitRequest.duration 외에 소요되는 시간입니다. cost_per_hour가 지정된 경우 이 추가 방문 기간으로 인해 비용이 추가됩니다. 키 (예: visit_types)는 빈 문자열일 수 없습니다.

방문 요청에 여러 유형이 있는 경우 지도에 각 유형의 기간이 추가됩니다.

BreakRule

이 차량에 적용할 휴식 일정을 설명합니다. 비어 있으면 이 차량에 휴식이 예약되지 않습니다.

string

이 차량의 라벨을 지정합니다. 이 라벨은 응답에서 해당 ShipmentRoute의 vehicle_label로 보고됩니다.

bool

true인 경우 used_if_route_is_empty은 false여야 하며 이 차량은 사용되지 않은 상태로 유지됩니다.

injected_first_solution_routes에서 무시된 차량으로 배송이 수행되면 첫 번째 솔루션에서는 건너뛰지만 응답에서는 자유롭게 수행할 수 있습니다.

injected_solution_constraint에서 무시된 차량에 의해 배송이 수행되고 관련 수령/배송이 차량에 남아 있도록 제한되는 경우 (즉, RELAX_ALL_AFTER_THRESHOLD 수준으로 완화되지 않음) 응답에서 건너뜁니다. 배송에 비어 있지 않은 allowed_vehicle_indices 필드가 있고 허용된 모든 차량이 무시되면 응답에서 건너뜁니다.

double

이 차량의 이동 시간을 늘리거나 줄이는 데 사용할 수 있는 곱셈 계수를 지정합니다. 예를 들어 이 값을 2.0으로 설정하면 이 차량이 더 느리고 이동 시간이 표준 차량의 두 배가 됩니다. 이 배수는 방문 시간에 영향을 주지 않습니다. cost_per_hour 또는 cost_per_traveled_hour가 지정된 경우 비용에 영향을 미칩니다. 범위는 [0.001, 1000.0]이어야 합니다. 설정하지 않으면 차량이 표준이며 이 배수는 1.0으로 간주됩니다.

경고: 이동 시간은 이 배수가 적용된 후 숫자 연산을 실행하기 전에 가장 가까운 초로 반올림되므로 작은 배수를 사용하면 정밀도가 떨어질 수 있습니다.

아래의 extra_visit_duration_for_visit_type도 참고하세요.

Duration

최대 기간을 max_duration으로 제한하는 엄격한 제한입니다.

Duration

최대 기간 한도를 적용하지 않지만 위반 시 경로에 비용이 발생하는 가벼운 한도입니다. 이 비용은 모델에 정의된 다른 비용과 동일한 단위로 합산됩니다.

정의된 경우 soft_max_duration는 음수가 아니어야 합니다. max_duration도 정의된 경우 soft_max_duration은 max_duration보다 작아야 합니다.

Duration

최대 기간 한도를 적용하지 않지만 위반 시 기간에 따라 2차 함수로 비용이 발생하는 가벼운 한도입니다. 이 비용은 모델에 정의된 다른 비용과 동일한 단위로 합산됩니다.

정의된 경우 quadratic_soft_max_duration는 음수가 아니어야 합니다. max_duration도 정의된 경우 quadratic_soft_max_duration는 max_duration보다 작아야 하며 차이는 하루를 넘지 않아야 합니다.

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

soft_max_duration 기준을 위반할 경우 발생하는 시간당 비용입니다. 기간이 기준 미만이면 추가 비용은 0이며, 그렇지 않으면 비용은 다음과 같이 기간에 따라 달라집니다.

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

비용은 음수가 아니어야 합니다.

double

quadratic_soft_max_duration 기준을 위반한 경우 발생하는 제곱 시간당 비용입니다.

기간이 기준 미만이면 추가 비용은 0이며, 그렇지 않으면 비용은 다음과 같이 기간에 따라 달라집니다.

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

비용은 음수가 아니어야 합니다.

int64

로드의 소프트 한도입니다. cost_per_unit_above_soft_max를 참조하세요.

double

이 차량의 경로에서 적재량이 soft_max_load을 초과하는 경우 다음 비용 페널티가 적용됩니다 (차량당 한 번만 적용). (적재량 - soft_max_load) * cost_per_unit_above_soft_max 모든 비용은 합산되며 Shipment.penalty_cost와 동일한 단위여야 합니다. 소프트 한도는 모델 전체에서 픽업에만 적용되거나 배송에만 적용되는 유형에만 정의할 수 있습니다.

Interval

경로 시작 시 차량의 허용되는 로드 간격입니다.

Interval

경로 끝에서 허용되는 차량의 적재 간격입니다.

int64

허용되는 최대 부하량입니다.

LoadCost

이 차량으로 1km당 1단위의 하중을 이동하는 데 드는 비용입니다. 이는 연료 소비의 프록시로 사용할 수 있습니다. 하중이 무게 (뉴턴)인 경우 하중*킬로미터는 에너지의 차원을 갖습니다.

실험 단계: 자세한 내용은 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request를 참고하세요.

LoadCost

이 차량이 1시간 동안 단위 하중으로 이동하는 비용입니다.

실험 단계: 자세한 내용은 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request를 참고하세요.

int64

허용되는 최소 부하입니다. 0 이상이어야 합니다. 두 값이 모두 지정된 경우 min은 max보다 작거나 같아야 합니다.

int64

허용 가능한 최대 부하입니다. 0 이상이어야 합니다. 지정하지 않으면 이 메시지에 의해 최대 부하가 제한되지 않습니다. 두 값이 모두 지정된 경우 min은 max보다 작거나 같아야 합니다.

int64

부하 단위 이동 비용이 cost_per_unit_below_threshold에서 cost_per_unit_above_threshold로 변경되는 부하량입니다. 0 이상이어야 합니다.

double

0과 임계값 사이의 각 단위에 대한 부하 단위 이동 비용입니다. 유한한 값이어야 하며 0 이상이어야 합니다.

double

기준점을 초과하는 각 단위의 부하를 이동하는 비용입니다. 특별한 경우 임계값이 0이면 단위당 고정 비용입니다. 유한한 값이어야 하며 0 이상이어야 합니다.

double

이 메시지의 다른 모든 필드의 최댓값입니다.

double

AggregatedMetrics.travel_distance_meters와 Vehicle.route_distance_limit의 비율입니다. Vehicle.route_distance_limit이 설정되지 않으면 이 필드가 설정되지 않습니다.

double

[AggregatedMetrics.travel_duration_seconds][] 와 Vehicle.travel_duration_limit의 비율입니다. Vehicle.travel_duration_limit이 설정되지 않으면 이 필드가 설정되지 않습니다.

double

[AggregatedMetrics.total_duration_seconds][] 와 Vehicle.route_duration_limit의 비율입니다. Vehicle.route_duration_limit이 설정되지 않으면 이 필드가 설정되지 않습니다.

double

모든 유형의 [AggregatedMetrics.max_load][] 와 각 Vehicle.load_limits 간의 최대 비율입니다. 모든 Vehicle.load_limits 필드가 설정되지 않은 경우 이 필드는 설정되지 않습니다.

double

특정 차량의 비율 (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time)입니다. 분모가 없으면 (ShipmentModel.global_end_time - ShipmentModel.global_start_time)이 대신 사용됩니다.

bool

선택사항입니다. 이 경유지의 위치가 차량이 도로의 특정 측면에 정차하도록 선호하는 것을 나타냅니다. 이 값을 설정하면 차량이 도로 중앙에서 위치 쪽으로 치우친 도로변에 정차할 수 있도록 경로가 위치를 통과합니다. '도보' 이동 모드에는 이 옵션을 사용할 수 없습니다.

bool

경유지가 차량이 정차하여 승차 또는 하차할 수 있는 곳임을 나타냅니다. 이 옵션은 'DRIVING' 이동 모드에서만 작동하며 'location_type'이 'location'인 경우에만 작동합니다.

실험적: 이 필드의 동작 또는 존재는 향후 변경될 수 있습니다.

Location

선택적 방향을 포함한 지리 좌표를 사용하여 지정된 지점입니다.

string

경유지와 연결된 관심 장소 ID입니다.

장소 ID를 사용하여 VisitRequest의 도착 또는 출발 위치를 지정할 때는 해당 장소로의 탐색을 위한 LatLng 위치를 결정할 수 있을 만큼 구체적인 장소 ID를 사용하세요. 예를 들어 건물을 나타내는 장소 ID는 적합하지만 도로를 나타내는 장소 ID는 권장되지 않습니다.