Ziele

Zielvorhaben sind Parameter, die allgemeine Optimierungsziele wie die kürzeste Reisestrecke oder ‑dauer, pünktliche Lieferungen oder die Verteilung der Lasten zwischen Fahrern vordefinieren. Sie sollen Entwicklern den Einstieg in die Route Optimization API erleichtern, bevor sie sich mit den Feinheiten und der vollständigen Anpassung von Kostenparametern vertraut machen. Unter "cost model " erfahren Sie, wie Sie eine Vielzahl von Zielvorhaben vollständig anpassen können.

Wenn sie festgelegt sind, überschreiben die ShipmentModel.objectives das Kostenmodell vollständig. Daher sind sie nicht mit bereits vorhandenen Kosten kompatibel. Jedes Objective wird einer Reihe vordefinierter Kosten für Fahrzeuge, Sendungen oder Übergangsattribute zugeordnet.

Wenn Sie den TRANSFORM_AND_RETURN_REQUEST Lösungsmodus angeben, wird die Anfrage nicht gelöst, sondern nur validiert und mit Kosten gefüllt, die den angegebenen Zielvorhaben entsprechen. Die geänderte Anfrage wird als OptimizeToursResponse.processed_request zurückgegeben. Bei allen anderen Lösungsmodi wird die gelöste Anfrage zurückgegeben.

Der Lösungsmodus TRANSFORM_AND_RETURN_REQUEST ist nur für OptimizeTours-Anfragen gültig und nicht für andere Route Optimization API-Anfragen verfügbar.

Beispiel: ShipmentModel.objectives-Anfrage stellen

Führen Sie vor dem Stellen einer Anfrage die folgenden Schritte aus:

• Stellen Sie sicher, dass Sie die Standardanmeldedaten für Anwendungen konfiguriert haben, wie unter OAuth verwenden beschrieben.

• Legen Sie PROJECT_NUMBER_OR_ID auf Ihre Cloud Projektnummer oder ‑ID fest.

  Mit dem folgenden Befehl wird eine OptimizeToursRequest an die Route Optimization API gesendet, die eine OptimizeToursResponse zurückgibt.

  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

Beispiel: TRANSFORM_AND_RETURN_REQUEST-Anfrage stellen

Führen Sie vor dem Stellen einer Anfrage die folgenden Schritte aus:

• Stellen Sie sicher, dass Sie die Standardanmeldedaten für Anwendungen konfiguriert haben, wie unter OAuth verwenden beschrieben.

• Legen Sie PROJECT_NUMBER_OR_ID auf Ihre Cloud Projektnummer oder ‑ID fest.

  Mit dem folgenden Befehl wird eine OptimizeToursRequest an die Route Optimization API gesendet, die eine OptimizeToursResponse mit dem ProcessedRequest festgelegten Feld zurückgibt.

  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

  Der vorherige Befehl erzeugt eine ähnliche Antwort wie die folgende.

  {
    "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"
    }
  }