openapi: 3.2.0
info:
  title: FCC Contours Haat API
  description: 'The FCC Enterprise Contours API provides broadcast radio and television service area data. Includes coverage contours for FM and TV stations by call sign, Facility ID, or ApplicationID, plus elevation, Height Above Average Terrain (HAAT), antenna patterns, coordinate conversion, and distance-curve calculations. All endpoints are free with no authentication required.

    '
  version: 1.5.0
  contact:
    name: Federal Communications Commission
    url: https://geo.fcc.gov/api/contours/
  license:
    name: FCC API Terms of Service
    url: https://www.fcc.gov/reports-research/developers/api-terms-service
servers:
- url: https://geo.fcc.gov/api/contours
  description: FCC Contours API
tags:
- name: haat
  description: Get Height Above Average Terrain (HAAT) data
paths:
  /haat.json:
    get:
      tags:
      - haat
      operationId: getHAAT
      summary: Get Height Above Average Terrain (HAAT)
      description: 'Calculate the Height Above Average Terrain (HAAT) for a given location, number of radials, and radiation center height.

        '
      parameters:
      - name: lat
        in: query
        required: true
        description: Latitude in decimal degrees
        schema:
          type: number
          format: double
      - name: lon
        in: query
        required: true
        description: Longitude in decimal degrees
        schema:
          type: number
          format: double
      - name: nradial
        in: query
        required: false
        description: Number of radials (default 360)
        schema:
          type: integer
      - name: rcamsl
        in: query
        required: false
        description: Radiation Center Above Mean Sea Level (meters)
        schema:
          type: number
          format: double
      - name: src
        in: query
        required: false
        description: Elevation data source
        schema:
          type: string
          enum:
          - ned_1
          - ned_2
          - globe30
      - name: unit
        in: query
        required: false
        description: 'Unit of measurement: m=meters (default), mi=miles, ft=feet'
        schema:
          type: string
          enum:
          - m
          - mi
          - ft
          default: m
      responses:
        '200':
          description: HAAT calculation result
          content:
            application/json:
              schema:
                type: object