วัตถุประสงค์

วัตถุประสงค์คือพารามิเตอร์ที่กำหนดเป้าหมายการเพิ่มประสิทธิภาพทั่วไปไว้ล่วงหน้า เช่น ระยะทางหรือระยะเวลาเดินทางที่สั้นที่สุด การนำส่งตรงเวลา การกระจายงานระหว่างคนขับ การดำเนินการนี้มีไว้เพื่อให้นักพัฒนาแอปเริ่มต้นใช้งาน Route Optimization API ได้ง่ายขึ้นก่อนที่จะเรียนรู้ความซับซ้อนและการปรับแต่งพารามิเตอร์ต้นทุนอย่างเต็มรูปแบบ

เมื่อตั้งค่าแล้ว ShipmentModel.objectives จะเขียนทับรูปแบบต้นทุนโดยสมบูรณ์ ดังนั้นจึงไม่เข้ากันได้กับต้นทุนที่มีอยู่ก่อนหน้านี้ Objective แต่ละรายการจะเชื่อมโยงกับค่าที่กำหนดไว้ล่วงหน้าสำหรับยานพาหนะ การจัดส่ง หรือแอตทริบิวต์การเปลี่ยน

เมื่อระบุโหมดการแก้ปัญหา TRANSFORM_AND_RETURN_REQUEST ระบบจะไม่แก้ปัญหา แต่จะใช้เพื่อตรวจสอบและป้อนต้นทุนที่สอดคล้องกับวัตถุประสงค์ที่ระบุเท่านั้น ระบบจะแสดงคำขอที่แก้ไขแล้วเป็น OptimizeToursResponse.processed_request โหมดการแก้ปัญหาอื่นๆ ทั้งหมดจะแสดงคำขอที่แก้ไขแล้ว

โหมดการแก้ปัญหา TRANSFORM_AND_RETURN_REQUEST ใช้ได้กับคำขอ OptimizeTours เท่านั้น และไม่พร้อมใช้งานสำหรับคำขอ Route Optimization API อื่นๆ

ตัวอย่าง: ส่งคำขอ ShipmentModel.objectives

ก่อนส่งคำขอ โปรดทำตามขั้นตอนต่อไปนี้

  • ตรวจสอบว่าคุณได้กําหนดค่าข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันตามที่อธิบายไว้ในส่วนใช้ OAuth

  • ตั้งค่า PROJECT_NUMBER_OR_ID เป็นหมายเลขหรือรหัสโปรเจ็กต์ในระบบคลาวด์

    คำสั่งต่อไปนี้จะส่ง OptimizeToursRequest ไปยัง Route Optimization API ซึ่งจะแสดงผล OptimizeToursResponse

    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": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.42506261000996,
              "longitude": -122.09535511930135
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.42421503206021,
              "longitude": -122.09526063135228
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "DRIVING",
      }
    ],
    "objectives": [
      {
        "type": "MIN_TRAVEL_TIME"
      }
    ],
  }
}
EOM

ตัวอย่าง: ส่งคําขอ TRANSFORM_AND_RETURN_REQUEST

ก่อนส่งคำขอ โปรดทำตามขั้นตอนต่อไปนี้

  • ตรวจสอบว่าคุณได้กําหนดค่าข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันตามที่อธิบายไว้ในใช้ OAuth

  • ตั้งค่า PROJECT_NUMBER_OR_ID เป็นหมายเลขหรือรหัสโปรเจ็กต์ในระบบคลาวด์

    คำสั่งต่อไปนี้จะส่ง OptimizeToursRequest ไปยัง Route Optimization API ซึ่งจะแสดงผล OptimizeToursResponse ที่มีการตั้งค่าช่อง ProcessedRequest

    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": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.42506261000996,
              "longitude": -122.09535511930135
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.42421503206021,
              "longitude": -122.09526063135228
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "DRIVING",
      }
    ],
    "objectives": [
      {
        "type": "MIN_TRAVEL_TIME"
      }
    ]
  },
  "solvingMode": "TRANSFORM_AND_RETURN_REQUEST"
}
EOM
     คำสั่งก่อนหน้าจะแสดงคำตอบที่คล้ายกับข้อความต่อไปนี้ 
    {
  "processedRequest": {
    "model": {
      "shipments": [
        {
          "pickups": [
            {
              "arrivalLocation": {
                "latitude": 37.425062610009959,
                "longitude": -122.09535511930135
              }
            }
          ],
          "deliveries": [
            {
              "arrivalLocation": {
                "latitude": 37.424215032060211,
                "longitude": -122.09526063135228
              }
            }
          ]
        }
      ],
      "vehicles": [
        {
          "travelMode": "DRIVING",
          "costPerHour": 30,
          "costPerTraveledHour": 330,
          "costPerKilometer": 0.2
        }
      ],
      "objectives": [
        {
          "type": "MIN_TRAVEL_TIME"
        }
      ]
    },
    "solvingMode": "TRANSFORM_AND_RETURN_REQUEST"
  }
}