Representatives: representativeInfoByAddress

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

<ph type="x-smartling-placeholder">
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 の場合。詳しくは、 代表者 リソースのドキュメントをご覧ください。