shared-definitions.schema.json¶

このJSON Schemaは、複数のJSON Schemaから参照する定義を$defsにまとめています。 IDや数値のほか、焦点距離、測定条件、レンズ構成、電子情報、三脚支持、可動量なども定義します。

単独のJSONファイルを検証するJSON Schemaではありません。 必要な定義は、各JSON Schemaから$refで参照します。

共通定義の使用例¶

NIKKOR Z 24-70mm f/2.8 S IIを例に、共通定義が実際の値をどのように表すかを示します。

参照元：data/records/lenses/nikkor/nikkor-z-24-to-70mm-f2p8-s-ii.json

{
  "kind": "zoom",
  "rangeMm": {
    "minimum": 24,
    "maximum": 70
  }
}

{
  "format": "full-frame",
  "orientation": "diagonal",
  "degrees": 84,
  "conditions": {
    "focalLength": {
      "kind": "point",
      "millimeters": 24
    }
  }
}

{
  "value": 2.8,
  "conditions": {}
}

focalLengthは製品の公称焦点距離を表します。 測定値のconditions.focalLengthは、その値が焦点距離上のどこで成立するかを表します。 conditionsが空のオブジェクトの場合、焦点距離や撮影距離などの追加条件はありません。

基本値¶

JAN、EAN、UPC、バーコード、SKU、商品番号、カタログ番号、記事番号などは、メーカーまたはブランドが型番として明示していない限り、modelNumberOptionsに記録しません。

焦点距離と条件¶

focalLengthCondition¶

測定値が適用される焦点距離上の一点または範囲を表します。 レンズ自体の焦点距離仕様ではありません。

pointではkindとmillimeters、rangeではkind、minimumMm、maximumMmが必須です。 二つの構造は排他的で、選ばなかった構造のフィールドは含められません。

focalLength¶

kindに応じて、次のフィールドを記録します。

primeではkindとmillimeters、zoomではkindとrangeMm、interchangeableではkindとconfigurationsが必須です。 三つの構造は排他的で、選ばなかった構造のフィールドは含められません。 configurationsには、magnificationとmillimetersを持つ重複のない要素が2件以上必要です。

条件オブジェクト¶

測定値に付けられる条件は、値の種類によって異なります。 各キーは任意で、空のオブジェクト{}は追加条件がないことを示します。

条件オブジェクトには、次のキーを組み合わせて記録します。

光学値¶

F値とT値¶

angleOfView¶

opticalConstruction¶

群数と枚数の少なくとも一方には数値が必要です。 片方だけが公式に公表されている場合は、もう片方にnullを記録できます。 両方が数値の場合は、hatch run validateが群数が枚数以下であることを確認します。

specialElement¶

coating¶

typesはブランド横断の分類を表し、officialNameはメーカーの公式表記を保持します。両者が同じ一般的な性質を表していても、安定して使われる技術名称はofficialNameに記録します。officialNameはブランドと項目の組み合わせごとに解釈し、同じ表記でも別ブランドの技術が同一であるとはみなしません。本文中の文頭・文中による大文字小文字の違い、空白、ハイフン、単複、一般的な接尾語だけの違いは別名として扱いません。公式の用語集、技術ページ、仕様表、見出し、バッジ、製品上の表示を優先します。公式英語ページに対応する名称がある場合は英語表記を使い、ない場合は公開されている表記を保持して独自に翻訳しません。®や™は名称に含めませんが、T*の*のように名称自体を構成する記号は残します。

環境保護表現¶

environmentalClaimは、防塵、防滴、耐候などについてメーカーまたはブランドが明示した表現を、その対象範囲とともに記録します。

scope.kindがproductの場合はkindだけを記録します。 componentの場合はcomponentも必須です。 この定義は公式表現を構造化するものであり、規格試験への適合や完全な防水性を推定するものではありません。

電子情報¶

metadataTransmission¶

metadataTransmissionは、撮影メタデータを伝達するかどうかと、公表された伝達規格を記録します。

伝達しないことを確認した場合は{ "present": false }を記録します。 伝達を確認した場合はpresent: trueとstandardsが必要です。 伝達の有無自体を確認できない場合はnullを使います。

electronicServices¶

electronicServicesは、製品向けファームウェア更新の公開有無と、更新、設定、制御に使う接続方式を記録します。

電子サービス全体を確認できない場合はelectronicServices: nullを使います。

三脚支持¶

tripodSupportは、三脚支持部の有無と、確認できた構成部品を記録します。 レンズとマウントアダプターで同じ定義を使用します。

ねじ規格を確認できないmounting-threadでは、threadDesignation: nullを記録します。 三脚支持部がないことを確認した場合は{ "present": false }、有無を確認できない場合はnullを使います。

可動量¶

movementsは、ティルト、シフト、および可動部を光軸周りに回転できる範囲を記録します。 レンズとマウントアダプターで同じ定義を使用します。

movementsは、tiltMeasurements、shiftMeasurements、rotationMeasurementsのうち少なくとも一つを持ちます。 測定値の配列に同じ要素を重複して記録できません。 各測定値では中立位置からの最大値と全可動範囲の少なくとも一方に数値が必要で、もう一方を確認できない場合はnullを記録します。 directionalityとconditionsも必須で、追加条件がなければconditions: {}を記録します。 該当する可動機構は確認できるものの公称値を確認できない場合は、対応する値にnullを記録できます。

撮影距離と倍率¶

minimumFocusDistanceとworkingDistanceの各要素では、distanceMとconditionsがどちらも必須です。 reproductionMagnificationでは、maximumまたはfixedにvalue、rangeにminimumとmaximum、discreteにvaluesを使用し、すべての構造でkindとconditionsが必須です。 各構造は排他的で、valuesには重複のない値が1件以上必要です。

取付先¶

hostは、フィルターなどの取付先が製品本体か外付けアクセサリーかを表します。

kindがproductの場合はkindだけを記録します。 accessoryの場合は、categoryとmodelNumberOptionsも必要です。

リポジトリ検証¶

hatch run validateでは、範囲の下限が上限を超えていないことも確認します。 対象には、焦点距離、撮影倍率などのminimumとmaximumが含まれます。 光学構成では、groupsがelementsを超えていないことも確認します。

関連ページ¶

• JSON Schemaリファレンス：JSON Schema全体の構成と読み方
• 値の読み方：null、空配列、falseの使い分け
• レンズと関連光学製品のフィールドリファレンス：収録製品データ内での使われ方
• マウントアダプターのフィールドリファレンス：マウントアダプターで共通定義を使う項目
• JSON Schemaファイル