부하 비용으로 요청

방문 간에 차량이 운반하는 하중을 최적화 도구에서 고려하도록 하려면 하중 비용을 포함하여 요청하세요. 발생한 비용은 운반된 ShipmentRoute.VehicleLoad의 양과 전환 거리 또는 기간 (각각 cost_per_kilometer 또는 cost_per_traveled_hour 사용)에 따라 달라집니다.

부하 비용이 포함된 최소한의 요청 예시

다음은 로드 비용이 포함된 요청의 일부 예입니다. 이 예에서 단일 차량은 총 weightKg 하중을 1, 000kg까지만 운반할 수 있으며, 운반된 weightKg 하중이 500kg을 초과하면 킬로미터당 1 비용 단위가 발생합니다.

  {
    "model": {
      "vehicles": [{
        "loadLimits": {
          "weightKg": {
            "maxLoad": "1000",
            "costPerKilometer": {
              "loadThreshold": "500",
              "costPerUnitAboveThreshold": 1
            }
          }
        }
      }]
    }
  }
  

이 예의 로드 비용 계산은 다음과 같습니다.

cost = max(carried load - load threshold, 0) * distance * cost per unit above threshold

따라서 차량이 10km에 걸쳐 weightKg 600을 운반하는 경우 계산은 다음과 같습니다.

(600 - 500) * 10 * 1 = 1000 cost units

적재 비용은 무거운 하중을 운반할 때 차량 에너지 사용량 증가 또는 과도한 차량 적재로 인해 발생하는 차량 마모와 같은 다양한 개념을 모델링하는 데 사용할 수 있습니다.

로드 비용이 포함된 또 다른 요청 예시

다음은 기준점 위와 아래 모두에서 이동 시간당 비용을 부과하는 로드 비용의 또 다른 예입니다.

  {
    "model": {
      "vehicles": [{
        "loadLimits": {
          "weightLbs": {
            "maxLoad": "1000",
            "costPerTraveledHour": {
              "loadThreshold": "900",
              "costPerUnitAboveThreshold": 10,
              "costPerUnitBelowThreshold": 1
            },
          },
        }
      }]
    }
  }
  

이 예의 로드 비용 계산은 다음과 같습니다.

cost = max(carried load - load threshold, 0) * time * cost per unit above threshold
  + min(carried load, load threshold) * time * cost per unit below threshold

따라서 차량이 5시간 동안 weightLbs 부하 950을 운반하는 경우 계산은 다음과 같습니다.

max(950 - 900, 0) * 5 * 10 + min(950, 900) * 5 * 1 = 7000

이 예시에서 weightLbs 로드 비용의 load_threshold은 max_load에 가깝습니다. cost_per_unit_above_threshold는 차량이 특히 무거운 짐을 싣고 이동할 때 이동 시간당 높은 비용을 적용하여 차량의 마모를 늘리거나 연료를 과도하게 소비할 수 있는 경로에 불이익을 줍니다. cost_per_unit_below_threshold는 차량이 운반하는 단위 중량당 비용을 기준점까지 추가하여 차량이 더 많은 하중을 운반할 때 연료 소비량이 증가함을 나타냅니다.

자주 묻는 질문(FAQ)

다음은 로드 비용에 대해 자주 묻는 질문입니다.

로드 비용에 대한 자세한 설명은 참조 문서(REST, gRPC)를 참고하세요.

예: OptimizeTours 요청하기

OptimizeTours 요청은 REST 또는 gRPC를 사용하여 할 수도 있습니다.

요청하기 전에 다음 매개변수를 환경에 적합한 값으로 바꿉니다.

• OAuth 사용에 설명된 대로 애플리케이션 기본 사용자 인증 정보가 구성되어 있는지 확인합니다.

• PROJECT_NUMBER_OR_ID를 클라우드 프로젝트 번호 또는 ID로 설정합니다.

  다음 명령어는 Route Optimization API에 OptimizeTours 요청을 전송하고 동기식으로 응답을 수신합니다.

  curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeTours' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  --data @- << EOM
  {
    "model": {
      "shipments": [
        {
          "deliveries": [
            {
              "arrivalLocation": {
                "latitude": 37.789456,
                "longitude": -122.390192
              },
              "duration": "250s"
            }
          ],
          "penaltyCost": 100.0,
          "loadDemands": {
            "weightKg": {
              "amount": 50
            }
          }
        },
        {
          "deliveries": [
            {
              "arrivalLocation": {
                "latitude": 37.789116,
                "longitude": -122.395080
              },
              "duration": "250s"
            }
          ],
          "penaltyCost": 30.0,
          "loadDemands": {
            "weightKg": {
              "amount": 10
            }
          }
        },
        {
          "deliveries": [
            {
              "arrivalLocation": {
                "latitude": 37.795242,
                "longitude": -122.399347
              },
              "duration": "250s"
            }
          ],
          "penaltyCost": 50.0,
          "loadDemands": {
            "weightKg": {
              "amount": 80
            }
          }
        }
      ],
      "vehicles": [
        {
          "endLocation": {
            "latitude": 37.794465,
            "longitude": -122.394839
          },
          "startLocation": {
            "latitude": 37.794465,
            "longitude": -122.394839
          },
          "costPerHour": 40.0,
          "costPerKilometer": 10.0,
          "loadLimits": {
            "weightKg": {
              "maxLoad": "100",
              "costPerKilometer": {
                "loadThreshold": "15",
                "costPerUnitAboveThreshold": 1
              }
            }
          }
        }
      ]
    }
  }
  EOM

요청이 완료되면 응답 메시지가 전송됩니다.