Category: Uncategorized

DESCRIPTION

The Earth Networks ENCast City 10 Day‐Night Forecast Feed provides a descriptive day and night period forecast covering the next 10 days. The day period of the forecast is considered to be 7am‐7pm local time, while the night period of the forecast is considered to be the hours straddling the date change from 7 pm to 7 am local time. This forecast will be available for 2.6 million cities across the entire globe and will be available in multiple languages.

REQUEST URL

REQUEST PARAMETERS

REQUEST HEADERS

Description:

The hourly forecast call provides hourly forecast data by lat/long. The data itself is updated once an hour at around 20 minutes after the hour. The forecast includes a description of the conditions for that hour. The description will be translated into additional languages according to the culture passed in.

Request URL:

Limitations:

The latitude and longitude location type will only provide data if there is a city within 40 miles of the latitude and longitude requested.

Request parameters:

Optional parameters:

Request headers:

Description:

The AirQuality feed provides Air Quality Index and discussion data for a city or a lat/long.

Request URL:

Request parameters:

Optional parameters:

Request headers:

For displaying map tiles over Google Maps you must first make a Google Account and get an API Key from the Google API Console (https://developers.google.com/maps/documentation/javascript/get-api-key). After the API Key is obtained you can use the following approach for displaying the tiles:

1) Load the Google Maps Javascript API, substitute YOUR_API_KEY in the code below with your API key:

2) Get current time slot value t from metadata call (the subscriptionKey key variable is your Earth Networks subscription key)

var t;
var subscriptionKey;

    var json = (function() {
        var json = null;
        $.ajax({
           'async': false,
           'global': false,
            'url': "https://earthnetworks.azure-api.net/maps/overlays/v2/metadata?lid=Radar.NA.LoAlt&subscription-key=" + subscriptionKey,
            'dataType': "json",
            'success': function(data) {
                json = data;
            }
        });
        return json;
    })();
    t = json.Result.LatestSlot;

3) Initiate the map with the following code where the t variable is the current time slot value got from metadata call

function initMap() {
   var map = new google.maps.Map(document.getElementById('map'), {
        zoom: 6,
        center: { lat: 37.514938, lng: -99.337306 }
   });
   var imageMapType = new google.maps.ImageMapType({
        getTileUrl: function (coord, zoom) {
            return "https://earthnetworks.azure-api.net/maps/overlays/tile?x=" + coord.x + "&y=" + coord.y + "&z=" + zoom + "&t=" + t + "&lid=pulserad&epsg=3857&subscription-key=" + subscriptionKey
        },
        tileSize: new google.maps.Size(256, 256)
   });
   map.overlayMapTypes.push(imageMapType);
}

Description:

The location search provides the details for a single specific station similar to station list.

Request URL:

Request parameters:

Optional parameters:

Request headers:

Description:

Radar and Maps provides URLs for Satellite, Radar, and Temperature maps as well as other various images of the United States, Puerto Rico and the Virgin Islands.

Maps can be provided in standard (373×272) size or enlarged (640×480) size. Earth Networks provides the capability for end users to navigate between maps (traveling N, S, E, W), and to zoom in and out between local, regional, and national maps. Navigation XML can be optionally added to provide a way to create an interface for your users to pan and zoom throughout the maps.

An animation option allows for a number of time-sequential images to be returned. Cycling through these images provides for a small animation loop. Note that images should be used in the same order as they are returned in the XML. Radar and Maps provide specific information for the given zip code or city code RequestType “RadarAndMaps” or 5.

Request URL:

Request parameters:

Optionaly required parameters:

Optional parameters:

Request headers:

Description:

The Earth Networks Observation Data Feed will provide you with a set of current condition data based on the location or station id requested. For Location the logic is in place to always return the best observation for the location requested based on age, distance and accuracy. For station id the logic is to always return observations for that station id.

Request URL for latitudelongitude:

Request URL for stationid:

Request parameters:

Optional parameters:

Request headers:

Description:

The Earth Networks Observation Data Feed will provide you with a set of current condition data based on the location or station id requested. For Location the logic is in place to always return the best observation for the location requested based on age, distance and accuracy. For station id the logic is to always return observations for that station id.

Request URL:

v3 Parameters for Latitude/Longitude:

Request parameters:

Optional parameters:

Request headers:

v3 Parameters for StationId:

Request parameters:

Optional parameters:

Request headers:

Observation Variables:

The table below outlines the Observation variables contained within the Observation data feed. It also defines the units, format, min/max values, and precision for each variable.

Please note that extensive quality control measures of the data will be implemented to ensure that data values are reasonable. While rare, it is possible that data may occasionally be missing in the Observation Data Feed. If the data is missing, it will be saved as “Null”. A null space is defined as being this: Null = ‘ ‘.

Description:

The Earth Networks Observation Data Feed will provide you with a set of current condition data based on the location or station id requested. For Location the logic is in place to always return the best observation for the location requested based on age, distance and accuracy. For station id the logic is to always return observations for that station id.

Request URL for latitudelongitude:

Request URL for stationid:

Request parameters:

Optional parameters:

Request headers:

Description:

The stations call provides access to the station list and allows for the entry of optional parameters to make a bounding box to get a list of stations within that area.

Request URL:

Request parameters:

Optional parameters:

Request headers:

Description:

This call returns a complete set of icons listed in order of icon code (for either lunar or forecast, by request). When providing Icons for depicting sky cover for current conditions the response shall check the local sunrise/sunset time in order to determine whether to return a day or night conditions icon value.

Request URL:

Request parameters:

Request headers:

Description:

This call returns a complete set of icons listed in order of icon code (for either lunar or forecast, by request). When providing Earth Networks icons for depicting sky cover for current conditions the response shall check the local sunrise/sunset time in order to determine whether to return a day or night conditions icon value.

Request URL:

Request parameters:

Request headers:

Desciption:

The stations call provides access to the entire station list. You should only use stations with a provider ID of 3, 4, 10 or 17. Adds optional display flag to allow manual setting to determine whether or not to use the station data.

3 = Earth Networks
4 = METAR
10 = CMAN
17 = SYNOP

Request URL:

Request headers:

Description:

Sunrise and Sunset provides accurate sunrise and sunset times based on latitude and longitude. Default behavior when optional parameters NumDays, ShowSunrise and ShowSunset are omitted is to display both sunrise and sunset data for seven days beginning with the current day.

Request URL:

Request parameters:

Optional parameters:

Request headers:

Limitations:

Days must be < = 10

Description:

The UV feed provides UV Index data for a lat/long

Request URL:

Request parameters:

Optional parameters:

Request headers:

Description:

The Alerts request provides up-to-the-minute NWS US weather alerts. Only currently active alerts are returned based on the LatLong entered.

Dangerous Thunderstorm Alert is a part of US Alert API and it is a proprietary and more granular alert than the National Weather Service.

Request URL:

Request parameters:

Optional parameters:

Request headers: