.. This file is auto-generated.  Do not edit it by hand!

.. _multi-csv-electoral-district:

electoral_district
==================

The ``ElectoralDistrict`` object represents the geographic area in which contests are held. Examples
of ``ElectoralDistrict`` include: "the state of Maryland", "Virginia's 5th Congressional District",
or "Union School District". The geographic area that comprises a ``ElectoralDistrict`` is defined by
which precincts link to the ``ElectoralDistrict``.

+----------------------+---------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Tag                  | Data Type                             | Required?    | Repeats?     | Description                              | Error Handling                           |
+======================+=======================================+==============+==============+==========================================+==========================================+
| external_identifiers | :ref:`multi-csv-external-identifiers` | Optional     | Single       | Other identifiers that link to external  |                                          |
|                      |                                       |              |              | datasets (e.g. `OCD-IDs`_)               |                                          |
+----------------------+---------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| name                 | ``xs:string``                         | **Required** | Single       | Specifies the electoral area's name.     |                                          |
+----------------------+---------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| number               | ``xs:integer``                        | Optional     | Single       | Specifies the district number of the     |                                          |
|                      |                                       |              |              | district (e.g. 34, in the case of the    |                                          |
|                      |                                       |              |              | 34th State Senate District). If a number |                                          |
|                      |                                       |              |              | is not applicable, instead of leaving    |                                          |
|                      |                                       |              |              | the field blank, leave this field out of |                                          |
|                      |                                       |              |              | the object; empty strings are not valid  |                                          |
|                      |                                       |              |              | for xs:integer fields.                   |                                          |
+----------------------+---------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| type                 | :ref:`multi-csv-district-type`        | **Required** | Single       | Specifies the type of electoral area.    |                                          |
+----------------------+---------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| other_type           | ``xs:string``                         | Optional     | Single       | Allows for cataloging a new              |                                          |
|                      |                                       |              |              | :ref:`multi-csv-district-type` option    |                                          |
|                      |                                       |              |              | when ``Type`` is specified as "other".   |                                          |
+----------------------+---------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+

.. code-block:: csv-table
   :linenos:


    id,external_identifier_type,external_identifier_othertype,external_identifier_value,name,number,type,other_type
    ed001,ocd-id,,ocd-division/country:us/state:ny/borough:brooklyn,Brooklyn,1,borough,
    ed002,other,community-board,4,CB 4,2,other,community-board