api.locus.report

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "additionalProperties": {},
      "properties": {
        "accessFlag": {
          "enum": [
            "has_road_access",
            "set_back",
            "track_only",
            "no_road_within_radius"
          ],
          "type": "string"
        },
        "caveats": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "charged": {
          "const": true,
          "type": "boolean"
        },
        "kind": {
          "const": "road_access",
          "type": "string"
        },
        "limitedAccessHighwayNearby": {
          "anyOf": [
            {
              "additionalProperties": {},
              "properties": {},
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "nearestVehicularRoad": {
          "anyOf": [
            {
              "additionalProperties": {},
              "properties": {},
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "point": {
          "additionalProperties": false,
          "properties": {
            "latitude": {
              "type": "number"
            },
            "longitude": {
              "type": "number"
            }
          },
          "required": [
            "latitude",
            "longitude"
          ],
          "type": "object"
        },
        "privateRoadSignal": {
          "type": "boolean"
        },
        "provenance": {
          "additionalProperties": {},
          "properties": {},
          "type": "object"
        },
        "radiusMeters": {
          "type": "number"
        },
        "secondNearestVehicularRoad": {
          "anyOf": [
            {
              "additionalProperties": {},
              "properties": {},
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "sourceLocationPrecision": {
          "const": "point_not_boundary",
          "type": "string"
        },
        "trackOrPathNearer": {
          "anyOf": [
            {
              "additionalProperties": {},
              "properties": {},
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "kind",
        "point",
        "radiusMeters",
        "sourceLocationPrecision",
        "nearestVehicularRoad",
        "secondNearestVehicularRoad",
        "accessFlag",
        "trackOrPathNearer",
        "limitedAccessHighwayNearby",
        "privateRoadSignal",
        "provenance",
        "caveats",
        "charged"
      ],
      "type": "object"
    },
    {
      "additionalProperties": {},
      "properties": {
        "caveats": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "charged": {
          "const": false,
          "type": "boolean"
        },
        "kind": {
          "const": "road_access_diagnostic",
          "type": "string"
        },
        "point": {
          "additionalProperties": false,
          "properties": {
            "latitude": {
              "type": "number"
            },
            "longitude": {
              "type": "number"
            }
          },
          "required": [
            "latitude",
            "longitude"
          ],
          "type": "object"
        },
        "reason": {
          "enum": [
            "address_unresolved",
            "road_source_unavailable"
          ],
          "type": "string"
        }
      },
      "required": [
        "kind",
        "reason",
        "caveats",
        "charged"
      ],
      "type": "object"
    }
  ],
  "description": "A `kind`-discriminated union: `road_access` (nearest vehicular road by point-to-segment distance, an accessFlag of has_road_access/set_back/track_only/no_road_within_radius, track-or-path and limited-access-highway flags, a private-road flag, OSM provenance, and mandatory caveats; sourceLocationPrecision is point_not_boundary) for a completed measurement, or `road_access_diagnostic` (charged:false) when the address is unresolved or every Overpass mirror failed. Mapped-road adjacency screen only - never a legal access, easement, or landlocked determination."
}