openapi: 3.2.0
info:
title: FCC Contours Profile 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: profile
description: Get terrain elevation profile between two points
paths:
/profile.json:
get:
tags:
- profile
operationId: getProfile
summary: Get Terrain Elevation Profile
description: 'Get the terrain elevation profile along a path between two geographic points, specified by a starting point plus azimuth, or start and end coordinates.
'
parameters:
- name: lat
in: query
required: true
description: Latitude of the starting point in decimal degrees
schema:
type: number
format: double
- name: lon
in: query
required: true
description: Longitude of the starting point in decimal degrees
schema:
type: number
format: double
- name: azimuth
in: query
required: false
description: Azimuth direction from the start point (degrees)
schema:
type: number
format: double
- name: start
in: query
required: false
description: Start distance along the path (km)
schema:
type: number
format: double
- name: end
in: query
required: false
description: End distance along the path (km)
schema:
type: number
format: double
- name: num_points
in: query
required: false
description: Number of elevation sample points along the profile
schema:
type: integer
- 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: Array of elevation values along the profile
content:
application/json:
schema:
type: object