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": {
        "attribution": {
          "description": "Credits to show with the data.",
          "items": {
            "description": "A credit.",
            "properties": {
              "text": {
                "description": "Credit.",
                "examples": [
                  "Places data from Overture Maps Foundation ..."
                ],
                "type": "string"
              },
              "url": {
                "description": "Link.",
                "examples": [
                  "https://docs.overturemaps.org/attribution/"
                ],
                "type": "string"
              }
            },
            "required": [
              "text",
              "url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "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"
        },
        "near": {
          "description": "The search center.",
          "properties": {
            "lat": {
              "description": "Latitude.",
              "examples": [
                37.7955
              ],
              "type": "number"
            },
            "lon": {
              "description": "Longitude.",
              "examples": [
                -122.3937
              ],
              "type": "number"
            },
            "name": {
              "description": "Where the search centred.",
              "examples": [
                "San Francisco Ferry Building (building in San Francisco)"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "source": {
              "description": "How the center was found.",
              "examples": [
                "Wikidata Q1060289"
              ],
              "type": "string"
            }
          },
          "required": [
            "name",
            "lat",
            "lon",
            "source"
          ],
          "type": "object"
        },
        "notes": {
          "description": "Caveats; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "Nothing matched within 1000 m; the search was widened to 4000 m."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "place_count": {
          "description": "Places returned.",
          "examples": [
            10
          ],
          "type": "integer"
        },
        "places": {
          "description": "Places, category matches first, then nearest.",
          "items": {
            "description": "A place.",
            "properties": {
              "address": {
                "description": "Address.",
                "examples": [
                  "Ferry Building, 1, San Francisco, CA, 94111"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "brand": {
                "description": "Brand.",
                "examples": [
                  "Red Bay Coffee"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "category": {
                "description": "Category.",
                "examples": [
                  "coffee_shop"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "confidence": {
                "description": "Overture's confidence the place exists (0-1).",
                "examples": [
                  0.942
                ],
                "type": "number"
              },
              "country": {
                "description": "ISO country.",
                "examples": [
                  "US"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "distance_m": {
                "description": "Distance from the center.",
                "examples": [
                  54
                ],
                "type": "integer"
              },
              "id": {
                "description": "Overture place id (GERS).",
                "examples": [
                  "8333e7a5-b1ca-4c61-969d-5543d8de977a"
                ],
                "type": "string"
              },
              "lat": {
                "description": "Latitude.",
                "examples": [
                  37.7953
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "lon": {
                "description": "Longitude.",
                "examples": [
                  -122.3931
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "name": {
                "description": "Name.",
                "examples": [
                  "Red Bay Coffee Ferry Building"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "operating_status": {
                "description": "open, temporarily_closed...",
                "examples": [
                  "open"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "phone": {
                "description": "Phone.",
                "examples": [
                  "(415) 983-8000"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "sources": {
                "description": "Datasets behind this place.",
                "examples": [
                  [
                    "meta"
                  ]
                ],
                "items": {
                  "description": "Source dataset.",
                  "examples": [
                    "meta"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "website": {
                "description": "Website.",
                "examples": [
                  "http://redbaycoffee.com"
                ],
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "name",
              "category",
              "distance_m",
              "lat",
              "lon",
              "address",
              "country",
              "website",
              "phone",
              "brand",
              "operating_status",
              "confidence",
              "sources"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "query": {
          "description": "The query as given.",
          "examples": [
            "coffee near the Ferry Building, San Francisco"
          ],
          "type": "string"
        },
        "radius_m": {
          "description": "Radius searched (widened when nothing was close).",
          "examples": [
            1000
          ],
          "type": "integer"
        },
        "what": {
          "description": "What was searched for.",
          "examples": [
            "coffee"
          ],
          "type": "string"
        }
      },
      "required": [
        "query",
        "what",
        "near",
        "radius_m",
        "places",
        "place_count",
        "attribution",
        "notes",
        "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": "maps.places response",
  "type": "object"
}