product-type-lens.schema.json¶

This schema validates the lens block of products with productType: "lens". Its structure combines general optical specifications with composable features such as cinema, anamorphic, and macro capabilities.

Structure of the lens block¶

All top-level fields below except imageCircleDiameters and zoom are required. Some required fields may be null when accepted published evidence is unavailable. zoom is required when focalLength.kind is zoom and is prohibited when it is prime.

Example of general lens specifications¶

The following example uses the NIKKOR Z 24-70mm f/2.8 S II to show how to record focal length, aperture, focus, and image stabilization. The specialized section lists features permitted by the schema, including features not present in this product.

Source: data/records/lenses/nikkor/nikkor-z-24-to-70mm-f2p8-s-ii.json

{
  "focalLength": {
    "kind": "zoom",
    "rangeMm": {
      "minimum": 24,
      "maximum": 70
    }
  },
  "aperture": {
    "fNumber": {
      "maximumAperture": [
        {
          "value": 2.8,
          "conditions": {}
        }
      ],
      "minimumAperture": [
        {
          "value": 22,
          "conditions": {}
        }
      ],
      "effective": null
    },
    "diaphragm": {
      "present": true,
      "bladeCount": 11,
      "bladeShape": "rounded"
    },
    "controlMechanism": "electronic"
  }
}

{
  "focus": {
    "autofocus": {
      "present": true,
      "motors": [
        {
          "type": "voice-coil-motor",
          "quantity": null,
          "officialName": "Silky Swift VCM"
        }
      ]
    },
    "manualFocus": {
      "present": true,
      "mechanism": null
    }
  },
  "zoom": {
    "drive": null,
    "opticalZoomingSystems": null
  },
  "stabilization": {
    "present": false
  }
}

Optical specifications¶

Aperture¶

lens.aperture records F-numbers, T-stops, the diaphragm mechanism, and the control mechanism separately. fNumber, diaphragm, and controlMechanism are required. Only products with published T-stops contain tNumber.

F-numbers and T-stops¶

fNumber is an object or null. When it is an object, it contains maximumAperture, minimumAperture, and effective. tNumber uses the same structure, but the field itself is optional.

For value and conditions in each measurement, see F-number and T-stop measurements.

Diaphragm mechanism¶

Focus¶

autofocus, manualFocus, opticalFocusingSystems, minimumFocusDistances, reproductionMagnifications, and officialFocusBehaviorClaims are all required.

Autofocus and manual focus¶

Autofocus and manual focus each use the following three states.

Focusing systems and focus specifications¶

Zoom¶

Every zoom lens requires lens.zoom. If accepted published evidence does not establish the drive or optical zooming system, retain the field and use null.

Prime lenses omit lens.zoom.

Image stabilization¶

Every element of ratings[] requires stops and conditions. Within conditions, record only the published conditions.

Composable features¶

lens.specialized is required, but record {} when no feature applies. A product may combine several features, such as cinema, anamorphic, and macro capabilities, without being limited to a single subtype.

Anamorphic, fisheye, and macro¶

Lens movements¶

lens.specialized.movements uses the shared movements definition and contains at least one of tiltMeasurements, shiftMeasurements, and rotationMeasurements.

Probe¶

The presence of the lens.specialized.probe key identifies a probe lens. Use {} even when no viewing-direction or lighting information is available.

Built-in teleconverter¶

magnification, unitOpticalConstruction, and engagedSpecifications are required within lens.specialized.builtInTeleconverter. engagedSpecifications records only the specifications that change when the built-in teleconverter is engaged.

All six fields in engagedSpecifications are required. Use null when a value has not been published. Arrays that can represent a checked list with no applicable entries may also use [].

Related pages¶

• Shared definitions: focal length, measurement conditions, optical construction, and focus specifications
• product-components: identity, mount, and physical information shared with lenses
• Lens and related optical product field reference: examples of general lenses and specialized features

JSON Schema file