Postal Address Validation & Standardization

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Full address as free text"
    },
    "country_code": {
      "type": "string",
      "description": "ISO 2-letter country code hint (optional)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean",
      "description": "Whether the address resolved to a real, matchable location."
    },
    "latitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Observed null when the address does not resolve."
    },
    "longitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Observed null when the address does not resolve."
    },
    "components": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "house_number": {
          "type": "string"
        }
      },
      "description": "Parsed address components. Observed null (the whole object, not individual fields) when the address does not resolve.",
      "additionalProperties": true
    },
    "confidence": {
      "type": "number",
      "description": "Match confidence, 0 to 1. Observed 0.84 on a fully-matched address and 0 on an address that did not resolve at all."
    },
    "match_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "e.g. 'approximate' on a resolved match; observed null when the address does not resolve."
    },
    "input_address": {
      "type": "string",
      "description": "The address text exactly as submitted, echoed back."
    },
    "formatted_address": {
      "type": [
        "string",
        "null"
      ],
      "description": "Standardized, geocoder-formatted version of the input address. Observed null when the address does not resolve to any location."
    }
  },
  "description": "The address validation result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}