Representatives

Cette collection inclut des informations sur la géographie politique et 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 circonscription, par exemple). (Les divisions qui seront listées dépendent de la requête API spécifique effectuée.) La section offices répertorie les positions politiques élues pour représenter les divisions dans la première section. La section officials répertorie les personnes actuellement présentes dans les bureaux listé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 Notes
divisions object Divisions géographiques politiques contenant l'adresse demandée.
divisions.(key) nested object Identifiant Open Civic Data unique pour cette division.
divisions.(key).alsoKnownAs[] list Tout autre ID OCD valide faisant référence à la même division.

Étant donné que les ID de TOC sont conçus pour être lisibles par l'humain et au moins prévisibles, il peut arriver qu'une même division soit associée à plusieurs identifiants. Ces identifiants sont définis comme étant équivalents les uns aux autres, et l'un d'eux est toujours indiqué 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 décodeur de la division est ocd-division/country:us/district:dc, le code contient le code ocd-division/country:us/state:dc.
divisions.(key).name string Nom de la division.
divisions.(key).officeIndices[] list Liste des index dans le tableau offices, un pour chaque bureau élu dans cette division. Ne sera présent que si includeOffices est défini sur "true" (ou absent) dans la requête.

Bureaux élus

Nom de propriété Valeur Description Notes
offices[] list Bureaux élus référencés par les divisions listées ci-dessus. Ne sera présent que si includeOffices a la valeur "true" dans la requête.
offices[].divisionId string Identifiant TOCD de la division à laquelle ce bureau est associé.
offices[].levels[] list Niveaux de gouvernement auxquels ce bureau fait partie. Il peut y avoir plusieurs cas où une juridiction agit efficacement à deux niveaux de gouvernement différents. Par exemple, le maire du District de Columbia agit au niveau de la "localité", mais aussi au niveau des administrativeArea2 et des administrativeArea1.

Les valeurs possibles sont les suivantes: 
  • international : gouvernements internationaux, tels que les Nations Unies ou l'Union européenne.
  • country : administrations nationales, comme le gouvernement fédéral américain.
  • administrativeArea1 : gouvernements de la subdivision administrative de niveau supérieur d'un pays, comme les États américains.
  • regional : administrations régionales dont la juridiction peut traverser des subdivisions administratives standards. Ce type d'administration est rare aux États-Unis, mais il est courant dans les grandes villes d'autres pays.
  • administrativeArea2 : gouvernements de la subdivision administrative de deuxième niveau d'un pays, tels que les comtés des États-Unis.
  • locality : administrations municipales ou municipales
  • subLocality1 : gouvernement de la subdivision administrative de niveau supérieur d'une ville (par exemple, les districts de Washington, DC).
  • subLocality2 : gouvernements de la subdivision administrative de deuxième niveau d'une ville,comme les conseils consultatifs de quartier de Washington, DC.
  • special : districts locaux qui n'existent que pour des administrations spécialisées, comme les districts de protection des sols et de l'eau.
offices[].name string Nom lisible du bureau.
offices[].officialIndices[] list Liste des index dans le tableau des fonctionnaires qui occupent actuellement ce bureau.
offices[].roles[] list Les rôles de ce bureau. Les rôles n'ont pas vocation à être exhaustifs, ni à spécifier exactement l'ensemble des responsabilités d'un bureau donné. Ils correspondent à des catégories approximatives utiles pour la sélection générale ou le tri d'une liste de bureaux.

Les valeurs acceptées sont les suivantes:
  • headOfState : principal représentant public d'un gouvernement. Le chef d'État d'un pays est généralement appelé le président.
  • headOfGovernment : président-directeur général d'un gouvernement. Aux États-Unis, il s'agit du président. Dans les autres pays, il s'agit souvent du Premier ministre. Pour les niveaux inférieurs, il peut s'agir d'un gouverneur ou de maire.
  • deputyHeadOfGovernment : agent chargé d'assumer le rôle de chef du gouvernement en cas de décès ou d'incapacité du chef élu. Aux États-Unis, il s'agit du vice-président. Ce bureau peut également avoir d'autres tâches.
  • governmentOfficer : élu exécutif. Dans les États américains, cela peut inclure les fonctions de procureur général, de contrôleur, de secrétaire d'État ou de trésorier.
  • executiveCouncil : membre d'un conseil exécutif exerçant des fonctions de direction en tant que groupe. Exemples : commissaires du comté de l'Indiana.
  • legislatorUpperBody : membre de la partie supérieure d'une assemblée législative bicaméral ou de l'unique corps d'une législature monocaméra.
  • legislatorLowerBody : membre du bas du corps d'une législature bicaméral.
  • highestCourtJudge : juge de la plus haute instance d'un gouvernement, comme la Cour suprême d'État.
  • judge : un juge dans tout tribunal autre que le tribunal supérieur du gouvernement auquel il est consacré
  • schoolBoard : membre d'un comité scolaire local
  • specialPurposeOfficer : officier qui remplit un objectif unique et défini, par exemple membre d'un comité de protection des sols et de l'eau ou responsable de la lutte contre les moustiques.
offices[].sources[] list Liste des sources de 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 Notes
officials[] list Fonctionnaires occupant les postes indiqués ci-dessus. Ne sera présent que si includeOffices a la valeur "true" dans la requête.
officials[].address[] list Adresses auxquelles contacter le fonctionnaire.
officials[].address[].city string Ville de l'adresse.
officials[].address[].line1 string Nom et numéro de la rue associés à cette adresse.
officials[].address[].line2 string Insérez l'adresse sur la deuxième ligne, 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 Abréviation à deux lettres de l'État américain de l'adresse.
officials[].address[].zip string Code postal américain de l'adresse.
officials[].channels[] list Liste des chaînes de réseaux sociaux connues de ce responsable.
officials[].channels[].id string Identifiant public unique de la chaîne du candidat.
officials[].channels[].type string Type de canal. Vous trouverez ci-dessous une liste non exhaustive des types de canaux. Vous pourrez en ajouter d'autres par la suite. YouTube, Facebook ou Twitter.
officials[].emails[] list Adresses e-mail directes du fonctionnaire.
officials[].name string Le 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
Il recherche des informations sur la géographie politique et les représentants d'une même adresse.
representativeInfoByDivision
Elles recherchent des informations représentatives d'une seule division géographique.