如何在OpenAPI中正确定义使用Coordinate等自定义数据类型？

• OpenAPI 规范中type字段仅支持内置基础类型：object、array、string、number、integer、boolean，直接填写自定义类型名Coordinate属于非法取值，自定义复合结构必须通过$ref关键字引用预定义的Schema。
• 你给出的坐标格式{(123,123),{2144123,123444)}属于多坐标点集合，不是单个坐标对象，不能直接复用单点结构。
• 贴出的YAML存在缩进不一致问题，Coordinate和facilities节点缩进差1个空格，YAML对缩进强敏感，会直接导致解析失败。
• energyConsumption字段的allOf写法逻辑错误：allOf用于组合多个Schema做交集校验，同时塞入所有基础类型等于要求字段同时满足6种类型约束，永远无法通过校验。多类型取值需要用oneOf/anyOf声明。

所有自定义Schema必须放在OpenAPI根节点的components/schemas路径下（OpenAPI 2.0/Swagger 2.0对应definitions路径），引用时填写对应节点的相对路径即可。
以下是可直接运行的配置示例：

openapi: 3.0.3 # 替换为你实际使用的OpenAPI版本
info:
  title: 你的API名称
  version: 1.0.0
paths: {} # 原有路由配置保留在该节点下
components:
  schemas:
    # 单个坐标点结构（对象格式）
    Coordinate:
      type: object
      required:
        - longitude
        - latitude
      properties:
        longitude:
          type: number
          description: 经度
          minimum: -180
          maximum: 180
        latitude:
          type: number
          description: 纬度
          minimum: -90
          maximum: 90
    # 设施信息结构
    Facility:
      type: object
      properties:
        id:
          type: integer
          description: 设施ID
        name:
          type: string
          description: 设施名称
        # 多坐标点集合，对应你需要的多点返回格式
        coordinates:
          type: array
          description: 设施关联坐标点集合
          items:
            $ref: '#/components/schemas/Coordinate'
        address:
          type: string
          description: 设施地址
        energyConsumption:
          description: 能耗数据，支持多类型取值
          oneOf:
            - type: string
            - type: integer
            - type: boolean
            - type: number
            - type: array
            - type: object

• 如果你需要返回数字元组格式的坐标（比如[[123, 123], [2144123, 123444]]），只需要把Coordinate的定义替换为元组结构即可：

Coordinate:
  type: array
  description: 坐标点，固定格式为[经度, 纬度]
  items:
    type: number
  minItems: 2
  maxItems: 2

• Date类时间类型不需要自定义结构，直接使用内置格式即可：
  • 日期（YYYY-MM-DD）：type: string, format: date
  • 日期时间（RFC3339格式）：type: string, format: date-time
• 如果你使用OpenAPI 3.1+版本，多类型字段可以直接简写为type: ["string", "integer", "boolean", "number", "array", "object"]，不需要写oneOf。
• 编写YAML时保持同一层级缩进一致，禁止混用空格和Tab，避免解析异常。

内容的提问来源于stack exchange，提问作者ethan2000liu