Precinct

The Precinct object represents a precinct, which is contained within a Locality. While the id attribute does not have to be static across feeds for one election, the combination of Source.VipId, Locality.Name, Precinct.Ward, Precinct.Name, and Precinct.Number should remain constant across feeds for one election (NB: not all of the fields just mentioned are required – omitting those non-required fields is fine).

Tag Data Type Required? Repeats? Description Error Handling
BallotStyleId xs:IDREF Optional Single Links to the BallotStyle, which a person who lives in this precinct will vote. If the field is invalid or not present, then the implementation is required to ignore it.
ElectoralDistrictIds xs:IDREFS Optional Single Links to the :ref:`multi-xml-electoral-district`s (e.g., congressional district, state house district, school board district) to which the entire precinct/precinct split belongs. Highly Recommended if candidate information is to be provided. If the field is invalid or not present, then the implementation is required to ignore it.
ExternalIdentifiers ExternalIdentifiers Optional Single Other identifier for the precinct that relates to another dataset (e.g. OCD-ID). If the element is invalid or not present, then the implementation is required to ignore it.
IsMailOnly xs:boolean Optional Single Determines if the precinct runs mail-only elections. If the field is missing or invalid, the implementation is required to assume IsMailOnly is false.
LocalityId xs:IDREF Required Single Links to the Locality that comprises the precinct. If the field is invalid, then the implementation is required to ignore the Precinct element containing it.
Name xs:string Required Single Specifies the precinct’s name (or number if no name exists). If the field is invalid, then the implementation is required to ignore the Precinct element containing it.
Number xs:string Optional Single Specifies the precinct’s number (e.g., 32 or 32A – alpha characters are legal). Should be used if the Name field is populated by a name and not a number. If the field is invalid or not present, then the implementation is required to ignore it.
PollingLocationIds xs:IDREFS Optional Single Specifies a link to the precinct’s PollingLocation object(s). If the field is invalid or not present, then the implementation is required to ignore it.
PrecinctSplitName xs:string Optional Single If this field is empty, then this Precinct object represents a full precinct. If this field is present, then this Precinct object represents one portion of a split precinct. Each Precinct object that represents one portion of a split precinct must have the same Name value, but different PrecinctSplitName values. See the sample_feed.xml file for examples. If the field is invalid or not present, then the implementation is required to ignore it.
Ward xs:string Optional Single Specifies the ward the precinct is contained within. If the field is invalid or not present, then the implementation is required to ignore it. 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
<Precinct id="pre90111">
   <BallotStyleId>bs00010</BallotStyleId>
   <ElectoralDistrictIds>ed60129 ed60311 ed60054</ElectoralDistrictIds>
   <IsMailOnly>false</IsMailOnly>
   <LocalityId>loc70001</LocalityId>
   <Name>203 - GEORGETOWN</Name>
   <Number>0203</Number>
   <PollingLocationIds>pl81274</PollingLocationIds>
</Precinct>
<!--
  Precinct split. Name and PollingLocationIds are the same but
  PrecinctSplitName is present, the ElectoralDistrictIds are different,
  and the BallotStyleId is different.
-->
<Precinct id="pre90348sp0000">
  <BallotStyleId>bs00002</BallotStyleId>
  <ElectoralDistrictIds>ed60129 ed60054 ed60150</ElectoralDistrictIds>
  <IsMailOnly>false</IsMailOnly>
  <LocalityId>loc70001</LocalityId>
  <Name>201 - JACK JOUETT</Name>
  <Number>0201</Number>
  <PollingLocationIds>pl00000 pl81273 pl81662</PollingLocationIds>
  <PrecinctSplitName>0000</PrecinctSplitName>
</Precinct>
<Precinct id="pre90348sp0001">
  <BallotStyleId>bs00015</BallotStyleId>
  <ElectoralDistrictIds>ed60129 ed60054 ed60267</ElectoralDistrictIds>
  <IsMailOnly>false</IsMailOnly>
  <LocalityId>loc70001</LocalityId>
  <Name>201 - JACK JOUETT</Name>
  <Number>0201</Number>
  <PollingLocationIds>pl00000 pl81273 pl81662</PollingLocationIds>
  <PrecinctSplitName>0001</PrecinctSplitName>
</Precinct>