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:
|
|
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:
|
|
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.