PHP>> fhmi-api>> 返回
项目作者： nedzadalibegovic

项目描述 ：
RESTful API for Federal Hydrometeorological Institute
高级语言： JavaScript
项目地址: git://github.com/nedzadalibegovic/fhmi-api.git
创建时间： 2019-12-22T21:52:23Z
项目社区：https://github.com/nedzadalibegovic/fhmi-api
开源协议：
下载


RESTFul API for Federal Hydrometeorological Institute

REST API that provides weather data for nine cities in Bosnia and Herzegovina (Bihać, Banja Luka, Bugojno, Livno, Mostar, Sarajevo, Trebinje, Tuzla, Zenica). Data is provided from an XML file hosted on the Federal Hydrometeorological Institute website that is updated daily.

Data fetching functionality is provided in the fetch_data.js file.

What routes and methods do you support?

Currently supported routes and methods:

Route Supported Methods
/cities/ GET
/cities/{city_name} GET

Example API call:

  1. GET /cities/bihac
  3. {
  4.   "city": "Bihać",
  5.   "description": "pretežnooblačno",
  6.   "forecasts": [
  7.     {
  8.       "date": "2020-03-23T00:00:00.000Z",
  9.       "low": -3,
  10.       "high": 0,
  11.       "morning": "pretežno oblačno sa snijegom",
  12.       "afternoon": "pretežno oblačno sa snijegom"
  13.     },
  14.     {
  15.       "date": "2020-03-24T00:00:00.000Z",
  16.       "low": -3,
  17.       "high": 0,
  18.       "morning": "pretežno oblačno sa snijegom",
  19.       "afternoon": "pretežno oblačno sa snijegom"
  20.     },
  21.     {
  22.       "date": "2020-03-25T00:00:00.000Z",
  23.       "low": -2,
  24.       "high": 0,
  25.       "morning": "pretežno oblačno sa snijegom",
  26.       "afternoon": "susnježica"
  27.     },
  28.     {
  29.       "date": "2020-03-26T00:00:00.000Z",
  30.       "low": -1,
  31.       "high": 1,
  32.       "morning": "pretežno oblačno sa snijegom",
  33.       "afternoon": "susnježica"
  34.     }
  35.   ],
  36.   "humidity": 0.37,
  37.   "pressure": 995.6,
  38.   "temperature": 2,
  39.   "timestamp": "2020-03-23T11:07:00.000Z",
  40.   "windDirection": "N",
  41.   "windSpeed": 18
  42. }

Legend

Property Unit Note
low, high, temperature °C low - minimum temperature, high - maximum temperature, temperature - current temperature
humidity % Relative humidity
pressure hPa Atmospheric pressure on the ground level
windSpeed km/h windDirection - wind direction reported in cardinal and intercardinal directions
date, timestamp In ISO 8601 format, timestamp - date when measurments were taken
forecasts Contains 4-day forecast
description, morning, afternoon Textual weather description

How can I host it myself?

You need Node.js, MongoDB and two environment variables (check the .env_sample file), when everything is set up properly, run the data fetching service with:

  1. npm run fetch

For running the API in a dev environment, you can use:

  1. npm run dev

For running in a production environment, you can use:

  1. npm start

Check package.json to see how npm run dev and npm start differ.