Representatives

В этот сборник включены сведения о политической географии, а также о выборных должностных лицах.

Список методов для этого ресурса см. в конце этой страницы.

Представления ресурсов

Ресурс в этой коллекции состоит из трех разделов, подробно описанных ниже. В разделе divisions перечислены политико-географические подразделения, такие как страна, штат, округ или законодательный округ. (Какие подразделения будут перечислены, зависит от конкретного запроса API.) В разделе offices » перечислены политические должности, которые избраны для представления подразделений в первом разделе. В разделе officials перечислены люди, которые в настоящее время работают в перечисленных должностях. 

{
  "divisions": {
    (key): {
      "name": string,
      "alsoKnownAs": [
        string
      ],
      "officeIndices": [
        unsigned integer
      ]
    }
  },
  "offices": [
    {
      "name": string,
      "divisionId": string,
      "levels": [
        string
      ],
      "roles": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ],
      "officialIndices": [
        unsigned integer
      ]
    }
  ],
  "officials": [
    {
      "name": string,
      "address": [
        {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        }
      ],
      "party": string,
      "phones": [
        string
      ],
      "urls": [
        string
      ],
      "photoUrl": string,
      "emails": [
        string
      ],
      "channels": [
        {
          "type": string,
          "id": string
        }
      ]
    }
  ]
}

Политическая география

Имя свойства Ценить Описание Примечания
divisions object Политико-географические подразделения, содержащие запрошенный адрес.
divisions. (key) nested object Уникальный идентификатор открытых гражданских данных для этого подразделения.
divisions.(key). alsoKnownAs[] list Любые другие действительные идентификаторы OCD, относящиеся к тому же подразделению.

Поскольку идентификаторы OCD должны быть удобочитаемыми и, по крайней мере, в некоторой степени предсказуемыми, иногда для одного подразделения используется несколько идентификаторов. Эти идентификаторы определяются как эквивалентные друг другу, и один из них всегда указывается как основной идентификатор. Основной идентификатор будет возвращен в ocd_id выше, а любые другие эквивалентные действительные идентификаторы будут возвращены в этом списке.

Например, если идентификатор OCD этого подразделения — ocd-division/country:us/district:dc, он будет содержать ocd-division/country:us/state:dc.
divisions.(key). name string Название подразделения.
divisions.(key). officeIndices[] list Список индексов в массиве offices , по одному на каждую должность, избранную из этого подразделения. Будет присутствовать только в том случае, если includeOffices в запросе был истинным (или отсутствовал).

Выборные должности

Имя свойства Ценить Описание Примечания
offices[] list Выборные должности, указанные в подразделениях, перечисленных выше. Будет присутствовать только в том случае, если в запросе было указано значение includeOffices.
offices[]. divisionId string Идентификатор OCD подразделения, с которым связан этот офис.
offices[]. levels[] list Уровни правительства, частью которых является этот офис. Их может быть более одного в случаях, когда юрисдикция эффективно действует на двух разных уровнях управления; например, мэр округа Колумбия действует на уровне «местности», но также эффективно как на administrativeArea2 , так и на administrativeArea1 .

Допустимые значения включают в себя:
  • international - Международные правительства, такие как Организация Объединенных Наций или Европейский Союз.
  • country — правительства национального уровня, такие как федеральное правительство США.
  • administrativeArea1 – правительства высшего административного подразделения страны, например штатов США.
  • regional — региональные правительства, чья юрисдикция может пересекать стандартные административные подразделения; они необычны в США, но распространены в крупных городах других стран.
  • administrativeArea2 — правительства административного подразделения второго уровня страны, например округов США.
  • locality - Городские или муниципальные органы власти.
  • subLocality1 — правительства высшего административного подразделения города, например округа Вашингтона, округ Колумбия.
  • subLocality2 — правительства административного подразделения города второго уровня, например, Консультативные советы соседей Вашингтона, округ Колумбия.
  • special — местные округа, которые существуют только для органов власти специального назначения, например, округа по охране почв и воды.
offices[]. name string Читабельное название офиса.
offices[]. officialIndices[] list Список показателей в массиве должностных лиц людей, занимающих в настоящее время эту должность.
offices[]. roles[] list Роли, которые выполняет этот офис. Роли не должны быть исчерпывающими или точно определять весь набор обязанностей данного офиса, а представляют собой приблизительные категории, которые полезны для общего выбора или сортировки списка офисов.

Допустимые значения включают в себя:
  • headOfState — главный публичный представитель правительства. Главу государства страны обычно называют Президентом.
  • headOfGovernment — главный исполнительный директор правительства. В США это президент; в других странах это часто премьер-министр. На более низких уровнях это может быть губернатор или мэр.
  • deputyHeadOfGovernment — должностное лицо, ответственное за принятие на себя роли главы правительства в случае смерти или недееспособности избранного главы правительства. В США это вице-президент. У этого офиса могут быть и другие обязанности.
  • governmentOfficer — Избираемое должностное лицо исполнительной власти. В штатах США это могут быть такие должности, как генеральный прокурор, контролер, секретарь или казначей.
  • executiveCouncil — член исполнительного совета, который выполняет функции исполнительной власти как группа. Примеры включают комиссаров округа Индиана.
  • legislatorUpperBody — член верхней части двухпалатного законодательного органа или единственный орган однопалатного законодательного органа.
  • legislatorLowerBody — член нижней части двухпалатного законодательного органа.
  • highestCourtJudge — судья высшего суда конкретного правительства, например, Верховного суда штата.
  • judge — Судья любого суда, который не является высшим судом правительства, которому он служит.
  • schoolBoard — член местного школьного совета.
  • specialPurposeOfficer — Должностное лицо, служащее одной, определенной цели, например, член совета по сохранению почвы и воды или сотрудник по борьбе с комарами.
offices[]. sources[] list Список источников для этого офиса. Если указано несколько источников, данные были агрегированы из этих источников.
offices[].sources[]. name string Имя источника данных.
offices[].sources[]. official boolean Поступают ли эти данные из официального правительственного источника.

Выборные должностные лица

Имя свойства Ценить Описание Примечания
officials[] list Должностные лица, занимающие должности, перечисленные выше. Будет присутствовать только в том случае, если в запросе было указано значение includeOffices.
officials[]. address[] list Адреса, по которым можно связаться с должностным лицом.
officials[].address[]. city string Город или поселок для адреса.
officials[].address[]. line1 string Название улицы и номер этого адреса.
officials[].address[]. line2 string Вторая строка адрес, если нужно.
officials[].address[]. line3 string Третья строка адреса, если необходимо.
officials[].address[]. locationName string Название локации.
officials[].address[]. state string Двухбуквенное сокращение адреса в США.
officials[].address[]. zip string Почтовый индекс адреса США.
officials[]. channels[] list Список известных (социальных) каналов этого чиновника.
officials[].channels[]. id string Уникальный общедоступный идентификатор канала кандидата.
officials[].channels[]. type string Тип канала. Ниже приводится список типов каналов, но он не является исчерпывающим. Дополнительные типы каналов могут быть добавлены позже. Один из: YouTube, Facebook, Twitter
officials[]. emails[] list Прямые адреса электронной почты чиновника.
officials[]. name string Имя должностного лица.
officials[]. party string Полное наименование партии, к которой принадлежит должностное лицо.
officials[]. phones[] list Общедоступные контактные телефоны чиновника.
officials[]. photoUrl string URL-адрес фотографии чиновника.
officials[]. urls[] list URL-адреса общедоступных веб-сайтов должностного лица.

Методы

ПредставительInfoByAddress
Ищет политическую географию и репрезентативную информацию для одного адреса.
ПредставительInfoByDivision
Ищет репрезентативную информацию для одного географического подразделения.