newsdev / elex

A wrapper for the AP v2 Elections API.
Other
171 stars 53 forks source link

Add EEVP (expected vote percentage) to elex #313

Open jeremyjbowers opened 7 years ago

jeremyjbowers commented 7 years ago

"As part of our standard election night feeds and products, AP reports the “number of precincts reporting” and “total precincts” for any given race, as well as the resulting precincts reporting percentage in the API (“ReportingPct”) – number of precincts reporting / total precincts.

The AP will also provide an additional optional variable to a new beta election API report, the “Estimated Expected Vote Percentage” (EEVP) election API report.

Where and when it can provide added value to the understanding of vote tabulation, this EEVP value in this new API report will be provided for the following statewide races:

· Federal (President and U.S Senate) · Governor

during the primaries and general election.

For 2017, this will be provided for the following elections/races: · 6/13 VA Dem and GOP Governor’s races · 8/15 AL U.S. Senate special primary race · 8/26 AL U.S. Senate special primary runoff (if needed) · 11/7 NJ and VA Governor races · 12/12 AL U.S. Senate special general

The EEVP will be a calculation of incoming total statewide votes that are being tabulated for the race, divided by an AP internally assigned “estimated expected total votes” parameter for the specific race. The “estimated expected total votes” is determined by our proprietary research, knowledge, and expertise.

The EEVP will vary over the course of the election night tabulation, based on the incoming total votes at any given time for the race, and will represent the percentage of the total votes that AP estimates will eventually be certified.

The “Estimated Expected Vote Percentage” (EEVP) election API report will be sent out on election night per the standard election API election feed cycle of every 3 minutes, in this format:

<EstimatedVotePercentage Test="0" timestamp="2017-06-013T23:44:42Z">
                <State StatePostal="VA" ElectionDate="2017-06-13">
                                <Race ID=<47829> pctExpVote="85">
                                <Race ID=<47871> pctExpVote="81">
                </State>
</EstimatedVotePercentage>

In this example, 47829 is the race number for the 6/13 VA Gov-GOP race and 47871 is the race number for the 6/13 VA Gov-Dem race.

This beta EEVP election API report will be sent out for the 6/13 VA election for the VA Dem and GOP Governor races, and during the regular scheduled testing, starting Tuesday, May 30, 2pm – 3pm ET (attached is the 6/13 VA test advisory which provides the full testing schedule)."