Skip to main content
Glama

resolve_intersection

Read-onlyIdempotent

Resolve a NAMED cross-street (street1 × street2 within a locality/region/country) to a single best coordinate with a confidence score and a fleet-safe fallback. High-confidence tier matches US-metro highway corners; named non-highway streets resolve via the geocoder fallback. For free-form streets use geocode.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "street1": "<street1>",
      "street2": "<street2>"
    },
    "name": "resolve_intersection"
  }
}

Input Schema

NameRequiredDescriptionDefault
regionNoState / province (full name or abbreviation, e.g. 'TX')
countryNoISO 3166-1 alpha-2/alpha-3 country code
street1YesFirst street of the cross-street pair
street2YesSecond (cross) street of the pair
localityNoCity / town that scopes the lookup

Output Schema

NameRequiredDescriptionDefault
metaNo
adminNo
featureYesBest resolved intersection feature, including validated optional intersection provenance, or null when nothing resolved
warningsNo
precisionNo
confidenceYesResolved confidence 0–1 (0 when nothing resolved)
fallback_usedNoTrue when the geocoder fallback produced the answer
upstream_errorNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -trueNew value: +{}
    • changedOutput schema / properties / admin / additionalProperties
      Previous value: -trueNew value: +{}
    • changedOutput schema / properties / feature / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "address_components": {
      -        "additionalProperties": false,
      -        "description": "The same US components the formatted string is built from. Every field is source-established or absent; nothing is inferred or back-filled.",
      -        "properties": {
      -          "country_code": {
      -            "type": "string"
      -          },
      -          "house_number": {
      -            "type": "string"
      -          },
      -          "locality": {
      -            "type": "string"
      -          },
      -          "postal_code": {
      -            "type": "string"
      -          },
      -          "region_code": {
      -            "type": "string"
      -          },
      -          "region_name": {
      -            "type": "string"
      -          },
      -          "street": {
      -            "type": "string"
      -          },
      -          "unit": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "address_evidence": {
      -        "additionalProperties": false,
      -        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      -        "properties": {
      -          "house_number": {
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "locality": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "postal_code": {
      -            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "region": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "street": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          }
      -        },
      -        "required": [
      -          "house_number",
      -          "street",
      -          "locality",
      -          "region",
      -          "postal_code"
      -        ],
      -        "type": "object"
      -      },
      -      "address_line1": {
      -        "description": "House number and street for an eligible US address result, composed from the result's own components — never parsed from the display label. Absent when the result is not a US street address.",
      -        "type": "string"
      -      },
      -      "address_line2": {
      -        "description": "Unit or suite, only when the source record carries one. A unit supplied in your request is never echoed back here.",
      -        "type": "string"
      -      },
      -      "confidence": {
      -        "type": "number"
      -      },
      -      "confidence_scope": {
      -        "const": "query_to_candidate",
      -        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      -        "type": "string"
      -      },
      -      "cross_street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "cross_street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "formatted_address": {
      -        "description": "Single-line US display form, e.g. `1600 Pennsylvania Avenue NW, Washington, DC 20500, USA`. The postal segment is present only when an eligible ZIP is; its absence never suppresses the street address.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "intersection_precision": {
      -        "enum": [
      -          "geometric_crossing",
      -          "tangent_intersection",
      -          "centroid_cluster",
      -          "approximate"
      -        ],
      -        "type": "string"
      -      },
      -      "intersection_type": {
      -        "enum": [
      -          "corner",
      -          "interchange"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "lat": {
      -        "type": "number"
      -      },
      -      "layer": {
      -        "type": "string"
      -      },
      -      "lon": {
      -        "type": "number"
      -      },
      -      "method": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "place_type": {
      -        "type": "string"
      -      },
      -      "postal_code": {
      -        "description": "An eligible US ZIP5 read from the selected result's own postal-code field. While origin enforcement is active this field is emitted ONLY when the engine stamped the value as coming from the address record itself (`source_record` provenance); a value inherited from a parent area, or a result cached before that evidence existed, is omitted rather than emitted without provenance — so an absent ZIP under enforcement means \"not proven for this record\", not \"no such ZIP\". Provenance describes only WHERE the value came from. It is not a postal operator check of any kind — no certification, no address-quality rating, and no statement about whether mail would arrive — so a syntactically correct, correctly-sourced value can still be wrong for the address. Also omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      -        "pattern": "^[0-9]{5}$",
      -        "type": "string"
      -      },
      -      "postal_input_match": {
      -        "description": "STRUCTURED GEOCODING ONLY (`geocode_structured` / `POST /v1/search/structured`); absent from free-text geocoding. Whether the postcode YOU SUBMITTED agrees with this candidate's own postcode — `match` (same five-digit value), `conflict` (they differ), `unavailable` (no comparison was possible). This compares two values already in hand: no lookup, no external reference, and your query text is never parsed to find one. `conflict` does NOT say which side is wrong — your input may name a neighbouring area, the candidate may be a near-miss, or the record's own value may be stale; treat it as a prompt to ask a human, never as a correction to apply automatically. The candidate side counts only when its postcode came from the address record itself; one inherited from a parent area yields `unavailable` rather than a misleading verdict. `unavailable` also covers: nothing submitted, a submitted value not readable as a US five-digit code, and results cached before this field existed.",
      -        "enum": [
      -          "match",
      -          "conflict",
      -          "unavailable"
      -        ],
      -        "type": "string"
      -      },
      -      "street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "address_components": {
      +        "additionalProperties": false,
      +        "description": "The same US components the formatted string is built from. Every field is source-established or absent; nothing is inferred or back-filled.",
      +        "properties": {
      +          "country_code": {
      +            "type": "string"
      +          },
      +          "house_number": {
      +            "type": "string"
      +          },
      +          "locality": {
      +            "type": "string"
      +          },
      +          "postal_code": {
      +            "type": "string"
      +          },
      +          "region_code": {
      +            "type": "string"
      +          },
      +          "region_name": {
      +            "type": "string"
      +          },
      +          "street": {
      +            "type": "string"
      +          },
      +          "unit": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "address_evidence": {
      +        "additionalProperties": false,
      +        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      +        "properties": {
      +          "house_number": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "locality": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "postal_code": {
      +            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "region": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "street": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "house_number",
      +          "street",
      +          "locality",
      +          "region",
      +          "postal_code"
      +        ],
      +        "type": "object"
      +      },
      +      "address_line1": {
      +        "description": "House number and street for an eligible US address result, composed from the result's own components — never parsed from the display label. Absent when the result is not a US street address.",
      +        "type": "string"
      +      },
      +      "address_line2": {
      +        "description": "Unit or suite, only when the source record carries one. A unit supplied in your request is never echoed back here.",
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "type": "number"
      +      },
      +      "confidence_scope": {
      +        "const": "query_to_candidate",
      +        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      +        "type": "string"
      +      },
      +      "cross_street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "cross_street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "formatted_address": {
      +        "description": "Single-line US display form, e.g. `1600 Pennsylvania Avenue NW, Washington, DC 20500, USA`. The postal segment is present only when an eligible ZIP is; its absence never suppresses the street address.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "intersection_precision": {
      +        "enum": [
      +          "geometric_crossing",
      +          "tangent_intersection",
      +          "centroid_cluster",
      +          "approximate"
      +        ],
      +        "type": "string"
      +      },
      +      "intersection_type": {
      +        "enum": [
      +          "corner",
      +          "interchange"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "lat": {
      +        "type": "number"
      +      },
      +      "layer": {
      +        "type": "string"
      +      },
      +      "lon": {
      +        "type": "number"
      +      },
      +      "method": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "place_type": {
      +        "type": "string"
      +      },
      +      "postal_code": {
      +        "description": "An eligible US ZIP5 read from the selected result's own postal-code field. While origin enforcement is active this field is emitted ONLY when the engine stamped the value as coming from the address record itself (`source_record` provenance); a value inherited from a parent area, or a result cached before that evidence existed, is omitted rather than emitted without provenance — so an absent ZIP under enforcement means \"not proven for this record\", not \"no such ZIP\". Provenance describes only WHERE the value came from. It is not a postal operator check of any kind — no certification, no address-quality rating, and no statement about whether mail would arrive — so a syntactically correct, correctly-sourced value can still be wrong for the address. Also omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      +        "pattern": "^[0-9]{5}$",
      +        "type": "string"
      +      },
      +      "postal_input_match": {
      +        "description": "STRUCTURED GEOCODING ONLY (`geocode_structured` / `POST /v1/search/structured`); absent from free-text geocoding. Whether the postcode YOU SUBMITTED agrees with this candidate's own postcode — `match` (same five-digit value), `conflict` (they differ), `unavailable` (no comparison was possible). This compares two values already in hand: no lookup, no external reference, and your query text is never parsed to find one. `conflict` does NOT say which side is wrong — your input may name a neighbouring area, the candidate may be a near-miss, or the record's own value may be stale; treat it as a prompt to ask a human, never as a correction to apply automatically. The candidate side counts only when its postcode came from the address record itself; one inherited from a parent area yields `unavailable` rather than a misleading verdict. `unavailable` also covers: nothing submitted, a submitted value not readable as a US five-digit code, and results cached before this field existed.",
      +        "enum": [
      +          "match",
      +          "conflict",
      +          "unavailable"
      +        ],
      +        "type": "string"
      +      },
      +      "street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / meta / additionalProperties
      Previous value: -trueNew value: +{}
    • changedOutput schema / properties / precision / additionalProperties
      Previous value: -trueNew value: +{}
    • changedOutput schema / properties / precision / properties / learning_overlay / additionalProperties
      Previous value: -trueNew value: +{}
  2. Changed1 schema field changed
    • changedOutput schema / properties / feature / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "address_components": {
      -        "additionalProperties": false,
      -        "description": "The same US components the formatted string is built from. Every field is source-established or absent; nothing is inferred or back-filled.",
      -        "properties": {
      -          "country_code": {
      -            "type": "string"
      -          },
      -          "house_number": {
      -            "type": "string"
      -          },
      -          "locality": {
      -            "type": "string"
      -          },
      -          "postal_code": {
      -            "type": "string"
      -          },
      -          "region_code": {
      -            "type": "string"
      -          },
      -          "region_name": {
      -            "type": "string"
      -          },
      -          "street": {
      -            "type": "string"
      -          },
      -          "unit": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "address_evidence": {
      -        "additionalProperties": false,
      -        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      -        "properties": {
      -          "house_number": {
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "locality": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "postal_code": {
      -            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "region": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "street": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          }
      -        },
      -        "required": [
      -          "house_number",
      -          "street",
      -          "locality",
      -          "region",
      -          "postal_code"
      -        ],
      -        "type": "object"
      -      },
      -      "address_line1": {
      -        "description": "House number and street for an eligible US address result, composed from the result's own components — never parsed from the display label. Absent when the result is not a US street address.",
      -        "type": "string"
      -      },
      -      "address_line2": {
      -        "description": "Unit or suite, only when the source record carries one. A unit supplied in your request is never echoed back here.",
      -        "type": "string"
      -      },
      -      "confidence": {
      -        "type": "number"
      -      },
      -      "confidence_scope": {
      -        "const": "query_to_candidate",
      -        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      -        "type": "string"
      -      },
      -      "cross_street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "cross_street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "formatted_address": {
      -        "description": "Single-line US display form, e.g. `1600 Pennsylvania Avenue NW, Washington, DC 20500, USA`. The postal segment is present only when an eligible ZIP is; its absence never suppresses the street address.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "intersection_precision": {
      -        "enum": [
      -          "geometric_crossing",
      -          "tangent_intersection",
      -          "centroid_cluster",
      -          "approximate"
      -        ],
      -        "type": "string"
      -      },
      -      "intersection_type": {
      -        "enum": [
      -          "corner",
      -          "interchange"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "lat": {
      -        "type": "number"
      -      },
      -      "layer": {
      -        "type": "string"
      -      },
      -      "lon": {
      -        "type": "number"
      -      },
      -      "method": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "place_type": {
      -        "type": "string"
      -      },
      -      "postal_code": {
      -        "description": "An eligible US ZIP5 normalized from the selected native result's available postal-code field; direct address-record origin is not yet guaranteed. Not checked against any postal operator's records, so a syntactically correct value can still be wrong for the address. Omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      -        "pattern": "^[0-9]{5}$",
      -        "type": "string"
      -      },
      -      "postal_input_match": {
      -        "description": "STRUCTURED GEOCODING ONLY (`geocode_structured` / `POST /v1/search/structured`); absent from free-text geocoding. Whether the postcode YOU SUBMITTED agrees with this candidate's own postcode — `match` (same five-digit value), `conflict` (they differ), `unavailable` (no comparison was possible). This compares two values already in hand: no lookup, no external reference, and your query text is never parsed to find one. `conflict` does NOT say which side is wrong — your input may name a neighbouring area, the candidate may be a near-miss, or the record's own value may be stale; treat it as a prompt to ask a human, never as a correction to apply automatically. The candidate side counts only when its postcode came from the address record itself; one inherited from a parent area yields `unavailable` rather than a misleading verdict. `unavailable` also covers: nothing submitted, a submitted value not readable as a US five-digit code, and results cached before this field existed.",
      -        "enum": [
      -          "match",
      -          "conflict",
      -          "unavailable"
      -        ],
      -        "type": "string"
      -      },
      -      "street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "address_components": {
      +        "additionalProperties": false,
      +        "description": "The same US components the formatted string is built from. Every field is source-established or absent; nothing is inferred or back-filled.",
      +        "properties": {
      +          "country_code": {
      +            "type": "string"
      +          },
      +          "house_number": {
      +            "type": "string"
      +          },
      +          "locality": {
      +            "type": "string"
      +          },
      +          "postal_code": {
      +            "type": "string"
      +          },
      +          "region_code": {
      +            "type": "string"
      +          },
      +          "region_name": {
      +            "type": "string"
      +          },
      +          "street": {
      +            "type": "string"
      +          },
      +          "unit": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "address_evidence": {
      +        "additionalProperties": false,
      +        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      +        "properties": {
      +          "house_number": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "locality": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "postal_code": {
      +            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "region": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "street": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          }
      +        },
      +        "required": [
      +          "house_number",
      +          "street",
      +          "locality",
      +          "region",
      +          "postal_code"
      +        ],
      +        "type": "object"
      +      },
      +      "address_line1": {
      +        "description": "House number and street for an eligible US address result, composed from the result's own components — never parsed from the display label. Absent when the result is not a US street address.",
      +        "type": "string"
      +      },
      +      "address_line2": {
      +        "description": "Unit or suite, only when the source record carries one. A unit supplied in your request is never echoed back here.",
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "type": "number"
      +      },
      +      "confidence_scope": {
      +        "const": "query_to_candidate",
      +        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      +        "type": "string"
      +      },
      +      "cross_street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "cross_street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "formatted_address": {
      +        "description": "Single-line US display form, e.g. `1600 Pennsylvania Avenue NW, Washington, DC 20500, USA`. The postal segment is present only when an eligible ZIP is; its absence never suppresses the street address.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "intersection_precision": {
      +        "enum": [
      +          "geometric_crossing",
      +          "tangent_intersection",
      +          "centroid_cluster",
      +          "approximate"
      +        ],
      +        "type": "string"
      +      },
      +      "intersection_type": {
      +        "enum": [
      +          "corner",
      +          "interchange"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "lat": {
      +        "type": "number"
      +      },
      +      "layer": {
      +        "type": "string"
      +      },
      +      "lon": {
      +        "type": "number"
      +      },
      +      "method": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "place_type": {
      +        "type": "string"
      +      },
      +      "postal_code": {
      +        "description": "An eligible US ZIP5 read from the selected result's own postal-code field. While origin enforcement is active this field is emitted ONLY when the engine stamped the value as coming from the address record itself (`source_record` provenance); a value inherited from a parent area, or a result cached before that evidence existed, is omitted rather than emitted without provenance — so an absent ZIP under enforcement means \"not proven for this record\", not \"no such ZIP\". Provenance describes only WHERE the value came from. It is not a postal operator check of any kind — no certification, no address-quality rating, and no statement about whether mail would arrive — so a syntactically correct, correctly-sourced value can still be wrong for the address. Also omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      +        "pattern": "^[0-9]{5}$",
      +        "type": "string"
      +      },
      +      "postal_input_match": {
      +        "description": "STRUCTURED GEOCODING ONLY (`geocode_structured` / `POST /v1/search/structured`); absent from free-text geocoding. Whether the postcode YOU SUBMITTED agrees with this candidate's own postcode — `match` (same five-digit value), `conflict` (they differ), `unavailable` (no comparison was possible). This compares two values already in hand: no lookup, no external reference, and your query text is never parsed to find one. `conflict` does NOT say which side is wrong — your input may name a neighbouring area, the candidate may be a near-miss, or the record's own value may be stale; treat it as a prompt to ask a human, never as a correction to apply automatically. The candidate side counts only when its postcode came from the address record itself; one inherited from a parent area yields `unavailable` rather than a misleading verdict. `unavailable` also covers: nothing submitted, a submitted value not readable as a US five-digit code, and results cached before this field existed.",
      +        "enum": [
      +          "match",
      +          "conflict",
      +          "unavailable"
      +        ],
      +        "type": "string"
      +      },
      +      "street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / properties / feature / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "address_components": {
      -        "additionalProperties": false,
      -        "description": "The same US components the formatted string is built from. Every field is source-established or absent; nothing is inferred or back-filled.",
      -        "properties": {
      -          "country_code": {
      -            "type": "string"
      -          },
      -          "house_number": {
      -            "type": "string"
      -          },
      -          "locality": {
      -            "type": "string"
      -          },
      -          "postal_code": {
      -            "type": "string"
      -          },
      -          "region_code": {
      -            "type": "string"
      -          },
      -          "street": {
      -            "type": "string"
      -          },
      -          "unit": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "address_evidence": {
      -        "additionalProperties": false,
      -        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      -        "properties": {
      -          "house_number": {
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "locality": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "postal_code": {
      -            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "region": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "street": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          }
      -        },
      -        "required": [
      -          "house_number",
      -          "street",
      -          "locality",
      -          "region",
      -          "postal_code"
      -        ],
      -        "type": "object"
      -      },
      -      "address_line1": {
      -        "description": "House number and street for an eligible US address result, composed from the result's own components — never parsed from the display label. Absent when the result is not a US street address.",
      -        "type": "string"
      -      },
      -      "address_line2": {
      -        "description": "Unit or suite, only when the source record carries one. A unit supplied in your request is never echoed back here.",
      -        "type": "string"
      -      },
      -      "confidence": {
      -        "type": "number"
      -      },
      -      "confidence_scope": {
      -        "const": "query_to_candidate",
      -        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      -        "type": "string"
      -      },
      -      "cross_street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "cross_street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "formatted_address": {
      -        "description": "Single-line US display form, e.g. `1600 Pennsylvania Avenue NW, Washington, DC 20500, USA`. The postal segment is present only when an eligible ZIP is; its absence never suppresses the street address.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "intersection_precision": {
      -        "enum": [
      -          "geometric_crossing",
      -          "tangent_intersection",
      -          "centroid_cluster",
      -          "approximate"
      -        ],
      -        "type": "string"
      -      },
      -      "intersection_type": {
      -        "enum": [
      -          "corner",
      -          "interchange"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "lat": {
      -        "type": "number"
      -      },
      -      "layer": {
      -        "type": "string"
      -      },
      -      "lon": {
      -        "type": "number"
      -      },
      -      "method": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "place_type": {
      -        "type": "string"
      -      },
      -      "postal_code": {
      -        "description": "An eligible US ZIP5 normalized from the selected native result's available postal-code field; direct address-record origin is not yet guaranteed. Not checked against any postal operator's records, so a syntactically correct value can still be wrong for the address. Omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      -        "pattern": "^[0-9]{5}$",
      -        "type": "string"
      -      },
      -      "street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "address_components": {
      +        "additionalProperties": false,
      +        "description": "The same US components the formatted string is built from. Every field is source-established or absent; nothing is inferred or back-filled.",
      +        "properties": {
      +          "country_code": {
      +            "type": "string"
      +          },
      +          "house_number": {
      +            "type": "string"
      +          },
      +          "locality": {
      +            "type": "string"
      +          },
      +          "postal_code": {
      +            "type": "string"
      +          },
      +          "region_code": {
      +            "type": "string"
      +          },
      +          "region_name": {
      +            "type": "string"
      +          },
      +          "street": {
      +            "type": "string"
      +          },
      +          "unit": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "address_evidence": {
      +        "additionalProperties": false,
      +        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      +        "properties": {
      +          "house_number": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "locality": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "postal_code": {
      +            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "region": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "street": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          }
      +        },
      +        "required": [
      +          "house_number",
      +          "street",
      +          "locality",
      +          "region",
      +          "postal_code"
      +        ],
      +        "type": "object"
      +      },
      +      "address_line1": {
      +        "description": "House number and street for an eligible US address result, composed from the result's own components — never parsed from the display label. Absent when the result is not a US street address.",
      +        "type": "string"
      +      },
      +      "address_line2": {
      +        "description": "Unit or suite, only when the source record carries one. A unit supplied in your request is never echoed back here.",
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "type": "number"
      +      },
      +      "confidence_scope": {
      +        "const": "query_to_candidate",
      +        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      +        "type": "string"
      +      },
      +      "cross_street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "cross_street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "formatted_address": {
      +        "description": "Single-line US display form, e.g. `1600 Pennsylvania Avenue NW, Washington, DC 20500, USA`. The postal segment is present only when an eligible ZIP is; its absence never suppresses the street address.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "intersection_precision": {
      +        "enum": [
      +          "geometric_crossing",
      +          "tangent_intersection",
      +          "centroid_cluster",
      +          "approximate"
      +        ],
      +        "type": "string"
      +      },
      +      "intersection_type": {
      +        "enum": [
      +          "corner",
      +          "interchange"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "lat": {
      +        "type": "number"
      +      },
      +      "layer": {
      +        "type": "string"
      +      },
      +      "lon": {
      +        "type": "number"
      +      },
      +      "method": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "place_type": {
      +        "type": "string"
      +      },
      +      "postal_code": {
      +        "description": "An eligible US ZIP5 normalized from the selected native result's available postal-code field; direct address-record origin is not yet guaranteed. Not checked against any postal operator's records, so a syntactically correct value can still be wrong for the address. Omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      +        "pattern": "^[0-9]{5}$",
      +        "type": "string"
      +      },
      +      "postal_input_match": {
      +        "description": "STRUCTURED GEOCODING ONLY (`geocode_structured` / `POST /v1/search/structured`); absent from free-text geocoding. Whether the postcode YOU SUBMITTED agrees with this candidate's own postcode — `match` (same five-digit value), `conflict` (they differ), `unavailable` (no comparison was possible). This compares two values already in hand: no lookup, no external reference, and your query text is never parsed to find one. `conflict` does NOT say which side is wrong — your input may name a neighbouring area, the candidate may be a near-miss, or the record's own value may be stale; treat it as a prompt to ask a human, never as a correction to apply automatically. The candidate side counts only when its postcode came from the address record itself; one inherited from a parent area yields `unavailable` rather than a misleading verdict. `unavailable` also covers: nothing submitted, a submitted value not readable as a US five-digit code, and results cached before this field existed.",
      +        "enum": [
      +          "match",
      +          "conflict",
      +          "unavailable"
      +        ],
      +        "type": "string"
      +      },
      +      "street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  4. Changed1 schema field changed
    • changedOutput schema / properties / feature / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "address_evidence": {
      -        "additionalProperties": false,
      -        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      -        "properties": {
      -          "house_number": {
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "locality": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "postal_code": {
      -            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "region": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "street": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          }
      -        },
      -        "required": [
      -          "house_number",
      -          "street",
      -          "locality",
      -          "region",
      -          "postal_code"
      -        ],
      -        "type": "object"
      -      },
      -      "confidence": {
      -        "type": "number"
      -      },
      -      "confidence_scope": {
      -        "const": "query_to_candidate",
      -        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      -        "type": "string"
      -      },
      -      "cross_street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "cross_street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "intersection_precision": {
      -        "enum": [
      -          "geometric_crossing",
      -          "tangent_intersection",
      -          "centroid_cluster",
      -          "approximate"
      -        ],
      -        "type": "string"
      -      },
      -      "intersection_type": {
      -        "enum": [
      -          "corner",
      -          "interchange"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "lat": {
      -        "type": "number"
      -      },
      -      "layer": {
      -        "type": "string"
      -      },
      -      "lon": {
      -        "type": "number"
      -      },
      -      "method": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "place_type": {
      -        "type": "string"
      -      },
      -      "postal_code": {
      -        "description": "Five-digit ZIP taken from the postcode supplied with this address record. It is reported by that record's own data source and has not been checked against any postal operator's records, so a syntactically correct value can still be wrong for the address. Omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      -        "pattern": "^[0-9]{5}$",
      -        "type": "string"
      -      },
      -      "street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "address_components": {
      +        "additionalProperties": false,
      +        "description": "The same US components the formatted string is built from. Every field is source-established or absent; nothing is inferred or back-filled.",
      +        "properties": {
      +          "country_code": {
      +            "type": "string"
      +          },
      +          "house_number": {
      +            "type": "string"
      +          },
      +          "locality": {
      +            "type": "string"
      +          },
      +          "postal_code": {
      +            "type": "string"
      +          },
      +          "region_code": {
      +            "type": "string"
      +          },
      +          "street": {
      +            "type": "string"
      +          },
      +          "unit": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "address_evidence": {
      +        "additionalProperties": false,
      +        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      +        "properties": {
      +          "house_number": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "locality": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "postal_code": {
      +            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "region": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "street": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          }
      +        },
      +        "required": [
      +          "house_number",
      +          "street",
      +          "locality",
      +          "region",
      +          "postal_code"
      +        ],
      +        "type": "object"
      +      },
      +      "address_line1": {
      +        "description": "House number and street for an eligible US address result, composed from the result's own components — never parsed from the display label. Absent when the result is not a US street address.",
      +        "type": "string"
      +      },
      +      "address_line2": {
      +        "description": "Unit or suite, only when the source record carries one. A unit supplied in your request is never echoed back here.",
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "type": "number"
      +      },
      +      "confidence_scope": {
      +        "const": "query_to_candidate",
      +        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      +        "type": "string"
      +      },
      +      "cross_street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "cross_street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "formatted_address": {
      +        "description": "Single-line US display form, e.g. `1600 Pennsylvania Avenue NW, Washington, DC 20500, USA`. The postal segment is present only when an eligible ZIP is; its absence never suppresses the street address.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "intersection_precision": {
      +        "enum": [
      +          "geometric_crossing",
      +          "tangent_intersection",
      +          "centroid_cluster",
      +          "approximate"
      +        ],
      +        "type": "string"
      +      },
      +      "intersection_type": {
      +        "enum": [
      +          "corner",
      +          "interchange"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "lat": {
      +        "type": "number"
      +      },
      +      "layer": {
      +        "type": "string"
      +      },
      +      "lon": {
      +        "type": "number"
      +      },
      +      "method": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "place_type": {
      +        "type": "string"
      +      },
      +      "postal_code": {
      +        "description": "An eligible US ZIP5 normalized from the selected native result's available postal-code field; direct address-record origin is not yet guaranteed. Not checked against any postal operator's records, so a syntactically correct value can still be wrong for the address. Omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      +        "pattern": "^[0-9]{5}$",
      +        "type": "string"
      +      },
      +      "street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  5. Changed1 schema field changed
    • changedOutput schema / properties / feature / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "address_evidence": {
      -        "additionalProperties": false,
      -        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      -        "properties": {
      -          "house_number": {
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "locality": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "postal_code": {
      -            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      -            "enum": [
      -              "matched",
      -              "partial",
      -              "absent"
      -            ],
      -            "type": "string"
      -          },
      -          "region": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          },
      -          "street": {
      -            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      -          }
      -        },
      -        "required": [
      -          "house_number",
      -          "street",
      -          "locality",
      -          "region",
      -          "postal_code"
      -        ],
      -        "type": "object"
      -      },
      -      "confidence": {
      -        "type": "number"
      -      },
      -      "confidence_scope": {
      -        "const": "query_to_candidate",
      -        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      -        "type": "string"
      -      },
      -      "cross_street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "cross_street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "intersection_precision": {
      -        "enum": [
      -          "geometric_crossing",
      -          "tangent_intersection",
      -          "centroid_cluster",
      -          "approximate"
      -        ],
      -        "type": "string"
      -      },
      -      "intersection_type": {
      -        "enum": [
      -          "corner",
      -          "interchange"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "lat": {
      -        "type": "number"
      -      },
      -      "layer": {
      -        "type": "string"
      -      },
      -      "lon": {
      -        "type": "number"
      -      },
      -      "method": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "place_type": {
      -        "type": "string"
      -      },
      -      "street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "address_evidence": {
      +        "additionalProperties": false,
      +        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      +        "properties": {
      +          "house_number": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "locality": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "postal_code": {
      +            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "region": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "street": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          }
      +        },
      +        "required": [
      +          "house_number",
      +          "street",
      +          "locality",
      +          "region",
      +          "postal_code"
      +        ],
      +        "type": "object"
      +      },
      +      "confidence": {
      +        "type": "number"
      +      },
      +      "confidence_scope": {
      +        "const": "query_to_candidate",
      +        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      +        "type": "string"
      +      },
      +      "cross_street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "cross_street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "intersection_precision": {
      +        "enum": [
      +          "geometric_crossing",
      +          "tangent_intersection",
      +          "centroid_cluster",
      +          "approximate"
      +        ],
      +        "type": "string"
      +      },
      +      "intersection_type": {
      +        "enum": [
      +          "corner",
      +          "interchange"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "lat": {
      +        "type": "number"
      +      },
      +      "layer": {
      +        "type": "string"
      +      },
      +      "lon": {
      +        "type": "number"
      +      },
      +      "method": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "place_type": {
      +        "type": "string"
      +      },
      +      "postal_code": {
      +        "description": "Five-digit ZIP taken from the postcode supplied with this address record. It is reported by that record's own data source and has not been checked against any postal operator's records, so a syntactically correct value can still be wrong for the address. Omitted when unavailable or unsuitable for five-digit form. US address results only. Distinct from `address_evidence.postal_code`, which is a presence STATUS rather than a value. On reverse geocoding this describes the RETURNED ADDRESS — it is not a postal assignment to the coordinate you supplied.",
      +        "pattern": "^[0-9]{5}$",
      +        "type": "string"
      +      },
      +      "street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  6. Changed1 schema field changed
    • changedOutput schema / properties / feature / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "confidence": {
      -        "type": "number"
      -      },
      -      "cross_street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "cross_street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "intersection_precision": {
      -        "enum": [
      -          "geometric_crossing",
      -          "tangent_intersection",
      -          "centroid_cluster",
      -          "approximate"
      -        ],
      -        "type": "string"
      -      },
      -      "intersection_type": {
      -        "enum": [
      -          "corner",
      -          "interchange"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "lat": {
      -        "type": "number"
      -      },
      -      "layer": {
      -        "type": "string"
      -      },
      -      "lon": {
      -        "type": "number"
      -      },
      -      "method": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "place_type": {
      -        "type": "string"
      -      },
      -      "street_kind": {
      -        "enum": [
      -          "street",
      -          "route"
      -        ],
      -        "type": "string"
      -      },
      -      "street_route": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "address_evidence": {
      +        "additionalProperties": false,
      +        "description": "What THIS CANDIDATE carries, component by component — `matched` (a real value is present), `partial` (only a coarser or derived stand-in, e.g. an interpolated house number or a locality falling back to its administrative parent), `absent` (nothing). This describes the result, NOT a comparison against your query: the engine returns no per-component match data, and re-parsing your text here would mean two parsers disagreeing about the same string. Derived from the feature, never from `confidence`.",
      +        "properties": {
      +          "house_number": {
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "locality": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "postal_code": {
      +            "description": "Whether the candidate carries a postal code. Presence only — this states what the result has, and makes no claim about its correctness.",
      +            "enum": [
      +              "matched",
      +              "partial",
      +              "absent"
      +            ],
      +            "type": "string"
      +          },
      +          "region": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          },
      +          "street": {
      +            "$ref": "#/properties/feature/anyOf/0/properties/address_evidence/properties/house_number"
      +          }
      +        },
      +        "required": [
      +          "house_number",
      +          "street",
      +          "locality",
      +          "region",
      +          "postal_code"
      +        ],
      +        "type": "object"
      +      },
      +      "confidence": {
      +        "type": "number"
      +      },
      +      "confidence_scope": {
      +        "const": "query_to_candidate",
      +        "description": "What `confidence` is scoped to. `query_to_candidate` means it scores how well this candidate matches the submitted query — it is NOT a probability that the place is real, that the address is correct, or that mail would arrive. Fixed value today; treat it as a closed set that may gain members.",
      +        "type": "string"
      +      },
      +      "cross_street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "cross_street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "intersection_precision": {
      +        "enum": [
      +          "geometric_crossing",
      +          "tangent_intersection",
      +          "centroid_cluster",
      +          "approximate"
      +        ],
      +        "type": "string"
      +      },
      +      "intersection_type": {
      +        "enum": [
      +          "corner",
      +          "interchange"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "lat": {
      +        "type": "number"
      +      },
      +      "layer": {
      +        "type": "string"
      +      },
      +      "lon": {
      +        "type": "number"
      +      },
      +      "method": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "place_type": {
      +        "type": "string"
      +      },
      +      "street_kind": {
      +        "enum": [
      +          "street",
      +          "route"
      +        ],
      +        "type": "string"
      +      },
      +      "street_route": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  7. Added

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint and openWorldHint, so safety is covered; the description adds real behavior beyond that — a confidence score, a tiered resolution path, and a 'fleet-safe fallback'. It stops short of saying whether the fallback is automatic or what a low-confidence result looks like, but the substantive traits are disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with what the tool does, then the tiering behavior, then the sibling redirect. No filler and nothing buried at the end where it would be missed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be spelled out, and annotations cover the safety profile. The description covers purpose, coverage limits and the alternative; the only soft spot is that the mechanics of the 'fallback' (when it triggers, whether it can still fail) are left implicit.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so all five parameters are already documented with formats and lengths. The description restates the scoping role of locality/region/country and the street1 × street2 pairing but adds no new syntax or edge-case meaning, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (resolve) and resource (a named cross-street pair) plus the output shape (single best coordinate with confidence score). It explicitly separates itself from the sibling 'geocode' by restricting scope to NAMED cross-streets, so an agent can pick between them without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives both sides of the routing decision: use this for named cross-streets scoped by locality/region/country, use geocode for free-form streets. It also discloses the tiering rule (US-metro highway corners hit the high-confidence tier, other named streets go through the geocoder fallback), which tells the agent what quality of answer to expect before calling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources