Questa pagina è stata tradotta dall'API Cloud Translation.

Representatives

Questa raccolta include informazioni sulla geografia politica, nonché sui funzionari eletti.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Una risorsa di questa raccolta ha tre sezioni, descritte dettagliatamente di seguito. La sezione divisions elenca le divisioni geografiche politiche, ad esempio un paese, uno stato, una contea o un distretto legislativo. Le divisioni da elencare dipendono dalla specifica richiesta API effettuata. La sezione offices elenca le posizioni politiche elette per rappresentare le divisioni nella prima sezione. La sezione officials elenca le persone che attualmente prestano servizio negli uffici elencati.

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

Geografia politica

Nome proprietà	Valore	Descrizione
`divisions`	`object`	Divisioni geografiche politiche che contengono l'indirizzo richiesto.
`divisions.(key)`	`nested object`	L'identificatore univoco dei dati civici aperti per questa divisione.
`divisions.(key).alsoKnownAs[]`	`list`	Qualsiasi altro ID OCD valido che fa riferimento alla stessa divisione. Poiché gli ID OCD devono essere leggibili da una persona e almeno un po' prevedibili, a volte esistono diversi identificatori per una singola divisione. Questi identificatori sono definiti per essere equivalenti tra loro e uno è sempre indicato come identificatore principale. L'identificatore principale verrà restituito nel campo ocd_id indicato sopra e qualsiasi altro identificatore valido equivalente verrà restituito in questo elenco. Ad esempio, se l'ID OCD di questa divisione è ocd-division/country:us/district:dc, conterrà ocd-division/country:us/state:dc.
`divisions.(key).name`	`string`	Il nome della divisione.
`divisions.(key).officeIndices[]`	`list`	Elenco di indici nell'array `offices`, uno per ogni carica eletta dalla divisione. Sarà presente solo se `includeOffices` era vero (o assente) nella richiesta.

Uffici eletti

Nome proprietà	Valore	Descrizione
`offices[]`	`list`	Uffici eletti a cui fanno riferimento le divisioni sopra elencate. Sarà presente solo se includeOffices è true nella richiesta.
`offices[].divisionId`	`string`	L'ID OCD della divisione a cui è associato l'ufficio.
`offices[].levels[]`	`list`	I livelli di governo a cui fa parte l'ufficio. Può essercene più di uno nei casi in cui una giurisdizione agisce effettivamente a due diversi livelli di governo; ad esempio, il sindaco del District of Columbia agisce a livello di "località", ma anche a livello sia di `administrativeArea2` che di `administrativeArea1`. I valori validi includono: `international` -- Governi internazionali come le Nazioni Unite o l'Unione Europea. `country` -- Governi di livello nazionale, come il Governo Federale degli Stati Uniti. `administrativeArea1`: governi della suddivisione amministrativa di primo livello di un paese, ad esempio gli stati USA. `regional`: amministrazioni regionali la cui giurisdizione può attraversare suddivisioni amministrative standard. Si tratta di amministrazioni non comuni negli Stati Uniti, ma comuni nelle grandi città di altri paesi. `administrativeArea2`: governi della suddivisione amministrativa di secondo livello di un paese, ad esempio le contee degli Stati Uniti. `locality` -- Amministrazioni municipali o comunali. `subLocality1`: governi della suddivisione amministrativa di primo livello di una città, come i quartieri di Washington, DC. `subLocality2`: governi della suddivisione amministrativa di secondo livello di una città, ad esempio i consigli di vicinato consultivo di Washington DC. `special`: distretti locali che esistono solo per amministrazioni pubbliche specializzate, come quelli per la tutela del suolo e dell'acqua.
`offices[].name`	`string`	Il nome leggibile dell'ufficio.
`offices[].officialIndices[]`	`list`	Elenco di indici nella serie di funzionari che attualmente ricoprono questa carica.
`offices[].roles[]`	`list`	Ruoli svolti da questo ufficio. I ruoli non sono intesi come esaustivi o per specificare esattamente l'intero insieme di responsabilità di un determinato ufficio, ma sono categorie approssimative utili per la selezione generale o l'ordinamento di un elenco di uffici. I valori validi includono: `headOfState` -- Il principale rappresentante pubblico di un governo. Il capo di stato di un paese è solitamente chiamato Presidente. `headOfGovernment`: Amministratore delegato di un governo. Negli Stati Uniti è il presidente, mentre in altri paesi è spesso il primo ministro. A livelli inferiori, potrebbe essere un governatore o un sindaco. `deputyHeadOfGovernment`: funzionario responsabile dell'assunzione del ruolo di capo del governo in caso di morte o di incapacità del capo del governo eletto. Negli Stati Uniti è il vicepresidente. Questo ufficio potrebbe anche avere altri compiti. `governmentOfficer` -- Un funzionario del ramo esecutivo eletto. Negli stati USA, questo ruolo può includere ruoli come procuratore generale, controllore, segretario, stato o tesoriere. `executiveCouncil`: membro di un consiglio esecutivo che ricopre il ruolo di dirigente come gruppo. Tra gli esempi ci sono i commissari della contea dell'Indiana. `legislatorUpperBody`: un membro della parte superiore di un corpo legislativo bicamerale o l'unico corpo di una legislatura unicamerale. `legislatorLowerBody`: un membro della parte inferiore di un legislatore bicamerale. `highestCourtJudge`: un giudice della corte di primo grado di un determinato governo, ad esempio una Corte Suprema statale. `judge`: un giudice di un tribunale diverso da quello del governo che ricopre. `schoolBoard`: membro di un comitato scolastico locale. `specialPurposeOfficer` -- Un agente che ha un unico scopo definito, ad esempio il membro di un comitato per la conservazione del suolo e delle acque o un funzionario addetto all'abbattimento delle zanzare.
`offices[].sources[]`	`list`	Un elenco di fonti per questo ufficio. Se sono elencate più origini, i dati sono stati aggregati da queste origini.
`offices[].sources[].name`	`string`	Il nome dell'origine dati.
`offices[].sources[].official`	`boolean`	Se questi dati provengono da una fonte governativa ufficiale.

Funzionari eletti

Nome proprietà	Valore	Descrizione
`officials[]`	`list`	Funzionari che ricoprono le cariche sopra elencate. Sarà presente solo se includeOffices è true nella richiesta.
`officials[].address[]`	`list`	Indirizzi a cui contattare il funzionario.
`officials[].address[].city`	`string`	La città dell'indirizzo.
`officials[].address[].line1`	`string`	Il nome e il numero della via dell'indirizzo.
`officials[].address[].line2`	`string`	La seconda riga dell'indirizzo, se necessario.
`officials[].address[].line3`	`string`	La terza riga dell'indirizzo, se necessario.
`officials[].address[].locationName`	`string`	Il nome del luogo.
`officials[].address[].state`	`string`	L'abbreviazione dello stato a due lettere dell'indirizzo statunitense.
`officials[].address[].zip`	`string`	Il codice postale statunitense dell'indirizzo.
`officials[].channels[]`	`list`	Un elenco dei canali media (social) noti di questo funzionario.
`officials[].channels[].id`	`string`	L'identificatore pubblico univoco del canale del candidato.
`officials[].channels[].type`	`string`	Il tipo di canale. Di seguito è riportato un elenco di tipi di canali, ma non è esaustivo. In un secondo momento potrai aggiungere altri tipi di canali. Uno dei seguenti: YouTube, Facebook, Twitter
`officials[].emails[]`	`list`	Gli indirizzi email diretti del funzionario.
`officials[].name`	`string`	Il nome del funzionario.
`officials[].party`	`string`	Il nome completo della parte a cui appartiene il funzionario.
`officials[].phones[]`	`list`	Numeri di telefono pubblici di contatto del funzionario.
`officials[].photoUrl`	`string`	Un URL di una foto del funzionario.
`officials[].urls[]`	`list`	URL del sito web pubblico del funzionario.

Metodi

representativeInfoByAddress: Controlla la geografia politica e le informazioni rappresentative di un singolo indirizzo.
representativeInfoByDivision: Cerca informazioni rappresentative per una singola divisione geografica.