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.

If the field is invalid or not present, then the implementation is required to ignore it.

ExternalIdentifiers

ExternalIdentifiers

Optional

Single

Another identifier for a locality that links 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 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.

If the field is invalid, then the implementation is required to ignore the Locality element containing it.

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.

If the field is invalid or not present, the implementation is required to ignore it. However, the implementation should still check to see if there are any polling locations associated with this locality’s state.

StateId

xs:IDREF

Required

Single

References the locality’s State.

If the field is invalid, then the implementation is required to ignore the Locality element containing it.

Type

DistrictType

Optional

Single

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

If the field is invalid or not present, then the implementation is required to ignore it.

OtherType

xs:string

Optional

Single

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

If the field is invalid or not present, then the implementation is required to ignore it.

 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>