REC API - lpfmWide - LPFM Wide Area Search

Return to API main page

Description

This API conducts up to 360 LPFM channel searches within a block of 22.8 minutes of latitude and longitude centered around the target location at 1.2 minute increments.  REC uses this tool to drive availability maps to assist LPFM stations seeking changes to a different location.  Options include the ability to notch out the existing LPFM station's facility ID, the ability to return only points within a specific distance (such as 11.2 km for minor moves) and the ability to limit the results to channels that are considered a minor change if a channel is also specified.

The distance separation requirements for this API are based on the §§ 73.807 and 73.825 rules for LPFM (formerly LP-100) stations.   The API will automatically adjust the distance separation requirements if the target site is located in Puerto Rico or the United States Virgin Islands.

This API is considered closed data and is only available to those with a specific client relationship with REC to access the APIs. 

For demonstration purposes and to encourage development, queries in the state of North Dakota can be ran without subscription and API key.

Please note: Depdning on where this API is used, it could result in a very large JSON file and could impact JavaScript-based viewers such as the Swagger interface.  As we suggested on Swagger, to test this API there, you should set minor to Y and dist to 5.6, especially if you are using the North Dakota demo area.

Endpoint

GET https://recnet.net/api/chanRpt  JSON

Evaluation

https://app.swaggerhub.com/apis-docs/recnet/chanRpt/1.0.0#/broadcast/lpf...

Parameters

key hex(32) required except for demo in North Dakota.

API key provided by REC Networks.
lat decimal required

Latitude of the target site.  This is NAD83 datum in decimal form.  South latitude (American Samoa) is a negative number.
lon decimal required

Longitude of the target site. This is NAD83 datum in decimal form. West longitude (all areas except Guam & CNMI) is a negative number.
chan int required if minor is Y

Channel number to check at target site.  (numeric between 201~300).
notch int optional

A FCC facility ID that will not be considered in the search.  Only one facility can be notched.
minor char(1) required if channel has a value

Y to limit availability results to points where channels that are considered "minor", pursuant to §73.870(a) are available.  This includes co-channel, first-adjacent, second-ajacent, third-adjacent and intermediate frequency channels only.
dist decimal optional

Limits results only to points within a specific distance from the target in kilometers.

Return

HTTP Code 200

point

id int

Sequential count of points starting at 0.
lat decimal

NAD83 latitude of point location being evaluated.
lon decimal

NAD83 longitude of point location being evaluated.
distance decimal

Distnace in kilometers from the target to the point location.
availableChannels int

Number of overall channels available for LP100 service.
interferenceChannels int

Number of avaiilableChannels that do not meet the §73.807 recommendations for interference free service.
waiverChannels int

Number of availableChannels that do not meet the §73.807 minimum distance separation for second-adjacent channels thus needing a waiver to be used.
channelSix int

Number of availableChannels within the reserved band (88.1~91.9, Channels 201~220) that do not meet the §73.825 minimum distance separation towards TV Channel 6 facilities thus requiring either letter of consent from the TV Channel 6 station licensee or a contour study, pursuant to §74.1205 to demonstrate a lack of contour overlap.
channel schema

Details about each channel available at this point.  See  channel schema below.

channel

number int

Channel number designation (200~300).
frequency decimal

Channel frequency in megahertz (87.9~107.9).
interference varchar(3)

yes - channel does not meet the §73.807 recommendations for interference free service.
no - channel does meet the §73.807 recommendations for interference free service.
waiver varchar(3)

yes - channel does not meet the §73.807 minimum distance separation for second-adjacent channels thus needing a waiver to be used.
no - channel does meet the §73.807 minimum distance separation for second-adjacent channels thus needing a waiver to be used.
tvSix varchar(3)

yes - channel within the reserved band (88.1~91.9, Channels 201~220) that does not meet the §73.825 minimum distance separation towards TV Channel 6 facilities.
no - channel within the reserved band (88.1~91.9, Channels 201~220) that does meet the §73.825 minimum distance separation towards TV Channel 6 facilities.

Rate Limiting

The general rate limit for unauthenticated accesses across all REC APIs is 20 calls per minute (one call every 3 seconds).  Calls to other REC non-API services subject to rate limiting also contribute to this count.  These other services may have lower rate limits.  For authenticated users, the rate limit will be based on negotiations with REC Networks for API access.