Locality

The Locality object represents the jurisdiction below the State (e.g. county).

Tag

Data Type

Required?

Repeats?

Description

Error Handling

ElectionAdministrationId

xs:IDREF

Optional

Single

Links to the locality’s ElectionAdministration object.

ExternalIdentifiers

ExternalIdentifiers

Optional

Single

Another identifier for a locality that links to another dataset (e.g. OCD-ID)

IsMailOnly

xs:boolean

Optional

Single

Determines if the locality runs mail-only elections. If this is true, then all precincts a part of the locality will also run mail-only elections. Drop boxes may be used in addition to this flag using a polling location record configured as a Drop Box.

If the field is missing or invalid, the implementation is required to assume IsMailOnly is false.

Name

xs:string

Required

Single

Specifies the name of a locality.

PollingLocationIds

xs:IDREFS

Optional

Single

Specifies a link to a set of the locality’s :ref:`polling locations <multi-xml-polling-location>`s. If early vote centers or ballot drop locations are locality-wide, they should be specified here.

StateId

xs:IDREF

Required

Single

References the locality’s State.

Type

DistrictType

Optional

Single

Defines the kind of locality (e.g. county, town, et al.), which is one of the various DistrictType enumerations.

OtherType

xs:string

Optional

Single

Allows for defining a type of locality that falls outside the options listed in DistrictType.

 1<Locality id="loc70001">
 2  <ElectionAdministrationId>ea40001</ElectionAdministrationId>
 3  <ExternalIdentifiers>
 4    <ExternalIdentifier>
 5      <Type>ocd-id</Type>
 6      <Value>ocd-division/country:us/state:va/county:albemarle</Value>
 7    </ExternalIdentifier>
 8  </ExternalIdentifiers>
 9  <IsMailOnly>true</IsMailOnly>
10  <Name>ALBEMARLE COUNTY</Name>
11  <StateId>st51</StateId>
12  <Type>county</Type>
13</Locality>