Zum Inhalt
HALOWERK

Laufwerk

tours / quiet hours readiness

Declared no-service time periods for residential delivery appointments. Scheduled service interval must not overlap any caller-declared quiet-hours interval. No local-law or driving restriction inferred. Uses the paid-qualified existing VRP planner unchanged, then checks this business rule against the actual proposed route. A rule violation yields dispatch_ready=false, never an assertion that the extra constraint was optimized. Inputs are caller declared, not independently.

POST https://lauf.halowerk.com/v1/tours/quiet-hours-readiness

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
durations_sarrayJa
matrix_sourcestringJa
vehiclesarrayJa
jobsarrayJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "durations_s",
    "matrix_source",
    "vehicles",
    "jobs"
  ],
  "additionalProperties": false,
  "properties": {
    "durations_s": {
      "type": "array",
      "minItems": 2,
      "maxItems": 21,
      "items": {
        "type": "array",
        "minItems": 2,
        "maxItems": 21,
        "items": {
          "anyOf": [
            {
              "type": "number",
              "minimum": 0,
              "maximum": 604800
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "matrix_source": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "vehicles": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "items": {
        "type": "object",
        "required": [
          "id",
          "capacity",
          "shift"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "capacity": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100000
          },
          "shift": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 604800
            }
          }
        }
      }
    },
    "jobs": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "object",
        "required": [
          "id",
          "point",
          "demand",
          "service_s",
          "window",
          "quiet_hours"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "point": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "demand": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000
          },
          "service_s": {
            "type": "number",
            "minimum": 0,
            "maximum": 604800
          },
          "window": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 604800
            }
          },
          "quiet_hours": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "items": {
              "type": "array",
              "minItems": 2,
              "maxItems": 2,
              "items": {
                "type": "number",
                "minimum": 0,
                "maximum": 604800
              }
            }
          }
        }
      }
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "durations_s": [
    [
      0,
      300,
      480,
      360
    ],
    [
      300,
      0,
      240,
      180
    ],
    [
      480,
      240,
      0,
      300
    ],
    [
      360,
      180,
      300,
      0
    ]
  ],
  "matrix_source": "Illustrative declared delivery times, seconds; not a live road measurement",
  "vehicles": [
    {
      "id": "van-1",
      "capacity": 3,
      "shift": [
        0,
        7200
      ]
    },
    {
      "id": "van-2",
      "capacity": 2,
      "shift": [
        0,
        7200
      ]
    }
  ],
  "jobs": [
    {
      "id": "stop-A",
      "point": 1,
      "demand": 2,
      "service_s": 120,
      "window": [
        0,
        1800
      ],
      "quiet_hours": [
        [
          20000,
          20100
        ]
      ]
    },
    {
      "id": "stop-B",
      "point": 2,
      "demand": 2,
      "service_s": 180,
      "window": [
        600,
        3000
      ],
      "quiet_hours": [
        [
          20000,
          20100
        ]
      ]
    },
    {
      "id": "stop-C",
      "point": 3,
      "demand": 1,
      "service_s": 60,
      "window": [
        0,
        3600
      ],
      "quiet_hours": [
        [
          20000,
          20100
        ]
      ]
    }
  ]
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →