Skip to content
This repository has been archived by the owner on Oct 26, 2023. It is now read-only.

Latest commit

 

History

History
executable file
·
418 lines (346 loc) · 11.3 KB

README.ja.md

File metadata and controls

executable file
·
418 lines (346 loc) · 11.3 KB
Raw

logo

COVID-19 Japan Web API

UpdateData LICENSE Tweet

言語

英語🇺🇸 | 日本語🇯🇵

🦠 日本の都道府県ごとのCOVID-19（コロナウイルス）情報を取得するためのWeb API

このAPIは、COVID-19に関する日本国内情報を広めるためのものです。このAPIは随時更新していますので、追加したいAPIがありましたらお知らせください。

目次

Features

  • 🔁 2時間ごとにデータを更新する
  • 🚀 REST APIを提供
  • 🇯🇵 日本の各都道府県の情報を取得
  • ☕️ シンプルなデータと使いやすさ
  • 📈 今後30日間の予測

このAPIを使用したプロジェクト

もしプロジェクトがここにリストされていない場合は、お知らせください。

使い方

このAPIのドキュメントを表示したり、こちらのリンク からPostmanコレクションとしてインポートしたりできます。

都道府県ごとのデータ(Prefectures)

※ 2020/06/18 データ構造を変更しました。新しいレスポンスを確認してください.

Endpoint: https://covid19-japan-web-api.now.sh/api/v1/prefectures

Response 
[
  {
    "id": 1,
    "name_ja": "北海道",
    "name_en": "Hokkaido",
    "lat": 43.46722222,
    "lng": 142.8277778,
    "population": 5248552,
    "last_updated": {
      "cases_date": 20200617,
      "deaths_date": 20200617,
      "pcr_date": 20200617,
      "hospitalize_date": 20200617,
      "severe_date": 20200617,
      "discharge_date": 20200617,
      "symptom_confirming_date": 20200617
    },
    "cases": 1176,
    "deaths": 91,
    "pcr": 17875,
    "hospitalize": 126,
    "severe": 10,
    "discharge": 959,
    "symptom_confirming": 0
  },
...

全国の合計(Total)

※ 2020/06/18 データ構造を変更しました。新しいレスポンスを確認してください.

このAPIには、「クルーズ船」、「検疫職員」、「チャータ便」を含んでいます。

Endpoint: https://covid19-japan-web-api.now.sh/api/v1/total

Response 
{
  "date": 20200523,
  "pcr": 272095,
  "hospitalize": 2450,
  "positive": 17248,
  "severe": 178,
  "discharge": 13895,
  "death": 821,
  "symptom_confirming": 40
}

全国の合計の履歴(Total History)

※ 2020/05/24 データ構造を変更しました。新しいレスポンスを確認してください.

このAPIには、「クルーズ船」、「検疫職員」、「チャータ便」を含んでいます。

Endpoint: https://covid19-japan-web-api.now.sh/api/v1/total?history=true

Response 
...
  {
    "date": 20200521,
    "pcr": 265190,
    "hospitalize": 2917,
    "positive": 17136,
    "severe": 199,
    "discharge": 13323,
    "death": 790,
    "symptomConfirming": 64
  },
  {
    "date": 20200522,
    "pcr": 269120,
    "hospitalize": 2652,
    "positive": 17225,
    "severe": 180,
    "discharge": 13656,
    "death": 809,
    "symptomConfirming": 66
  },
  {
    "date": 20200523,
    "pcr": 272095,
    "hospitalize": 2450,
    "positive": 17248,
    "severe": 178,
    "discharge": 13895,
    "death": 821,
    "symptomConfirming": 40
  }
]

今後の予測(Total Prediction)

機械学習に基づき、感染者および死亡者について次の30日間を予測します。

このAPIには、「クルーズ船」、「検疫職員」、「チャータ便」を含んでいます。

Endpoint: https://covid19-japan-web-api.now.sh/api/v1/total?predict=true

Response 
[
  {
    "date": 20200413,
    "positive": 6960.103502394343,
    "death": 102.8839324261669
  },
  {
    "date": 20200414,
    "positive": 7652.287257933034,
    "death": 107.84568822992809
  },
  {
    "date": 20200415,
    "positive": 8413.308833378682,
    "death": 113.04673329952118
  },
  {
    "date": 20200416,
    "positive": 9250.01416438296,
    "death": 118.49860777416443
  },
  {
    "date": 20200417,
    "positive": 10169.930016336322,
    "death": 124.21340833627379
  },
  {
    "date": 20200418,
    "positive": 11181.33169302858,
    "death": 130.2038150517223
  },
  {
    "date": 20200419,
    "positive": 12293.317478949984,
    "death": 136.4831195045177
  },
  {
    "date": 20200420,
    "positive": 13515.89048489476,
    "death": 143.06525428832322
  },
...

感染者データ(Positives)

Endpoint: https://covid19-japan-web-api.now.sh/api/v1/positives?prefecture=東京都

クエリパラメーター

  • 必須パラメーター：citizen =(jp_name): jp_nameを使用して都道府県でフィルター
Response 
[
  {
    "code": "",
    "announcement_date": "2020-01-24",
    "src": "https://www.metro.tokyo.lg.jp/tosei/hodohappyo/press/2020/01/24/20.html",
    "prefecture": "東京都",
    "residence_prefecture": "国外（武漢市）",
    "age": "40代",
    "gender": "男性",
    "attribute": "",
    "prefecture_number": "東京都1",
    "travel_or_contact": "渡航歴",
    "detail": "中国（武漢）",
    "id": "ID130001",
    "diagnosis_date": "",
    "onset": "2020/01/14",
    "symptom": "1",
    "death_or_discharge_date": "",
    "comment": "",
    "outcome": "1",
    "outcome_src": "https://i.imgur.com/P185t7C.jpg"
  },
  {
    "code": "",
    "announcement_date": "2020-01-25",
    "src": "https://www.metro.tokyo.lg.jp/tosei/hodohappyo/press/2020/01/27/24.html",
    "prefecture": "東京都",
    "residence_prefecture": "国外（武漢市）",
    "age": "30代",
    "gender": "女性",
    "attribute": "",
    "prefecture_number": "東京都2",
    "travel_or_contact": "渡航歴",
    "detail": "中国（武漢）",
    "id": "ID130002",
    "diagnosis_date": "",
    "onset": "2020/01/21",
    "symptom": "1",
    "death_or_discharge_date": "",
    "comment": "",
    "outcome": "1",
    "outcome_src": "https://i.imgur.com/P185t7C.jpg"
  },
...

感染者の統計データ

これはPositives APIの統計であり、公開されていないデータは含まれません。

Endpoint: https://covid19-japan-web-api.now.sh/api/v1/statistics

Response 
[
  {
    "name_ja": "北海道",
    "name_en": "Hokkaido",
    "total_count": 239,
    "male": {
      "count": 137,
      "generations_count": {
        "00s": 6,
        "10s": 1,
        "20s": 5,
        "30s": 8,
        "40s": 19,
        "50s": 35,
        "60s": 27,
        "70s": 19,
        "80s": 14,
        "90s": 2,
        "100s": 0,
        "unknown": 1
      }
    },
    "female": {
      "count": 100,
      "generations_count": {
        "00s": 1,
        "10s": 1,
        "20s": 14,
        "30s": 10,
        "40s": 12,
        "50s": 17,
        "60s": 15,
        "70s": 16,
        "80s": 8,
        "90s": 4,
        "100s": 0,
        "unknown": 2
      }
    },
    "unknown_gender": {
      "count": 2,
      "generations_count": {
        "00s": 0,
        "10s": 0,
        "20s": 0,
        "30s": 0,
        "40s": 0,
        "50s": 0,
        "60s": 0,
        "70s": 0,
        "80s": 0,
        "90s": 0,
        "100s": 0,
        "unknown": 2
      }
    }
  },
...

Contribution Guide

  • Lintとしてflake8を使用してください
  • /dataディレクトリをコミットに追加しないでください
  • gitflowは現在使用されていないため、masterにPullRequestしてください

Contributers

Made with contributors-img.

データソースについて

このデータはボランティアによって収集されたものであり、正確でない可能性があります。正しいデータを得るには公的機関からのレポートを参照してください。

LICENSE

MIT LICENSE