Representatives: representativeInfoByAddress

1 つの住所の政治的地理および代表的な情報を検索します。 実習をご覧ください。

<ph type="x-smartling-placeholder">

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名 値 説明
省略可能なクエリ パラメータ
address string 検索する住所。フィールド ocdId が 表示されます。
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 住所の 2 行目（必要に応じて）。
normalizedInput.line3 string 住所の 3 行目（必要に応じて）。
normalizedInput.city string 住所の市区町村。
normalizedInput.state string 米国の 2 文字の州コード。
normalizedInput.zip string 住所の米国の郵便番号。
divisions object リクエストされた行政区域を含む あります。詳しくは、 代表者 リソースのドキュメントをご覧ください。
offices[] list 上記の部門で参照される選出公職。ウィル リクエストで includeOffices が true の場合にのみ存在します。詳しくは、 代表者 リソースのドキュメントをご覧ください。
officials[] list 上記のオフィスの責任者。存在するだけ リクエストの includeOffices が true の場合。詳しくは、 代表者 リソースのドキュメントをご覧ください。

試してみよう: