Representatives: representativeInfoByAddress

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

Запрос

HTTP-запрос 

GET https://www.googleapis.com/civicinfo/v2/representatives

Параметры

Имя параметра Ценить Описание
Необязательные параметры запроса
address string Адрес для поиска. Может быть указано только в том случае, если поле ocdId не указано в URL-адресе.
includeOffices boolean Возвращать ли информацию об офисах и чиновниках. Если значение равно false, будет возвращена только информация о округе верхнего уровня. (По умолчанию: true )
levels string Список уровней офисов для фильтрации. Будут возвращены только офисы, которые обслуживают хотя бы один из этих уровней. Подразделения, в которых нет соответствующего офиса, не будут возвращены.

Приемлемые значения:
  • " administrativeArea1 "
  • " administrativeArea2 "
  • " country "
  • " international "
  • " locality "
  • " regional "
  • " special "
  • " subLocality1 "
  • " subLocality2 "
roles string Список офисных ролей для фильтрации. Будут возвращены только офисы, выполняющие одну из этих ролей. Подразделения, в которых нет соответствующего офиса, не будут возвращены.

Приемлемые значения:
  • « deputyHeadOfGovernment »
  • « executiveCouncil »
  • « governmentOfficer »
  • « headOfGovernment »
  • " headOfState "
  • « highestCourtJudge »
  • " judge "
  • " legislatorLowerBody "
  • " legislatorUpperBody "
  • " schoolBoard "
  • « specialPurposeOfficer »

Тело запроса

Не предоставляйте тело запроса с помощью этого метода.

Ответ

В случае успеха этот метод возвращает тело ответа следующей структуры: 

{
  "kind": "civicinfo#representativeInfoResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "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
        }
      ]
    }
  ]
}
Имя свойства Ценить Описание Примечания
kind string Определяет, что это за ресурс. Значение: фиксированная строка "civicinfo#representativeInfoResponse" .
normalizedInput nested object Нормализованная версия запрошенного адреса
normalizedInput. locationName string Название локации.
normalizedInput. line1 string Название улицы и номер этого адреса.
normalizedInput. line2 string Вторая строка адрес, если необходимо.
normalizedInput. line3 string Третья строка адреса, если необходимо.
normalizedInput. city string Город или поселок для адреса.
normalizedInput. state string Двухбуквенное сокращение адреса в США.
normalizedInput. zip string Почтовый индекс адреса США.
divisions object Политико-географические подразделения, содержащие запрошенный адрес. Более подробную информацию см. в документации по представителям .
offices[] list Выборные должности, указанные в подразделениях, перечисленных выше. Будет присутствовать только в том случае, если в запросе было указано значение includeOffices. Более подробную информацию см. в документации по представителям .
officials[] list Должностные лица, занимающие должности, перечисленные выше. Будет присутствовать только в том случае, если в запросе было указано значение includeOffices. Более подробную информацию см. в документации по представителям .