StormGeo Web API
Urls
Use your application key to generate an API key. The key is valid 24 hours. Append "auth=[API key]" to all urls in the API
Use your application key to generate an API key. The key is valid 24 hours. Append "auth=[API key]" to all urls in the API
/api/v1/jsonp/places/?q={q}&wildcard={wildcard}
returns
PlacesResource
/api/v1/places/?q={q}&countries={countries}&count={count}
returns
PlacesResource
/api/v1/jsonp/places/?q={q}&countries={countries}&count={count}
returns
PlacesResource
/api/v1/places/{lat}/{lon}?haccuracy={haccuracy}
returns
PlacesResource
/api/v1/jsonp/places/{lat}/{lon}?haccuracy={haccuracy}
returns
PlacesResource
/api/v1/jsonp/long-term-forecast/{lat}/{lon}?days={days}
returns
LongTermForecast
Get nearest observation to the given point. Observation is null if no station is nearby.
/api/v1/jsonp/observations/{lat}/{lon}
returns
Observation
Get nearest observation to the given point. Observation is null if no station is nearby.
Get nearest observation to the given place. Observation is null if no station is nearby.
/api/v1/jsonp/observations/{placeId}
returns
Observation
Get nearest observation to the given place. Observation is null if no station is nearby.
/api/v1/radarinfo/{lat}/{lon}
/api/v1/jsonp/radarinfo/{lat}/{lon}
/api/v1/radarinfo/{placeId}
/api/v1/jsonp/radarinfo/{placeId}
/api/v1/jsonp/now-forecast/{placeId}
returns
NowForecast
/api/v1/city-list-forecast/{placeIds}
/api/v1/jsonp/city-list-forecast/{placeIds}
/api/v1/jsonp/now-forecast/{lat}/{lon}
returns
NowForecast
/api/v1/nowcasting/{placeId}
/api/v1/jsonp/nowcasting/{placeId}
/api/v1/nowcasting/{lat}/{lon}
/api/v1/jsonp/nowcasting/{lat}/{lon}
/api/v1/pollenmessage/{location}
/api/v1/jsonp/pollenmessage/{location}
/api/v1/pollenmessage/{location}/{pollenKind}
/api/v1/jsonp/pollenmessage/{location}/{pollenKind}
/api/v1/pollenmessage/{location}/{pollenKind}/{Day}
/api/v1/jsonp/pollenmessage/{location}/{pollenKind}/{Day}
/api/v1/tides/{placeId}?days={days}
/api/v1/jsonp/tides/{placeId}?days={days}
Json entities
LongTermForecasts structure
LongTermForecast structure
{ |
Location |
Location |
|
Days |
DayInfo[] |
|
HasRadar |
Boolean |
|
} |
LongTermForecastDetailed structure
{ |
Location |
Location |
|
Days |
DayInfoDetailed[] |
|
HasRadar |
Boolean |
|
} |
ShortTermForecast structure
DayInfo structure
{ |
Day |
DayWeather |
|
OneHourSteps |
Weather[] |
One hour steps for given date. Will only be available for the three first days for a long term forecast |
SixHourSteps |
Weather[] |
Four steps available each day |
} |
Weather structure
{ |
ForecastTime |
Date |
|
WindDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wind is blowing FROM. |
WindSpeed |
Number |
m/s |
WindGust |
Number |
m/s |
Temperature |
Number |
Temperature (default is Celsius) |
StartDate |
Date |
Start of interval |
EndDate |
Date |
End of interval |
PrecProb |
Number |
Probability of precipitation |
ApparentTemperature |
Number |
Apparent temperature (celsius) |
Humidity |
Number |
|
WindBarbSymbol |
String |
Id of a wind barb symbol. No wind will give the value "no_symbol" |
ThunderRiskIndex |
Number |
Thunder Risk Index from 0 - 6. Use 1-4: none/low risk, 5: medium risk, 6: high risk |
WaveHeight |
Number |
Wave height |
WaveDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wave is going FROM. |
VisibilityMeters |
Number |
How far is possible to see. |
} |
HourWeather structure
{ |
Prec01 |
Number |
Mm. From one hour before forecast time. |
Symbol01 |
Number |
This hour |
StartDate |
Date |
|
EndDate |
Date |
|
ForecastTime |
Date |
|
WindDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wind is blowing FROM. |
WindSpeed |
Number |
m/s |
WindGust |
Number |
m/s |
Temperature |
Number |
Temperature (default is Celsius) |
PrecProb |
Number |
Probability of precipitation |
ApparentTemperature |
Number |
Apparent temperature (celsius) |
Humidity |
Number |
|
WindBarbSymbol |
String |
Id of a wind barb symbol. No wind will give the value "no_symbol" |
ThunderRiskIndex |
Number |
Thunder Risk Index from 0 - 6. Use 1-4: none/low risk, 5: medium risk, 6: high risk |
WaveHeight |
Number |
Wave height |
WaveDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wave is going FROM. |
VisibilityMeters |
Number |
How far is possible to see. |
} |
SixHourWeather structure
{ |
Symbol |
Number |
3 hrs before, 3hrs after forecast |
Prec06x |
Number |
Mm. 3 hours before, 3 hours after forecast time. |
StartDate |
Date |
|
EndDate |
Date |
|
ForecastTime |
Date |
|
WindDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wind is blowing FROM. |
WindSpeed |
Number |
m/s |
WindGust |
Number |
m/s |
Temperature |
Number |
Temperature (default is Celsius) |
PrecProb |
Number |
Probability of precipitation |
ApparentTemperature |
Number |
Apparent temperature (celsius) |
Humidity |
Number |
|
WindBarbSymbol |
String |
Id of a wind barb symbol. No wind will give the value "no_symbol" |
ThunderRiskIndex |
Number |
Thunder Risk Index from 0 - 6. Use 1-4: none/low risk, 5: medium risk, 6: high risk |
WaveHeight |
Number |
Wave height |
WaveDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wave is going FROM. |
VisibilityMeters |
Number |
How far is possible to see. |
} |
DayWeather structure
{ |
ForecastTimeIndicator |
Date |
This is just an indicator, and no assumptions should be made about this date. |
TemperatureMin |
Number |
Temperature might be null |
TemperatureMax |
Number |
Temperature might be null |
SunUp |
Date |
SunUp might be null |
SunDown |
Date |
SunDown might be null |
UvLevel |
Number |
UV index calculated with 0 reflectivity (albedo) and taking the cloud cover into consideration. A textual representation can be extracted using the following mapping: 0 - 2.5 is "low", 2.5 - 5.5 is "moderate", 5.5 - 7.5 is "high", 7.5 - 10.5 is "very high", else it's "extreme" |
Symbol |
Number |
|
ApparentTemperatureMin |
Number |
|
ApparentTemperatureMax |
Number |
|
WindSpeedMin |
Number |
|
WindSpeedMax |
Number |
|
WindGustMin |
Number |
|
WindGustMax |
Number |
|
HumidityMin |
Number |
|
HumidityMax |
Number |
|
ThunderRiskIndexMax |
Number |
|
SymbolExtended |
Number |
|
} |
PlacesResource structure
{ |
Places |
Array of Place |
|
} |
Place structure
{ |
PlaceId |
String |
|
PlaceName |
String |
|
LocalName |
String |
|
Latitude |
Number |
|
Longitude |
Number |
|
Moh |
Number |
|
CountryId |
Number |
|
CategoryId |
Number |
|
CategoryName |
String |
|
Country |
String |
|
Priority |
Number |
|
Adm1 |
String |
|
Adm2 |
String |
|
} |
PopularPlacesResource structure
{ |
Places |
Array of Place |
|
} |
PopularPlace structure
{ |
PlaceId |
Number |
|
Name |
String |
|
Country |
String |
|
Adm1 |
String |
|
Adm2 |
String |
|
} |
Location structure
{ |
Latitude |
Number |
|
Longitude |
Number |
|
System |
Number |
|
} |
Warning structure
{ |
ValidDate |
Date |
The day this warning is valid |
Number |
Number |
Symbol id for this warning |
} |
WarningResource structure
ClimateResource structure
{ |
Climate |
Array of Climate |
|
} |
WeatherListResource structure
PlaceWeather structure
SimpleDayForecast structure
BasicPlacesResource structure
{ |
Places |
Array of BasicPlace |
|
} |
MetaInformation structure
UvResource structure
Uv structure
{ |
ValidTime |
Date |
|
Reflection |
Decimal |
|
CloudCover |
Number |
|
UvIndex |
Decimal |
|
} |
BorealisResource structure
Borealis structure
{ |
Index |
Number |
|
UpdateTime |
Date |
|
Text |
String |
|
} |
ObservationResource structure
ObservationSeries structure
InstantWeather structure
{ |
Symbol01 |
Number |
This hour |
StartDate |
Date |
|
EndDate |
Date |
|
ForecastTime |
Date |
|
WindDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wind is blowing FROM. |
WindSpeed |
Number |
m/s |
WindGust |
Number |
m/s |
Temperature |
Number |
Temperature (default is Celsius) |
PrecProb |
Number |
Probability of precipitation |
ApparentTemperature |
Number |
Apparent temperature (celsius) |
Humidity |
Number |
|
WindBarbSymbol |
String |
Id of a wind barb symbol. No wind will give the value "no_symbol" |
ThunderRiskIndex |
Number |
Thunder Risk Index from 0 - 6. Use 1-4: none/low risk, 5: medium risk, 6: high risk |
WaveHeight |
Number |
Wave height |
WaveDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wave is going FROM. |
VisibilityMeters |
Number |
How far is possible to see. |
} |
AuthenticationResource structure
{ |
Key |
String |
API key. The key is valid for 24 hours |
} |
Observation structure
{ |
StationName |
String |
|
Height |
Number |
|
Latitude |
Number |
|
Longitude |
Number |
|
Location |
Location |
|
ObservationTime |
Date |
|
Symbol |
Number |
|
WindDirection |
Number |
360 degrees. North is 0 degrees. Oriented clockwise. Orientation is where the wind is blowing FROM. |
WindSpeed |
Number |
Wind Speed (default unit is m/s) |
Temperature |
Number |
Temperature (default is unit is c) |
} |
NowForecast structure
TopObservationsResource structure
TopObsList structure
{ |
TopObsListType |
TopObsType |
type of list 0=Hot, 1=Cold, 2=Wet, 3=Windy |
TopObsListItems |
Array of TopObsEntry |
|
} |
TopObsEntry structure
{ |
Id |
String |
Synop or metar ID |
Displayname |
String |
Name of the measuring station |
Latitude |
Number |
|
Longitude |
Number |
|
Altitude |
Number |
|
Temperature |
Number |
Measured temperature in deg celsius |
Precipication |
Number |
Precipitation in mm for 12-hour period |
Windspeed |
Number |
Windspeed in m/s |
Winddirection |
Number |
Wind direction in degrees 0-360 |
ObsTimeUTC |
Date |
Date/Time(UTC) |
LocationId |
Number |
Nearby location ID |
} |
NowcastingTextInfo structure
{ |
AnaTime |
Date |
|
ValidTime |
Date |
|
StartPrec |
Boolean |
|
StartMinutes |
Number |
|
StateChangeMinutes |
Number |
|
PrecipitationType |
Number |
0 = undefined, 1 = rain, 2 = sleet, 3 = snöw |
NowCastExpected |
Boolean |
|
} |
SkiCountryResource structure
SkiRegionResource structure
SkiCountry structure
{ |
Name |
String |
|
CountryId |
Number |
|
} |
SkiRegion structure
{ |
Name |
String |
|
RegionId |
Number |
|
} |
SkiResortResource structure
SkiResort structure
{ |
PlaceId |
Number |
|
ResortId |
Number |
|
Name |
String |
|
Depth |
Number |
centimeters |
NewSnow |
Number |
Snofall in last 48h in centimeters |
Latitude |
Number |
|
Longitude |
Number |
|
Url |
String |
|
} |
SkiWorldResource structure
SkiContinentResource structure
Continent structure
{ |
ContinentId |
Number |
|
Name |
String |
|
} |