Cette page a été traduite par l'API Cloud Translation.

Representatives

Cette collection inclut des informations sur la géographie politique et sur les élus.

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Une ressource de cette collection comporte trois sections, décrites en détail ci-dessous. La section divisions répertorie les divisions géographiques politiques (pays, État, comté ou district législatif, par exemple). (Les divisions qui seront répertoriées dépendent de la requête API spécifique effectuée.) La section offices répertorie les postes politiques élus pour représenter les divisions dans la première section. La section officials répertorie les personnes qui travaillent actuellement dans les bureaux indiqués.

{
  "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
        }
      ]
    }
  ]
}

Géographie politique

Nom de propriété	Valeur	Description
`divisions`	`object`	Divisions géographiques politiques contenant l'adresse demandée.
`divisions.(key)`	`nested object`	L'identifiant Open Civic Data unique de cette division.
`divisions.(key).alsoKnownAs[]`	`list`	Tout autre identifiant OCD valide faisant référence à la même division Étant donné que les ID OCD sont conçus pour être lisibles par l'humain et au moins quelque peu prévisibles, il arrive que plusieurs identifiants correspondent à une même division. Ces identifiants sont équivalents les uns aux autres, et l'un est toujours désigné comme identifiant principal. L'identifiant principal sera renvoyé dans ocd_id ci-dessus, et tout autre identifiant valide équivalent sera renvoyé dans cette liste. Par exemple, si l'ID de cette division est "ocd-division/country:us/district:dc", il contiendra "ocd-division/country:us/state:dc".
`divisions.(key).name`	`string`	Nom de la division.
`divisions.(key).officeIndices[]`	`list`	Liste des indices dans le tableau `offices`, un pour chaque bureau élu de cette division. Ne sera présent que si `includeOffices` a la valeur "true" (ou absent) dans la requête.

Bureaux élus

Nom de propriété	Valeur	Description
`offices[]`	`list`	Services élus référencés par les divisions listées ci-dessus. Ne sera présent que si includeOffices a été défini sur "true" dans la demande.
`offices[].divisionId`	`string`	Identifiant OCD de la division à laquelle ce bureau est associé.
`offices[].levels[]`	`list`	Niveaux de gouvernement dont ce bureau fait partie. Il peut y en avoir plusieurs dans les cas où une juridiction agit effectivement à deux niveaux de gouvernement différents. Par exemple, le maire du district de Columbia agit dans la catégorie "localité". mais aussi efficacement aux niveaux `administrativeArea2` et `administrativeArea1`. Les valeurs possibles sont les suivantes: `international` : gouvernements internationaux, tels que les Nations Unies ou l'Union européenne. `country` -- Gouvernements au niveau national, tels que le gouvernement fédéral des États-Unis. `administrativeArea1` : gouvernement de la subdivision administrative de niveau supérieur d'un pays, comme les États américains. `regional` -- Administrations régionales dont la juridiction peut s'étendre sur des subdivisions administratives standards ils sont rares aux États-Unis, mais ils sont courants autour des grandes villes dans d'autres pays. `administrativeArea2` : gouvernements de la subdivision administrative de deuxième niveau d'un pays, comme les comtés des États-Unis. `locality` : administrations municipales ou municipales. `subLocality1` : gouvernement de la subdivision administrative de niveau supérieur d'une ville, telle que les quartiers de Washington. `subLocality2` : administrations de la subdivision administrative de deuxième niveau d'une ville,telle que les comités consultatifs de quartier de Washington, DC. `special` : circonscriptions locales qui n'existent que pour des administrations spécialisées, telles que les zones de protection de l'eau et des sols.
`offices[].name`	`string`	Nom lisible du bureau.
`offices[].officialIndices[]`	`list`	Liste des indices du tableau des fonctionnaires qui exercent actuellement ce poste.
`offices[].roles[]`	`list`	Les rôles que remplit ce bureau. Les rôles n'ont pas vocation à être exhaustifs ou à spécifier exactement l'ensemble des responsabilités d'un bureau donné. Il s'agit de catégories approximatives utiles pour la sélection générale ou le tri d'une liste de bureaux. Les valeurs valides incluent: `headOfState` : le représentant public principal d'un gouvernement. Le chef d'État d'un pays est généralement appelé Président. `headOfGovernment` : le directeur général d'un gouvernement. Aux États-Unis, il s'agit du président. dans d'autres pays, c'est souvent le Premier ministre. Aux niveaux inférieurs, il peut s'agir d'un gouverneur ou d'un maire. `deputyHeadOfGovernment` : l'agent chargé d'assumer le rôle de chef du gouvernement en cas de décès ou d'incapacité du chef du gouvernement élu. Aux États-Unis, il s'agit du vice-président. Ce bureau peut également avoir d'autres fonctions. `governmentOfficer` : élu secrétaire général. Dans les États américains, il peut s'agir de postes de procureur général, de contrôleur, de secrétaire d'État ou de trésorier. `executiveCouncil` : membre d'un conseil exécutif occupant des fonctions de direction en tant que groupe (par exemple, les commissaires du comté de l'Indiana). `legislatorUpperBody` : membre du haut d'une assemblée législative bicamérale ou du seul corps d'une législature unicamérale. `legislatorLowerBody` : membre de la partie inférieure d'une législature bicamérale. `highestCourtJudge` : un juge de la Cour suprême d'un gouvernement donné, tel qu'une Cour suprême d'État. `judge` : un juge dans un tribunal autre que le tribunal exécutif du gouvernement auquel il sert. `schoolBoard` : membre d'un conseil scolaire local `specialPurposeOfficer` : agent ayant un objectif unique et défini, tel que membre d'une commission de protection des sols et des eaux ou d'un agent de lutte contre les moustiques.
`offices[].sources[]`	`list`	Liste des sources pour ce bureau. Si plusieurs sources sont listées, les données ont été agrégées à partir de ces sources.
`offices[].sources[].name`	`string`	Nom de la source de données.
`offices[].sources[].official`	`boolean`	Si ces données proviennent d'une source gouvernementale officielle.

Fonctionnaires élus

Nom de propriété	Valeur	Description
`officials[]`	`list`	Fonctionnaires détenant les bureaux énumérés ci-dessus. Ne sera présent que si includeOffices a été défini sur "true" dans la demande.
`officials[].address[]`	`list`	Adresses auxquelles le fonctionnaire doit être contacté.
`officials[].address[].city`	`string`	Ville correspondant à l'adresse.
`officials[].address[].line1`	`string`	Nom et numéro de la rue associés à cette adresse.
`officials[].address[].line2`	`string`	La deuxième ligne contient l'adresse, si nécessaire.
`officials[].address[].line3`	`string`	Troisième ligne de l'adresse, si nécessaire.
`officials[].address[].locationName`	`string`	Nom du lieu.
`officials[].address[].state`	`string`	Code à deux lettres de l'État américain utilisé pour l'adresse.
`officials[].address[].zip`	`string`	Code postal américain de l'adresse.
`officials[].channels[]`	`list`	Liste des canaux (réseaux sociaux) connus de ce fonctionnaire.
`officials[].channels[].id`	`string`	Identifiant public unique de la chaîne du candidat.
`officials[].channels[].type`	`string`	Type de canal. Voici une liste non exhaustive de types de chaînes. D'autres types de chaînes pourront être ajoutés ultérieurement. YouTube, Facebook ou Twitter
`officials[].emails[]`	`list`	Adresses e-mail directes du fonctionnaire.
`officials[].name`	`string`	Nom du fonctionnaire.
`officials[].party`	`string`	Nom complet de la partie à laquelle appartient le fonctionnaire.
`officials[].phones[]`	`list`	Numéros de téléphone publics du fonctionnaire
`officials[].photoUrl`	`string`	URL d'une photo du fonctionnaire.
`officials[].urls[]`	`list`	URL du site Web public du fonctionnaire

Méthodes

representativeInfoByAddress: Recherche des informations relatives à la géographie politique et aux caractéristiques représentatives d'une adresse donnée.
representativeInfoByDivision: Recherche des informations représentatives d'une division géographique.