hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "advisory": {
          "description": "Google's travelAdvisory object for the route (tolls, speed reading intervals, fuel) exactly as returned, {} when it has nothing to say; null when absent.",
          "properties": {},
          "required": [],
          "type": [
            "object",
            "null"
          ]
        },
        "as_of": {
          "description": "The departure time the answer was computed for: `departure_time`, else `checked_at`.",
          "examples": [
            "2026-09-27T16:30:00Z"
          ],
          "type": "string"
        },
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "delay_seconds": {
          "description": "duration_seconds minus static_duration_seconds (negative when traffic is lighter than typical); null when either is unknown.",
          "examples": [
            -129
          ],
          "type": [
            "integer",
            "null"
          ]
        },
        "departure_time": {
          "description": "Departure time sent to Google (RFC 3339, UTC); null when the trip starts now.",
          "examples": [
            "2026-09-27T16:30:00Z"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "description": "Route description as Google names it (main roads); null when not given.",
          "examples": [
            "I-80 E and I-580 E"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "destination": {
          "description": "Destination as given.",
          "examples": [
            "Oakland City Hall, Oakland, CA"
          ],
          "type": "string"
        },
        "distance_meters": {
          "description": "Route length in metres.",
          "examples": [
            17011
          ],
          "type": "integer"
        },
        "distance_text": {
          "description": "Google's localized distance (metric).",
          "examples": [
            "17.0 km"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "duration_seconds": {
          "description": "Travel time in seconds, with traffic when `traffic` is aware or optimal.",
          "examples": [
            1152
          ],
          "type": "integer"
        },
        "duration_text": {
          "description": "Google's localized travel time.",
          "examples": [
            "19 mins"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "origin": {
          "description": "Origin as given.",
          "examples": [
            "Ferry Building, San Francisco, CA"
          ],
          "type": "string"
        },
        "source": {
          "const": "google-routes",
          "description": "Data source: Google Routes API computeRoutes.",
          "type": "string"
        },
        "static_duration_seconds": {
          "description": "Travel time in seconds without traffic; null when Google does not state it.",
          "examples": [
            1281
          ],
          "type": [
            "integer",
            "null"
          ]
        },
        "static_duration_text": {
          "description": "Google's localized travel time without traffic.",
          "examples": [
            "21 mins"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "traffic": {
          "description": "Traffic handling used: aware (live traffic), optimal (live traffic, best route quality), none (no traffic; always none for WALK, BICYCLE and TRANSIT).",
          "enum": [
            "aware",
            "optimal",
            "none"
          ],
          "examples": [
            "aware"
          ],
          "type": "string"
        },
        "travel_mode": {
          "description": "Travel mode used.",
          "enum": [
            "DRIVE",
            "TWO_WHEELER",
            "WALK",
            "BICYCLE",
            "TRANSIT"
          ],
          "examples": [
            "DRIVE"
          ],
          "type": "string"
        },
        "warnings": {
          "description": "Google's warnings for the route, in the order given; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A warning Google attaches to the route.",
            "examples": [
              "This route has tolls."
            ],
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "origin",
        "destination",
        "travel_mode",
        "traffic",
        "departure_time",
        "distance_meters",
        "duration_seconds",
        "static_duration_seconds",
        "delay_seconds",
        "duration_text",
        "static_duration_text",
        "distance_text",
        "description",
        "warnings",
        "advisory",
        "source",
        "as_of",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "traffic.route response",
  "type": "object"
}