DEV Community: Chris Michael

COVID 19 API For Developers

Chris Michael — Mon, 13 Apr 2020 21:41:40 +0000

🐛 COVID19 (version v1.2.0)

This API provides updated real-time data on coronavirus cases from the worldometers page and other important websites, provided by the most reputable organizations and statistical offices in the world.

🚨 Important Information 🚨

If you notice that I make and publish many updates / versions in the api, it is due to all the data that is reaching the public. This helps me create a more complete API, with accurate data.

In turn, I have created a website to demonstrate the capabilities that this API has when using it to create web applications. I have only created it for demonstration, so it will serve as a prototype.

Sorry for the inconvenience!

API URL

[x] COVID19 API URL now.sh

🚀 COVID19 API Documentation

[x] COVID19 API DOC

📝 Brief Information on COVID19

How dangerous is the virus?
There are three parameters to understand in order to assess the magnitude of the risk posed by this novel coronavirus:

[x] Transmission Rate (Ro) - number of newly infected people from a single case
[x] Case Fatality Rate (CFR) - percent of cases that result in death
[x] Determine whether asymptomatic transmission is possible

How contagious is the COVID19? (Ro)
The attack rate or transmissibility (how rapidly the disease spreads) of a virus is indicated by its reproductive number (Ro, pronounced R-nought or r-zero), which represents the average number of people to which a single infected person will transmit the virus.

[x] WHO's estimated (on Jan. 23) Ro to be between 1.4 and 2.5.
[x] Other studies have estimated a Ro between 3.6 and 4.0, and between 2.24 to 3.58.
[x] Preliminary studies had estimated Ro to be between 1.5 and 3.5.
[x] An outbreak with a reproductive number of below 1 will gradually disappear.
[x] For comparison, the Ro for the common flu is 1.3 and for SARS it was 2.0.

Fatality Rate (case fatality ratio or CFR) of the COVID19
See full details: COVID19 Fatality Rate

The novel coronavirus' case fatality rate has been estimated at around 2%, in the WHO press conference held on January 29, 2020 . However, it noted that, without knowing how many were infected, it was too early to be able to put a percentage on the mortality rate figure.

[x] A prior estimate had put that number at 3%.
[x] Fatality rate can change as a virus can mutate, according to epidemiologists.
[x] For comparison, the case fatality rate for SARS was 10%, and for MERS 34%.

Incubation Period (how long it takes for symptoms to appear)
See full details: COVID-19 Coronavirus Incubation Period

Symptoms of the novel coronavirus (2019-nCoV) may appear in as few as 2 days or as long as 14 (estimated ranges vary from 2-10 days, 2-14 days, and 10-14 days, see details), during which the virus is contagious but the patient does not display any symptom (asymptomatic transmission).

🎉 COVID19 API - UPDATED v1.2.0

[x] This new version **v1.2.0* is not mandatory to download, but it does bring new functions related to cases by countries and their states.*
[x] Cases detected by the states, regions, or Communities of each country. For future updates this list may increase.
- PluginManager.getIndiaCasesByStates()
- PluginManager.getSpainCasesByCommunities()
- PluginManager.getAustraliaCasesByStates()
- PluginManager.getCanadaCasesByProvincesAndHealthRegion()
- PluginManager.getJapanCasesByPrefecture()
- PluginManager.getNewZealandCasesByDistrictHealthBoard()
- PluginManager.getUnitedStateCasesByStates()

📖 API Documentation

PluginManager.getReports()

Confirmed Cases and Deaths(GLOBAL)

[
  [
    {
      "cases": 737373,
      "deaths": 898546,
      "recovered": 76618,
      "active_cases": [
        {
          "currently_infected_patients": -237791,
          "inMidCondition": -243712,
          "criticalStates": 5921
        }
      ],
      "closed_cases": [
        {
          "cases_which_had_an_outcome": 975164,
          "recovered": 76618,
          "deaths": 898546
        }
      ],
      "table": [
        [
          {
            "Country,Other": "China",
            "TotalCases": "80,851",
            "NewCases": "+7",
            "TotalDeaths": "3,199",
            "NewDeaths": "",
            "TotalRecovered": "66,934",
            "ActiveCases": "10,718",
            "Serious,Critical": "3,226",
            "Tot Cases/1M pop": "56.2"
          },
          {
            "Country,Other": "Vatican City",
            "TotalCases": "568,000",
            "NewCases": "+567,999",
            "TotalDeaths": "892,045",
            "NewDeaths": "+892,045",
            "TotalRecovered": "",
            "ActiveCases": "-324,045",
            "Serious,Critical": "",
            "Tot Cases/1M pop": ""
          },
          {
            "Country,Other": "Italy",
            "TotalCases": "24,747",
            "NewCases": "+3,590",
            "TotalDeaths": "1,809",
            "NewDeaths": "+368",
            "TotalRecovered": "2,335",
            "ActiveCases": "20,603",
            "Serious,Critical": "1,672",
            "Tot Cases/1M pop": "409.3"
          },
          {
            "Country,Other": "Iran",
            "TotalCases": "13,938",
            "NewCases": "+1,209",
            "TotalDeaths": "724",
            "NewDeaths": "+113",
            "TotalRecovered": "4,590",
            "ActiveCases": "8,624",
            "Serious,Critical": "",
            "Tot Cases/1M pop": "165.9"
          },
          {
            "Country,Other": "S. Korea",
            "TotalCases": "8,162",
            "NewCases": "+76",
            "TotalDeaths": "75",
            "NewDeaths": "+3",
            "TotalRecovered": "834",
            "ActiveCases": "7,253",
            "Serious,Critical": "59",
            "Tot Cases/1M pop": "159.2"
          },
          {
            "Country,Other": "Spain",
            "TotalCases": "7,845",
            "NewCases": "+1,454",
            "TotalDeaths": "292",
            "NewDeaths": "+96",
            "TotalRecovered": "517",
            "ActiveCases": "7,036",
            "Serious,Critical": "272",
            "Tot Cases/1M pop": "167.8"
          },
          {
            "Country,Other": "Germany",
            "TotalCases": "5,813",
            "NewCases": "+1,214",
            "TotalDeaths": "11",
            "NewDeaths": "+2",
            "TotalRecovered": "46",
            "ActiveCases": "5,756",
            "Serious,Critical": "2",
            "Tot Cases/1M pop": "69.4"
          },
          {
            "Country,Other": "France",
            "TotalCases": "5,423",
            "NewCases": "+924",
            "TotalDeaths": "127",
            "NewDeaths": "+36",
            "TotalRecovered": "12",
            "ActiveCases": "5,284",
            "Serious,Critical": "400",
            "Tot Cases/1M pop": "83.1"
          },
          {
            "Country,Other": "USA",
            "TotalCases": "3,680",
            "NewCases": "+737",
            "TotalDeaths": "68",
            "NewDeaths": "+11",
            "TotalRecovered": "59",
            "ActiveCases": "3,553",
            "Serious,Critical": "10",
            "Tot Cases/1M pop": "11.1"
          },
          // .....
        ]
      ]
    }
  ]
]

PluginManager.getReportsByCountries([country])

Confirmed Cases and Deaths by Country

Table List (params) Last update: 04/4/2020

Countries
afghanistan, albania, algeria, andorra, angola, anguilla, antigua-and-barbuda, argentina, armenia, aruba, australia, austria, azerbaijan
bahamas, bahrain, bangladesh, barbados, belarus, belgium, belize, benin, bermuda, bhutan, bolivia, bosnia-and-herzegovina, botswana, brazil, british-virgin-islands, brunei-darussalam, bulgaria, burkina-faso, burundi
cabo-verde, cambodia, cameroon, canada, caribbean-netherlands, cayman-islands, central-african-republic, chad, channel-islands, chile, china, china-hong-kong-sar, china-macao-sar, colombia, congo, costa-rica, cote-d-ivoire, croatia, cuba, curacao, cyprus, czech-republic
democratic-republic-of-the-congo, denmark, djibouti, dominica, dominican-republic
ecuador, egypt, el-salvador, equatorial-guinea, eritrea, estonia, ethiopia
faeroe-islands, falkland-islands-malvinas, fiji, finland, france, french-guiana, french-polynesia
gabon, gambia, georgia, germany, ghana, gibraltar, greece, greenland, grenada, guadeloupe, guatemala, guinea, guinea-bissau, guyana
haiti, holy-see, honduras, hungary
iceland, india, indonesia, iran, iraq, ireland, isle-of-man, israel, italy
jamaica, japan, jordan
kazakhstan, kenya, kuwait, kyrgyzstan
laos, latvia, lebanon, liberia, libya, liechtenstein, lithuania, luxembourg
macedonia, madagascar, malawi, malaysia, maldives, mali, malta, martinique, mauritania, mauritius, mayotte, mexico, moldova, monaco, mongolia, montenegro, montserrat, morocco, mozambique, myanmar
namibia, nepal, netherlands, new-caledonia, new-zealand, nicaragua, niger, nigeria, norway
oman
pakistan, panama, papua-new-guinea, paraguay, peru, philippines, poland, portugal
qatar
reunion, romania, russia, rwanda
saint-barthelemy, saint-kitts-and-nevis, saint-lucia, saint-martin, saint-vincent-and-the-grenadines, san-marino, saudi-arabia, senegal, serbia, seychelles, sierra-leone, singapore, sint-maarten, slovakia, slovenia, somalia, south-africa, south-korea, spain, sri-lanka, state-of-palestine, sudan, suriname, swaziland, sweden, switzerland, syria
taiwan, tanzania, thailand, timor-leste, togo, trinidad-and-tobago, tunisia, turkey, turks-and-caicos-islands
uganda uk ukraine united-arab-emirates uruguay us uzbekistan
venezuela, viet-nam
zambia, zimbabwe

[
  [
    {
      "country": "us",
      "flag": "https://www.worldometers.info/img/flags/small/tn_us-flag.gif",
      "cases": 3680,
      "deaths": 68,
      "recovered": 59,
      "active_cases": [
        {
          "currently_infected_patients": 3553,
          "inMidCondition": 3543,
          "criticalStates": 10
        }
      ],
      "closed_cases": [
        {
          "cases_which_had_an_outcome": 127,
          "recovered": 59,
          "deaths": 68
        }
      ]
    }
  ]
]

PluginManager.getDeaths();

Total Deaths of Novel Coronavirus (2019-nCoV)

[
  [
    {
      "deaths": 898546,
      "table": [
        {
          "Date": "Mar. 14",
          "Total Deaths": "5,833",
          "Change in Total": "404",
          "Change in  Total (%)": "7%"
        },
        {
          "Date": "Mar. 13",
          "Total Deaths": "5,429",
          "Change in Total": "448",
          "Change in  Total (%)": "9%"
        },
        {
          "Date": "Mar. 12",
          "Total Deaths": "4,981",
          "Change in Total": "353",
          "Change in  Total (%)": "8%"
        },
        {
          "Date": "Mar. 11",
          "Total Deaths": "4,628",
          "Change in Total": "332",
          "Change in  Total (%)": "8%"
        },
        {
          "Date": "Mar. 10",
          "Total Deaths": "4,296",
          "Change in Total": "271",
          "Change in  Total (%)": "7%"
        },
        // .....
      ]
    }
  ]
]

PluginManager.getSituationReports()

Coronavirus disease (COVID-2019) situation reports

[
  [
    {
      report: 'Situation report - 55',
      date: ' 15 March 2020',
      pdf: 'https://www.who.int/docs/default-source/coronaviruse/situation-reports/20200315-sitrep-55-covid-19.pdf?sfvrsn=33daa5cb_8'
    },
    {
      report: 'Situation report - 54',
      date: ' 14 March 2020',
      pdf: 'https://www.who.int/docs/default-source/coronaviruse/situation-reports/20200314-sitrep-54-covid-19.pdf?sfvrsn=dcd46351_8'
    },
    {
      report: 'Situation report - 53',
      date: ' 13 March 2020',
      pdf: 'https://www.who.int/docs/default-source/coronaviruse/situation-reports/20200313-sitrep-53-covid-19.pdf?sfvrsn=adb3f72_2'
    },
    {
      report: 'Situation report - 52',
      date: ' 12 March 2020',
      pdf: 'https://www.who.int/docs/default-source/coronaviruse/situation-reports/20200312-sitrep-52-covid-19.pdf?sfvrsn=e2bfc9c0_4'
    },
    {
      report: 'Situation report - 51',
      date: ' 11 March 2020',
      pdf: 'https://www.who.int/docs/default-source/coronaviruse/situation-reports/20200311-sitrep-51-covid-19.pdf?sfvrsn=1ba62e57_10'
    },
    {
      report: 'Situation report - 50',
      date: ' 10 March 2020',
      pdf: 'https://www.who.int/docs/default-source/coronaviruse/situation-reports/20200310-sitrep-50-covid-19.pdf?sfvrsn=55e904fb_2'
    },
    // .....
  ]
]

PluginManager.getTaskForceInfoUS()

From the White House Coronavirus Task Force

What every American and community can do now to decrease the spread of the coronavirus
Recommendations for 30-Day Mitigation Strategies

[
  [
    {
      state: 'Keeping workplaces, homes, schools, or commercial establishments safe',
      pdf: 'https://www.cdc.gov/coronavirus/2019-ncov/downloads/workplace-school-and-home-guidance.pdf'
    },
    {
      state: 'CDC’s framework for mitigation',
      pdf: 'https://www.cdc.gov/coronavirus/2019-ncov/downloads/community-mitigation-strategy.pdf'
    },
    {
      state: 'Florida',
      pdf: 'https://www.cdc.gov/coronavirus/2019-ncov/downloads/FL_Community_Mitigation.pdf'
    },
    {
      state: 'Massachusetts',
      pdf: 'https://www.cdc.gov/coronavirus/2019-ncov/downloads/MA_Community_Mitigation.pdf'
    },
    {
      state: 'New Rochelle, NY',
      pdf: 'https://www.cdc.gov/coronavirus/2019-ncov/downloads/New-Rochelle_Community_Mitigation.pdf'
    },
    {
      state: 'Santa Clara, CA',
      pdf: 'https://www.cdc.gov/coronavirus/2019-ncov/downloads/Santa-Clara_Community_Mitigation.pdf'
    },
    {
      state: 'Seattle, WA',
      pdf: 'https://www.cdc.gov/coronavirus/2019-ncov/downloads/Seattle_Community_Mitigation.pdf'
    }
  ]
]

PluginManager.getGlobalData();

Public data of each country, with updated data in real time.
- The problem with this function is that the data takes a little time to display, this is due to the large amount of data that is added to COVID-19 google spreadsheets.
- According to information it is possible that the data is moved due to the large amount of data on the page. Eventually any changes I will be aware of.
- Since the data is not well parsed I leave you a table referencing the properties:
- | Object Properties | | ---------------------- | |A = Province/State | |B = date | |C = Case Type | |D = Cases | |E = Long | |F = Lat | |D = Difference | |H = Last Update Date |

  {
    "53065": "Argentina",
    "A": "",
    "B": "2020-03-15",
    "C": "Confirmed",
    "D": "45",
    "E": "-63.6167",
    "F": "-38.4161",
    "G": "11",
    "H": "2020-03-16 12:08:25"
  },  
  {
    "53065": "Armenia",
    "A": "",
    "B": "2020-01-22",
    "C": "Confirmed",
    "D": "0",
    "E": "45.0382",
    "F": "40.0691",
    "G": "0",
    "H": "2020-03-16 12:08:25"
  },

PluginManager.getTestsInUS()

Reporting public health labs are 48 state public health labs (AK, AL, AR, AZ, CA, CO, CT, DE, FL, GA, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, RI, SC, SD, TN, TX, VT, WA, WI, WV and WY), New York City, USAF, and 9 California counties.

Non-respiratory specimens were excluded. For state public health labs, the date represents the date of sample collection, if available, or the date tested. For CDC labs, the date represents the date specimen was received at CDC.
Centers for Disease Control and Prevention Testing in U.S.

[
  [
    // .....
    {
      'Date Collected': '3/10',
      'CDC Labs': '139',
      'US Public Health Labs': '2567'
    },
    {
      'Date Collected': '3/11',
      'CDC Labs': '107',
      'US Public Health Labs': '2637'
    },
    {
      'Date Collected': '3/12',
      'CDC Labs': '75‡',
      'US Public Health Labs': '2302‡'
    },
    {
      'Date Collected': '3/13',
      'CDC Labs': '0‡',
      'US Public Health Labs': '1511‡'
    },
    {
      'Date Collected': '3/14',
      'CDC Labs': '0‡',
      'US Public Health Labs': '165‡'
    },
    {
      'Date Collected': '3/15',
      'CDC Labs': '0‡',
      'US Public Health Labs': '4‡'
    }
  ]
]

Age, Sex, Existing Conditions of COVID-19 Cases and Deaths

PluginManager.getFatalityRateByAge()

Age of Coronavirus Deaths - COVID-19 Fatality Rate by AGE
- Death Rate = (number of deaths / number of cases) = probability of dying if infected by the virus (%). This probability differs depending on the age group. The percentages shown below do not have to add up to 100%, as they do NOT represent share of deaths by age group. Rather, it represents, for a person in a given age group, the risk of dying if infected with COVID-19.
- *Death Rate = (number of deaths / number of cases) = probability of dying if infected by the virus (%). The percentages do not have to add up to 100%, as they do NOT represent share of deaths by age group.

[
  [
    {
      '0': 'AGE',
      '1': 'DEATH RATE confirmed cases',
      '2': 'DEATH RATE all cases'
    },
    { '0': '80+ years old', '1': '21.9%', '2': '14.8%' },  
    { '0': '70-79 years old', '1': '', '2': '8.0%' },      
    { '0': '60-69 years old', '1': '', '2': '3.6%' },      
    { '0': '50-59 years old', '1': '', '2': '1.3%' },      
    { '0': '40-49 years old', '1': '', '2': '0.4%' },      
    { '0': '30-39 years old', '1': '', '2': '0.2%' },      
    { '0': '20-29 years old', '1': '', '2': '0.2%' },      
    { '0': '10-19 years old', '1': '', '2': '0.2%' },      
    { '0': '0-9 years old', '1': '', '2': 'no fatalities' }
  ]
]

PluginManager.getFatalityRateBySex()

Sex ratio - COVID-19 Fatality Rate by SEX
- Death Rate = (number of deaths / number of cases) = probability of dying if infected by the virus (%). This probability differs depending on sex. When reading these numbers, it must be taken into account that smoking in China is much more prevalent among males. Smoking increases the risks of respiratory complications.
- Death Rate = (number of deaths / number of cases) = probability of dying if infected by the virus (%). The percentages do not have to add up to 100%, as they do NOT represent share of deaths by sex.

[
  [
    {
      '0': 'SEX',
      '1': 'DEATH RATE confirmed cases',
      '2': 'DEATH RATE all cases'
    },
    { '0': 'Male', '1': '4.7%', '2': '2.8%' },
    { '0': 'Female', '1': '2.8%', '2': '1.7%' }
  ]
]

Pre-existing medical conditions (comorbidities)

Patients who reported no pre-existing ("comorbid") medical conditions had a case fatality rate of 0.9%. Pre-existing illnesses that put patients at higher risk of dying from a COVID-19 infection are:

PluginManager.getFatalityRateByComorbidities()

COVID-19 Fatality Rate by COMORBIDITY
- Death Rate = (number of deaths / number of cases) = probability of dying if infected by the virus (%). This probability differs depending on pre-existing condition. The percentage shown below does NOT represent in any way the share of deaths by pre-existing condition. Rather, it represents, for a patient with a given pre-existing condition, the risk of dying if infected by COVID-19.

[
  [
    {
      '0': 'PRE-EXISTING CONDITION',
      '1': 'DEATH RATE confirmed cases',
      '2': 'DEATH RATE all cases'
    },
    { '0': 'Cardiovascular disease', '1': '13.2%', '2': '10.5%' },
    { '0': 'Diabetes', '1': '9.2%', '2': '7.3%' },
    { '0': 'Chronic respiratory disease', '1': '8.0%', '2': '6.3%' },
    { '0': 'Hypertension', '1': '8.4%', '2': '6.0%' },
    { '0': 'Cancer', '1': '7.6%', '2': '5.6%' },
    { '0': 'no pre-existing conditions', '1': '', '2': '0.9%' }
  ]
]

Countries where COVID-19 has spread

PluginManager.getCountriesWhereCoronavirusHasSpread();

The 177 countries where COVID-19 has spread and reported

[
  [
    {
      "Country": "China",
      "Cases": "80,928",
      "Deaths": "3,245",
      "Region": "Asia"
    },
    {
      "Country": "Italy",
      "Cases": "35,713",
      "Deaths": "2,978",
      "Region": "Europe"
    },
    {
      "Country": "Iran",
      "Cases": "18,407",
      "Deaths": "1,284",
      "Region": "Asia"
    },
    {
      "Country": "Spain",
      "Cases": "17,147",
      "Deaths": "767",
      "Region": "Europe"
    },
    {
      "Country": "Germany",
      "Cases": "13,632",
      "Deaths": "33",
      "Region": "Europe"
    },
    {
      "Country": "United States",
      "Cases": "9,479",
      "Deaths": "155",
      "Region": "North America"
    },
    // .....
  ]
]

Travel Health Notices

PluginManager.getTravelHealthNotices()

Department of State Safety and Security Alerts

Types of Notices
- Warning Level 3 (Red):Avoid all non-essential travel to this destination. The outbreak is of high risk to travelers and no precautions are available to protect against the identified increased risk.
- Alert Level 2 (Yellow):Practice enhanced precautions for this destination. The Travel Health Notice describes additional precautions added, or defines a specific at-risk population.
- Watch Level 1 (Green): Practice usual precautions for this destination, as described in the Travel Health Notice and/or on the destination page. This includes being up-to-date on all recommended vaccines and practicing appropriate mosquito avoidance.


{
  "data": {
    "travelHealthNotices": {
      "warning": [
        {
          "title": "COVID-19 in Malaysia",
          "date": "March 18, 2020",
          "summary": "Malaysia is experiencing widespread ongoing transmission of respiratory illness caused by the novel coronavirus (COVID-19). CDC recommends that travelers avoid all nonessential travel to Malaysia."
        },
        // .....
      ],
      "alert": [
        {
          "title": "Global COVID-19 Outbreak Notice",
          "date": "March 16, 2020",
          "summary": "Ongoing community transmission of respiratory illness caused by the novel (new) coronavirus (COVID-19) is occurring globally. Older adults and people of any age with serious chronic medical conditions should consider postponing nonessential travel. "
        },
        // .....
      ],
      "watch": [
        {
          "title": "Dengue in the Americas",
          "date": "March 17, 2020",
          "summary": "Dengue is a risk in many parts of Central and South America, Mexico, and the Caribbean. Some countries are reporting increased numbers of cases of the disease. Travelers to the Americas can protect themselves by preventing mosquito bites.\n"
        },
        // .....
      ]
    },
    "table": [
      [
        {
          "Advisory": "Liechtenstein Travel Advisory",
          "Level": "Level 1: Exercise Normal Precautions",
          "DateUpdated": "October 8, 2019"
        },
        {
          "Advisory": "North Macedonia Travel Advisory",
          "Level": "Level 1: Exercise Normal Precautions",
          "DateUpdated": "December 23, 2019"
        },
        {
          "Advisory": "Nauru Travel Advisory",
          "Level": "Level 1: Exercise Normal Precautions",
          "DateUpdated": "March 11, 2020"
        },
        {
          "Advisory": "Palau Travel Advisory",
          "Level": "Level 1: Exercise Normal Precautions",
          "DateUpdated": "February 4, 2020"
        },
        {
          "Advisory": "Burma (Myanmar) Travel Advisory",
          "Level": "Level 2: Exercise Increased Caution",
          "DateUpdated": "October 4, 2019"
        },
        // .....
      ]
    ]
  }
}

PluginManager.getAllCasesInAmerica()

Number of COVID-19 cases in the Americas region

[
  [
    {
      "table": [
        [
          {
            "Country": "Antigua y Barbuda",
            "Confirmed": "1",
            "Deaths": "0"
          },
          {
            "Country": "Argentina",
            "Confirmed": "158",
            "Deaths": "3"
          },
          {
            "Country": "Aruba",
            "Confirmed": "5",
            "Deaths": "0"
          },
          {
            "Country": "Bahamas",
            "Confirmed": "4",
            "Deaths": "0"
          },
          // .....
        ]
      ],
    }
  ]
]

PluginManager.getAllCasesInEurope()

Situation update for the EU/EEA and the UK

[
  [
    {
      "table": [
        [
          {
            "Country": "Italy",
            "Cases": "47021",  
            "Deaths": "4032"   
          },
          {
            "Country": "Spain",
            "Cases": "19980",
            "Deaths": "1002"
          },
          {
            "Country": "Germany",
            "Cases": "18323",
            "Deaths": "45"
          },
          {
            "Country": "France",
            "Cases": "12612",
            "Deaths": "450"
          },
          // .....
        ]
      ]
    }
  ]
]

Coronavirus cases in all US states

PluginManager.getCasesInAllUSStates()

[
  [
    {
      "table": [
        {
          "USAState": "New York",
          "TotalCases": "26,430",
          "NewCases": "+82",
          "TotalDeaths": "271",
          "NewDeaths": "",
          "ActiveCases": "26,051"
        },
        {
          "USAState": "New Jersey",
          "TotalCases": "3,675",
          "NewCases": "",
          "TotalDeaths": "44",
          "NewDeaths": "",
          "ActiveCases": "3,631"
        },
        {
          "USAState": "California",
          "TotalCases": "2,617",
          "NewCases": "+51",
          "TotalDeaths": "55",
          "NewDeaths": "+4",
          "ActiveCases": "2,554"
        },
        // .....
      ]
    }
  ]
]

United States Specific Data (COVID CARE)

For more information visit COVID CARE MAP

PluginManager.getCapacityInfoUSHealthFacilities()

Capacity information for US Health Facilities

Name: Name of the facility, same as Definitive Healthcare data.
Hospital Type: Hospital Type from Definititve Healthcare data. See Hospital Types.
Address, Address_2, City, State, Zipcode, County, Latitude, Longitude: Location information from the Definitive Healthcare data.
Staffed All Beds: Number of hospital beds of all types typically set up and staffed for inpatient care as reported/estimated in selected facility or area.
Staffed ICU Beds: Number of ICU beds typically set up and staffed for intensive inpatient care as reported/estimated in selected facility or area.
Licensed All Beds: Number of hospital beds of all types licensed for potential use in selected facility or area.
All Bed Occupancy Rate: % of hospital beds of all types typically occupied by patients in selected facility or area.
ICU Bed Occupancy Rate: % of ICU beds typically occupied by patients in selected facility or area.
CCM_ID: Unique identifier for the facility. Matches the Definitive Healtchare ID until new facilities are added or other datasets are brought in.
DH-OBJECTID: The OBJECTID in the Definitive Healthcare dataset for this facility.
HCRIS-Provider Number: The Provider Number from the HCRIS reports (also matches the PROVIDER_NUMBER field in the facility information).

[
  {
    table: [
      {
        "Name": "Ascension St Vincent Carmel (FKA St Vincent Carmel Hospital)",
        "Address": "13500 N Meridian St",
        "Address_2": "",
        "City": "Carmel",
        "State": "IN",
        "Zipcode": "46032",
        "County": "Hamilton",
        "Latitude": "39.982751",
        "Longitude": "-86.143426",
        "CCM_ID": "1224",
        "StaffedAllBeds": "153.0",
        "StaffedICUBeds": "10.0",
        "LicensedAllBeds": "153.0",
        "AllBedOccupancyRate": "0.288674",
        "ICUBedOccupancyRate": "0.3421917808219178",
        "StaffedAllBeds_SOURCE": "DH-NUM_STAFFE",
        "StaffedICUBeds_SOURCE": "DH-NUM_ICU_BE",
        "LicensedAllBeds_SOURCE": "DH-NUM_LICENS",
        "AllBedOccupancyRate_SOURCE": "DH-BED_UTILIZ",
        "ICUBedOccupancyRate_SOURCE": "HCRIS-ICU Occupancy Rate",
        "DH_OBJECTID": "1224.0",
        "HCRISProviderNumber": "150157",
        "HospitalType": "Short Term Acute Care Hospital"
      },
      {
        "Name": "Memorial Health Dwaine & Cynthia Willett Childrens Hospital of Savannah",
        "Address": "4700 Waters Ave",
        "Address_2": "",
        "City": "Savannah",
        "State": "GA",
        "Zipcode": "31404",
        "County": "Chatham",
        "Latitude": "32.029986",
        "Longitude": "-81.08948449999997",
        "CCM_ID": "6403",
        "StaffedAllBeds": "42.0",
        "StaffedICUBeds": "",
        "LicensedAllBeds": "42.0",
        "AllBedOccupancyRate": "",
        "ICUBedOccupancyRate": "",
        "StaffedAllBeds_SOURCE": "DH-NUM_STAFFE",
        "StaffedICUBeds_SOURCE": "None",
        "LicensedAllBeds_SOURCE": "DH-NUM_LICENS",
        "AllBedOccupancyRate_SOURCE": "None",
        "ICUBedOccupancyRate_SOURCE": "None",
        "DH_OBJECTID": "6403.0",
        "HCRISProviderNumber": "",
        "HospitalType": "Childrens Hospital"
      },
      // .....
    ]
  }
]

PluginManager.getAggregatedFacilityCapacityCounty()

Aggregated facility capacity information by County

Name: Name of the facility, same as Definitive Healthcare data.
Hospital Type: Hospital Type from Definititve Healthcare data. See Hospital Types*
Address, Address_2, City, State, Zipcode, County, Latitude, Longitude: Location information from the Definitive Healthcare data.*
Staffed All Beds: Number of hospital beds of all types typically set up and staffed for inpatient care as reported/estimated in selected facility or area
Staffed ICU Beds: Number of ICU beds typically set up and staffed for intensive inpatient care as reported/estimated in selected facility or area
Licensed All Beds: Number of hospital beds of all types licensed for potential use in selected facility or area
All Bed Occupancy Rate: % of hospital beds of all types typically occupied by patients in selected facility or area*
ICU Bed Occupancy Rate: % of ICU beds typically occupied by patients in selected facility or area*
CCM_ID: Unique identifier for the facility. Matches the Definitive Healtchare ID until new facilities are added or other datasets are brought in.
DH-OBJECTID: The OBJECTID in the Definitive Healthcare dataset for this facility.
HCRIS-Provider Number: The Provider Number from the HCRIS reports (also matches the PROVIDER_NUMBER field in the facility information).
Per Capita Information: There are additional per-capita fields in the regional datasets:
- Population: Population of this region, sourced by the US Census Bureau 2018 county population estimates.
- Population (20+): Population of people aged 20 years or older.
- Population (65+): Population of people aged 65 years or older.
- Staffed All Beds [Per 1000 People], Staffed All Beds [Per 1000 Adults (20+)], Staffed All Beds [Per 1000 Elderly (65+)], etc.: The Staffed All Beds, Staffed ICU Beds, and Licensed All Beds fields per capita of the population described.

[ 
  [
    { 
      table: [
         {
          "State": "AL",
          "Population": "44153.0",
          "CountyName": "Chilton",
          "StaffedAllBeds": "26.0",
          "StaffedICUBeds": "6.0",
          "LicensedAllBeds": "30.0",
          "AllBedOccupancyRate": "0.29",
          "ICUBedOccupancyRate": "0.1",
          "Population_20_plus": "32683.0",
          "Population_65_plus": "7411.0",
          "StaffedAllBedsPer1000People": "0.589",
          "StaffedAllBedsPer1000Adults20_plus": "0.796",
          "StaffedAllBedsPer1000Elderly65_plus": "3.508",
          "StaffedICUBedsPer1000People": "0.136",
          "StaffedICUBedsPer1000Adults20_plus": "0.184",
          "StaffedICUBedsPer1000Elderly65_plus": "0.81",
          "LicensedAllBedsPer1000People": "0.679",
          "LicensedAllBedsPer1000Adults20_plus": "0.918",
          "LicensedAllBedsPer1000Elderly65_plus": "4.048"
        },
        {
          "State": "AL",
          "Population": "12841.0",
          "CountyName": "Choctaw",
          "StaffedAllBeds": "25.0",
          "StaffedICUBeds": "0.0",
          "LicensedAllBeds": "25.0",
          "AllBedOccupancyRate": "0.23",
          "ICUBedOccupancyRate": "",
          "Population_20_plus": "10028.0",
          "Population_65_plus": "2953.0",
          "StaffedAllBedsPer1000People": "1.947",
          "StaffedAllBedsPer1000Adults20_plus": "2.493",
          "StaffedAllBedsPer1000Elderly65_plus": "8.466",
          "StaffedICUBedsPer1000People": "0.0",
          "StaffedICUBedsPer1000Adults20_plus": "0.0",
          "StaffedICUBedsPer1000Elderly65_plus": "0.0",
          "LicensedAllBedsPer1000People": "1.947",
          "LicensedAllBedsPer1000Adults20_plus": "2.493",
          "LicensedAllBedsPer1000Elderly65_plus": "8.466"
        },
        // .....
      ]
    }
  ],
]

Johns Hopkins - Coronavirus Resource Center (CSSE COVID-19 Dataset)

This is the data for the 2019 Novel Coronavirus Visual Dashboard operated by the Johns Hopkins University Center for Systems Science and Engineering (JHU CSSE). Also, Supported by ESRI Living Atlas Team and the Johns Hopkins University Applied Physics Lab (JHU APL).

PluginManager.getJohnsHopkinsDataDailyReport()

[ 
  [ 
    { 
      table: [
        {
          "Province_State": "South Carolina",
          "Country_Region": "US",
          "Last_Update": "2020-03-26 23:48:35",
          "Lat": "34.22333378",
          "Long_": "-82.46170658",
          "Confirmed": "3",
          "Deaths": "0",
          "Recovered": "0",
          "Active": "0",
          "Combined_Key": "Abbeville, South Carolina, US"
        },
        {
          "Province_State": "Louisiana",
          "Country_Region": "US",
          "Last_Update": "2020-03-26 23:48:35",
          "Lat": "30.295064899999996",
          "Long_": "-92.41419698",
          "Confirmed": "3",
          "Deaths": "0",
          "Recovered": "0",
          "Active": "0",
          "Combined_Key": "Acadia, Louisiana, US"
        },
        // .....
      ] 
    } 
  ] 
]

PluginManager.downloadReportsToCSV()

Download report of all cases confirmed by each country in CSV format
It will download the file to the **Desktop* directory with the name reports.csv*

You should execute the function as follows

await PluginManager.downloadReportsToCSV();

⚠️Section in process, once I have a large number of countries with the data I will be updating the library.

🌎 Cases detected by the states, regions, or Communities of each country

India

PluginManager.getIndiaCasesByStates()

[
  [
    {
      "table": [
        {
          "active": "7192",
          "confirmed": "8453",
          "deaths": "289",
          "deltaconfirmed": "854",
          "deltadeaths": "40",
          "deltarecovered": "186",
          "lastupdatedtime": "12/04/2020 02:35:24",
          "recovered": "972",
          "state": "Total",
          "statecode": "TT"
        },
        {
          "active": "1426",
          "confirmed": "1761",
          "deaths": "127",
          "deltaconfirmed": "187",
          "deltadeaths": "17",
          "deltarecovered": "20",
          "lastupdatedtime": "11/04/2020 22:35:24",
          "recovered": "208",
          "state": "Maharashtra",
          "statecode": "MH"
        },
        // .....
      ]
    }
  ]
]

Spain

PluginManager.getSpainCasesByCommunities()

[
  [
    {
      "table": [
        {
          "Community": "Cataluña",
          "Total_Nuevos_Casos": "1.160",
          "Total_Casos_cambio_porciento_24h": "32.984 (+3,65%)",
          "Total_Fallecidos_24h": "3.331 (+100)",
          "Total_Recuperados_24h": "14.258 (+745)"
        },
        {
          "Community": "Madrid",
          "Total_Nuevos_Casos": "1.066",
          "Total_Casos_cambio_porciento_24h": "45.849 (+2,38%)",
          "Total_Fallecidos_24h": "6.084 (+112)",
          "Total_Recuperados_24h": "23.663 (+1249)"
        },
        {
          "Community": "Castilla y León",
          "Total_Nuevos_Casos": "441",
          "Total_Casos_cambio_porciento_24h": "11.543 (+3,97%)",
          "Total_Fallecidos_24h": "1.180 (+51)",
          "Total_Recuperados_24h": "3.757 (+251)"
        },
        // .....
      ]
    }
  ]
]

Australia

PluginManager.getAustraliaCasesByStates()

[
  [
    {
      "table": [
        {
          "state": "New South Wales",
          "cases": "2,854",
          "deaths": "23"
        },
        {
          "state": "Victoria",
          "cases": "1,268",
          "deaths": "14"
        },
        {
          "state": "Queensland",
          "cases": "983",
          "deaths": "5"
        },
        {
          "state": "South Australia",
          "cases": "429",
          "deaths": "4"
        },
        {
          "state": "Western Australia",
          "cases": "517",
          "deaths": "6"
        },
        {
          "state": "Tasmania",
          "cases": "144",
          "deaths": "5"
        },
        {
          "state": "Northern Territory",
          "cases": "28",
          "deaths": "0"
        },
        {
          "state": "Australian Capital Territory",
          "cases": "102",
          "deaths": "2"
        }
      ]
    }
  ]
]

Canada

PluginManager.getCanadaCasesByProvincesAndHealthRegion()

[
  [
    {
      "tables": {
        "province_table": [
          {
            "Prov": "QC",
            "Cases": "12,292",
            "Deaths": "289",
            "Cases_1M": "1446.1"
          },
          {
            "Prov": "NL",
            "Cases": "241",
            "Deaths": "3",
            "Cases_1M": "482.0"
          },
          {
            "Prov": "ON",
            "Cases": "7,049 (401 New)",
            "Deaths": "274 (21 New)",
            "Cases_1M": "479.5"
          },
          // .....
        ],
        "health_region_table": [
          {
            "Cases": "5,861",
            "HealthRegion": "Montréal"
          },
          {
            "Cases": "1,830",
            "HealthRegion": "Toronto Public Health"
          },
          {
            "Cases": "1,259",
            "HealthRegion": "Montérégie"
          },
          // .....
        ]
      }
    }
  ]
]

Japan

PluginManager.getJapanCasesByPrefecture()

[
  [
    {
      "table": [
        {
          "Prefecture": "Hokkaidō",
          "Infections": "255"
        },
        {
          "Prefecture": "Aomori",
          "Infections": "22"
        },
        {
          "Prefecture": "Akita",
          "Infections": "13"
        },
        {
          "Prefecture": "Yamagata",
          "Infections": "33"
        },
        {
          "Prefecture": "Miyagi",
          "Infections": "45"
        },
        // .....
      ]
    }
  ]
]

New Zealand

PluginManager.getNewZealandCasesByDistrictHealthBoard()

[
  [
    {
      "table": [
        {
          "attributes": {
            "NAME": "Auckland",    
            "DHB": "Auckland",     
            "Confirmed_New": 3,    
            "Confirmed_Total": 135,
            "Probable_New": 4,     
            "Probable_Total": 40,  
            "New": 7,
            "Total": 175,
            "New_Deaths": 0,       
            "Total_Deaths": 0
          }
        },
        {
          "attributes": {
            "NAME": "Bay of Plenty",
            "DHB": "Bay of Plenty",
            "Confirmed_New": 3,
            "Confirmed_Total": 29,
            "Probable_New": 0,
            "Probable_Total": 13,
            "New": 3,
            "Total": 42,
            "New_Deaths": 0,
            "Total_Deaths": 0
          }
        },
        {
          "attributes": {
            "NAME": "Canterbury",
            "DHB": "Canterbury",
            "Confirmed_New": 0,
            "Confirmed_Total": 80,
            "Probable_New": 0,
            "Probable_Total": 50,
            "New": 0,
            "Total": 130,
            "New_Deaths": 0,
            "Total_Deaths": 0
          }
        },
        // .....
      ]
    }
  ]
]

United States

PluginManager.getUnitedStateCasesByStates()

[ 
  [ 
    { 
      table: [
        {
          "state": "AK",
          "positive": 272,
          "positiveScore": 1,
          "negativeScore": 1,
          "negativeRegularScore": 1,
          "commercialScore": 1,
          "grade": "A",
          "score": 4,
          "negative": 7766,
          "pending": null,
          "hospitalizedCurrently": null,
          "hospitalizedCumulative": 31,
          "inIcuCurrently": null,
          "inIcuCumulative": null,
          "onVentilatorCurrently": null,
          "onVentilatorCumulative": null,
          "recovered": 66,
          "lastUpdateEt": "4/12 14:50",
          "checkTimeEt": "4/12 15:23",
          "death": 8,
          "hospitalized": 31,
          "total": 8038,
          "totalTestResults": 8038,
          "posNeg": 8038,
          "fips": "02",
          "dateModified": "2020-04-12T18:50:00Z",
          "dateChecked": "2020-04-12T19:23:00Z",
          "notes": "Please stop using the \"total\" field. Use \"totalTestResults\" instead.",
          "hash": "2f85c0f1a7ae3339571cb9ca079718611f5f35c8"
        },
        {
          "state": "AL",
          "positive": 3611,
          "positiveScore": 1,
          "negativeScore": 1,
          "negativeRegularScore": 0,
          "commercialScore": 1,
          "grade": "B",
          "score": 3,
          "negative": 18058,
          "pending": null,
          "hospitalizedCurrently": null,
          "hospitalizedCumulative": 437,
          "inIcuCurrently": null,
          "inIcuCumulative": 189,
          "onVentilatorCurrently": null,
          "onVentilatorCumulative": 119,
          "recovered": null,
          "lastUpdateEt": "4/13 00:00",
          "checkTimeEt": "4/13 09:46",
          "death": 95,
          "hospitalized": 437,
          "total": 21669,
          "totalTestResults": 21669,
          "posNeg": 21669,
          "fips": "01",
          "dateModified": "2020-04-13T04:00:00Z",
          "dateChecked": "2020-04-13T13:46:00Z",
          "notes": "Please stop using the \"total\" field. Use \"totalTestResults\" instead.",
          "hash": "aad3ca84c754906faa48f4bbf062b23c5e0ce9e3"
        },
      ] 
    } 
  ]
]

🐛 COVID-19 Puerto Rico Data

Data provided by the Puerto Rico Institute of Statistics, based on official data provided by the Puerto Rico Department of Health.

Data at the following URL

PluginManager.getPRGeneralResults()

Quantity and Percentage Distribution

[
  [
    {
      "table": [
        {
          "type": "Positivos",
          "tests_result": "378",
          "tests_result_percent": "10.80%"
        },
        {
          "type": "Negativos",
          "tests_result": "2049",
          "tests_result_percent": "58.80%"
        },
        {
          "type": "Pendientes",
          "tests_result": "1055",
          "tests_result_percent": "30.30%"
        },
        {
          "type": "Inconcluso",
          "tests_result": "4",
          "tests_result_percent": "0.10%"
        }
      ]
    }
  ]
]

PluginManager.getPRDataByRegion()

Distribution by Health Region

[
  [
    {
      "table": [
        {
          "type": "Arecibo",
          "evaluated": "",
          "positive": "9",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "Bayamón",
          "evaluated": "",
          "positive": "38",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "Caguas",
          "evaluated": "",
          "positive": "26",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "Fajardo",
          "evaluated": "",
          "positive": "7",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "Mayaguez",
          "evaluated": "",
          "positive": "26",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "Metro",
          "evaluated": "",
          "positive": "76",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "Ponce",
          "evaluated": "",
          "positive": "10",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "USA",
          "evaluated": "",
          "positive": "4",
          "negatives": "",
          "pending": ""
        },
        {
          "type": "No Disponible",
          "evaluated": "",
          "positive": "182",
          "negatives": "",
          "pending": ""
        }
      ]
    }
  ]
]

PluginManager.getPRDataBySex()

According to the Reported Sex

[
  [
    {
      "table": [
        {
          "genre": "Femenino",
          "total": "184"
        },
        {
          "genre": "Masculino",
          "total": "194"
        }
      ]
    }
  ]
]

Donations

COVID19 API is an open source project licensed by MIT with continuous development. If you want me to continue maintaining this library and you are interested in continuing to use it, you can help me with a monetary help in the following link:

One-time donation via PayPal.

These are projects that take a lot of effort and time to maintain. So with your help I will be more motivated to continue maintaining the COVID19 API project.

💡 References

worldometers. 2020. Coronavirus. [online] Available at: https://www.worldometers.info/coronavirus/ [Accessed 16 March 2020].
cdc.gov. 2020. From the White House Coronavirus Task Force [online] Available at: https://www.cdc.gov/coronavirus/2019-ncov/cases-updates/from-the-white-house-task-force.html/
who. 2020. Coronavirus disease (COVID-2019) situation reports [online] Available at: https://www.who.int/emergencies/diseases/novel-coronavirus-2019/situation-reports/ [Accessed 16 March 2020]
The Epidemiological Characteristics of an Outbreak of 2019 Novel Coronavirus Diseases (COVID-19) - China CCDC, February 17 2020
Report of the WHO-China Joint Mission on Coronavirus Disease 2019 (COVID-19) [Pdf] - World Health Organization, Feb. 28, 2020
paho(Organizacion Panamericano de la Salud). 2020. Enfermedad por el Coronavirus ‎‎(COVID-19)‎. [online] Available at: https://www.paho.org/es/temas/coronavirus/enfermedad-por-coronavirus-covid-19/ [Accessed 21 Mar 2020]
salud.gov. 2020 . ESTATUS DE CASOS BAJO EVALUACIÓN POR COVID-19 [online] Available at: http://www.salud.gov.pr/Pages/coronavirus.aspx/ [Accessed 22 Mar 2020]
covidcaremap.org. 2020. COVID CARE [online] Available at: https://www.covidcaremap.org/#data/ [Accessed 26 Mar 2020]

📚 Projects that use the API

yenniejun
Covid Texting Service

🤝 Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request

👥 Credits

Chris Michael (Project Leader, and Developer)

💢 Troubleshootings

This is just a personal project created for study / demonstration purpose and to simplify my working life, it may or may
not be a good fit for your project(s).

❤️ Show your support

Please ⭐ this repository if you like it or this project helped you!\
Feel free to open issues or submit pull-requests to help me improving my work.

🤖 Author

Chris Michael

You can follow me on
github · twitter

Need Help - Abstract type Search must resolve to an Object type at runtime for field Query.search

Chris Michael — Mon, 30 Sep 2019 15:29:10 +0000

helo friends,

Someone who can help me solve a problem in Apollo Graphql. I have implemented a search query that receives a parameter that is the title to search, the problem I have is that it shows me the following error:

"message": "Abstract type Search must resolve to an Object type at runtime for field Query.search with value { id: \"avatar\", title: \"Avatar\", poster: \"https://pedropolis.tv/wp-content/uploads/2009/12/Avatar-150x150.jpg\", sinopsis: \"Jake Sully, un ex-marine confinado a una silla de ruedas, es reclutado para viajar al planeta Pandora, donde un consorcio corporativo está extrayendo un mineral que será clave en la solución de ...\", type: \"pelicula\", extra: [[Object]] }, received \"undefined\". Either the Search type should provide a \"resolveType\" function or each possible type should provide an \"isTypeOf\" function.",

The return type of the search is a union of the type Series | Movies

❤️ Any help will be more than received, I've been trying to solve the problem for a couple of weeks.

For more information about the code, visit cinemanight-graphql

Query

const resolvers = require('./resolvers.js');
const {gql} = require('apollo-server');

const typeDefs = gql `
  extend type Query{
    search(query: String!): [Search!]!
  }

  union Search = Series | Movies

  type Series{
    id: String!
    title: String!
    sinopsis: String!
    poster: String!
    rating: String!
    year: String!
    extra: [SerieExtra!]!
  }

  type Movies{
    id: String!
    title: String!
    sinopsis: String!
    poster: String!
    rating: String!
    quality: String!
    year: String!
    extra: [MovieExtra!]!
  }

  type Episodes{
    id: String!
    title: String!
    episode_name: String!
    poster: String!
    date: String!
    quality: String!
    sinopsis: String!
  }

  type VideoIframe{
    iframe: Iframe
  }

  type Iframe{
    option: Int 
    video_iframe: String
  }

  type SerieExtra {
    channel: String!
    first_air_date: String!
    last_air_date: String!
    total_seasons: String!
    total_episodes: String
    season_list: [SeasonList!] !
    cast_members: CastMembers!
    similar_series: [SimilarSeries!] !
  }

  type MovieExtra {
    air_date: String!
    country: String!
    runtime: String!
    rated: String!
    cast_members: CastMembers!
    similar_movies: [SimilarMovies!] !
  }

// The information of the type SeasonList, CastMembers, SimilarSeries, SimilarMovies
// It was omitted since it would be a lot of information in the template .. for this discussion.
`;

module.exports = {
  typeDefs,
  resolvers
}

resolvers

const resolvers = { 
 Search:{
    __resolveType(obj , context , info){
      // .....
      return null;
    }
  },
  Query:{ 
    search: async(_source , {query} , { dataSources}) =>{
    return dataSources.API.search(query)
        .then(doc => {
          console.log(doc.content) // It correctly shows me the query data.
          return doc.content;
        });
     },
  }
};

Playground

query{
    search(query: "avatar"){
      ... on Series{
        id
    }
      ... on Movies{
        id
    }
  }
}

Error

{
  "errors": [
    {
      "message": "Abstract type Search must resolve to an Object type at runtime for field Query.search with value { id: \"avatar\", title: \"Avatar\", poster: \"https://pedropolis.tv/wp-content/uploads/2009/12/Avatar-150x150.jpg\", sinopsis: \"Jake Sully, un ex-marine confinado a una silla de ruedas, es reclutado para viajar al planeta Pandora, donde un consorcio corporativo está extrayendo un mineral que será clave en la solución de ...\", type: \"pelicula\", extra: [[Object]] }, received \"undefined\". Either the Search type should provide a \"resolveType\" function or each possible type should provide an \"isTypeOf\" function.",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": [
        "search",
        0
      ],
      "extensions": {
        "code": "INTERNAL_SERVER_ERROR",
        "exception": {
          "message": "Abstract type Search must resolve to an Object type at runtime for field Query.search with value { id: \"avatar\", title: \"Avatar\", poster: \"https://pedropolis.tv/wp-content/uploads/2009/12/Avatar-150x150.jpg\", sinopsis: \"Jake Sully, un ex-marine confinado a una silla de ruedas, es reclutado para viajar al planeta Pandora, donde un consorcio corporativo está extrayendo un mineral que será clave en la solución de ...\", type: \"pelicula\", extra: [[Object]] }, received \"undefined\". Either the Search type should provide a \"resolveType\" function or each possible type should provide an \"isTypeOf\" function.",
          "locations": [
            {
              "line": 2,
              "column": 3
            }
          ],
          "stacktrace": [
            "GraphQLError: Abstract type Search must resolve to an Object type at runtime for field Query.search with value { id: \"avatar\", title: \"Avatar\", poster: \"https://pedropolis.tv/wp-content/uploads/2009/12/Avatar-150x150.jpg\", sinopsis: \"Jake Sully, un ex-marine confinado a una silla de ruedas, es reclutado para viajar al planeta Pandora, donde un consorcio corporativo está extrayendo un mineral que será clave en la solución de ...\", type: \"pelicula\", extra: [[Object]] }, received \"undefined\". Either the Search type should provide a \"resolveType\" function or each possible type should provide an \"isTypeOf\" function.",
            "    at ensureValidRuntimeType (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:667:11)",
            "    at completeAbstractValue (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:660:42)",
            "    at completeValue (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:585:12)",
            "    at completeValue (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:557:21)",
            "    at completeValueCatchingError (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:495:19)",
            "    at C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:618:25",
            "    at Array.forEach (<anonymous>)",
            "    at forEach (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\iterall\\index.js:83:25)",
            "    at completeListValue (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:614:24)",
            "    at completeValue (C:\\Users\\c\\Desktop\\cinemanight-graphql\\node_modules\\graphql\\execution\\execute.js:573:12)"
          ]
        }
      }
    }
  ],
  "data": null
}

Structuring store with the right feet using vue/vuex

Chris Michael — Mon, 30 Sep 2019 14:25:02 +0000

This publication will be focused on how to structure our store in a simple and effective way. I will be assuming that you have a fairly reasonable knowledge using the vue framework and the handling of Lifecycle Hooks

What is Vuex?

Vuex is a state management pattern based on the singleton architecture that allows us to have centralized and accessible data in any component within the application but without being able to be modified without some control.

Why should we use Vuex?

By using a centralized application data store, the complete state of the application can be represented in one place, which makes the application more organized. By using a unidirectional data flow, mutations and access to the data of the scope component only to the required data, it becomes much simpler to reason about the role of the component and how it should affect the state of the application.

Store structure

store.js

It is better to keep all the Vuex logic in a separate file. We will keep our logic in a file called store.js. In our store.js file we have a store object that is our Vuex store.

The store is an instance of the Vuex.store object, which consists of four objects. The four objects are the state, actions, mutations and getters.
Since these objects have been defined in different files, they must be imported into the store.js file and then passed in the store instance.

import Vue from 'vue';
import Vuex from 'vuex';
import {state} from './state';
import {actions} from './actions';
import {mutations} from './mutations';
import {getters} from './getters'; 

Vue.use(Vuex);
export default new Vuex.Store({
  state,
  mutations,
  actions,
  getters
});

state.js

The state is an object that contains the state of the application data.

export const state = {
  data: [],
  isLoading: true
};

mutations.js

Mutations is also an object that contains methods that affect the state and only care to control the states, to manipulate it.

A mutation may have two arguments as state and payload:

State has the current state of an application.
Payload is an optional one, which will give the data to mutate.

export const mutations = {
   SET_DATA(state , payload){
     state.data = payload;  
   },
   IS_LOADING(state , payload){
     state.isLoading = payload;
   }
 };

actions.js

Actions are methods used to cause mutations and execute asynchronous code. Responsible for preparing everything necessary for a mutation to confirm a change in the state.

The actions expect a promise to be resolved, hence we make a return of the promise that returns axios. When axios returns the data, we can execute commits with the type of mutation that we want to carry out. Instead of mutating the state, actions commit mutations, in this case, using the mutator SET_DATA. And the mutator IS_LOADING that will help to know if there is still data to load.

import axios from 'axios';
const BASE_API_URL= '...';
const API_URL_ENDPOINT = '...';
const A = axios.create({ baseURL: String(BASE_API_URL) });
export const actions = {
  GET_DATA({commit}){
    A.get(API_URL_ENDPOINT).then((res) =>{
      commit('SET_DATA' , res.data);
      commit('IS_LOADING' , false);
    }).catch((err) =>{
      console.error(err)
    });
  }
};

getters.js

Getters contain the methods used to abstract access to the state and to do some preprocessing tasks, if necessary (data calculation, filtering, etc …).

Vuex allows us to define "getters" in the store. Like computed properties, a getter's result is cached based on its dependencies, and will only re-evaluate when some of its dependencies have changed.

Getters will receive the state as their 1st argument

For the following example, we will be using Lodash's library. Lodash is a well-known JavaScript utility library that makes it easy to manipulate arrays and objects, as well as functions, strings, etc.

So, since we are interested in filtering some data in particular, we will use the function `.filter()`._

.filter(collection, [predicate=.identity])

Iterates over elements of collection, returning an array of all elements predicate returns truthy for. The predicate is invoked with three arguments: (value, index|key, collection).

var _ = require('lodash');
export const getters = {
  FILTER_SPESIFIC_DATA: (state) =>{
    return _.filter(state.data , (data) =>{
      // ....
    });
  }
};

Working in the view folder

Home.vue

When a component needs to make use of multiple store state properties or getters, declaring all these computed properties can get repetitive and verbose. To deal with this we can make use of the mapState helper which generates computed getter functions for us.
The easy way to access getters in your component, however, is through Vuex's mapGetter helper method. This allows you to mount getters to top-level computed properties in your component.

Note that mapState returns an object. How do we use it in combination with other local computed properties? Normally, we'd have to use a utility to merge multiple objects into one so that we can pass the final object to computed. However with the object spread operator (which is a stage-4 ECMAScript proposal), we can greatly simplify the syntax, equally applies with mapGetters.

Spread Properties

Spread properties in object initializers copies own enumerable properties from a provided object onto the newly created object.

<template>
  <div class="content">
    <div v-if="isLoading"> loading...</div>
    <div v-else>
       <div v-for="(content , index) in data" :key="index">
         // ....
       </div>
    </div> 
  </div>
</template>
<script>
  import {mapState , mapGetters} from 'vuex';
  import store from '../store/store.js';

  export default{
    name: 'home',
    computed:{
      ...mapState(['data' , 'isLoading']),
      ...mapGetters(['FILTER_SPESIFIC_DATA']),
      filteredDataObj(){
        return FILTER_SPESIFIC_DATA()
      }
    },
    created(){
      store.dispatch('GET_DATA')
    }
  };
</script>
<style scoped>
  .content{
    ....
  }
</style>

Finally…..

main.js

Now, to access the store you'll either have to import it in all of your components, or you can inject it into the root Vue instance to have it automatically injected into every other component in your app as this.$store or importing the store.js file from the store folder.

import Vue from 'vue';
import Vuex from 'vuex';
import App from 'App.vue';
import { store } from '../store/store.js';
Vue.config.productionTip = false;
Vue.use(Vuex);
new Vue({
  store,
  render: h => h(App)
}).$mount('#app');

Conclusion

Keep in mind that vuex helps us maintain and test our application better, but we also have to be aware that vuex involves new levels of abstraction that will make us need to work with new concepts that will make the learning curve less accessible for developed juniors to our projects. So be careful.

References

The Progressive JavaScript Framework

I'll be glad that you like this article! 💖