Representatives: representativeInfoByAddress

ค้นหาภูมิศาสตร์ทางการเมืองและข้อมูลตัวแทนสำหรับที่อยู่เดียว ลองใช้เลย

ส่งคำขอ

คำขอ HTTP

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

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์การค้นหาที่ไม่บังคับ
address string ที่อยู่ที่ต้องการค้นหา ระบุได้เฉพาะในกรณีที่ช่อง ocdId ไม่ใช่ ที่ให้ไว้ใน URL
includeOffices boolean ต้องการส่งคืนข้อมูลเกี่ยวกับสำนักงานและเจ้าหน้าที่หรือไม่ หากเป็น "เท็จ" มีเพียงเท่านั้น ระบบจะแสดงข้อมูลเขตการศึกษาระดับบนสุด (ค่าเริ่มต้น: true)
levels string รายการระดับสำนักงานที่จะกรอง เฉพาะสำนักงานที่ให้บริการอย่างน้อย แสดงระดับใดระดับหนึ่ง ส่วนย่อยที่ไม่มีพารามิเตอร์ สำนักงานที่ตรงกันจะไม่ถูกส่งคืน

ค่าที่ยอมรับได้ มีดังนี้
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string รายการบทบาทในสำนักงานที่จะกรอง เฉพาะสำนักงานที่ดำเนินการตามหนึ่งใน แสดงบทบาทเหล่านี้ ส่วนย่อยที่ไม่มีผลลัพธ์ที่ตรงกัน Office จะไม่ถูกส่งคืน

ค่าที่ยอมรับได้ มีดังนี้
  • "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 บรรทัดที่สามของที่อยู่ หากจําเป็น
normalizedInput.city string เมืองของที่อยู่
normalizedInput.state string ตัวย่อของรัฐแบบ 2 ตัวอักษรของสหรัฐอเมริกา
normalizedInput.zip string รหัสไปรษณีย์ในสหรัฐอเมริกาของที่อยู่
divisions object หน่วยงานทางภูมิศาสตร์ทางการเมืองที่มีคำขอ อีเมล ดูรายละเอียดเพิ่มเติมได้ที่ ตัวแทน แหล่งข้อมูลเพิ่มเติม
offices[] list ตำแหน่งที่ได้รับเลือกที่อ้างอิงโดยหน่วยงานที่ระบุไว้ข้างต้น พินัยกรรม ปรากฏต่อเมื่อ includeOffices เป็นจริงในคำขอเท่านั้น ดูรายละเอียดเพิ่มเติมได้ที่ ตัวแทน แหล่งข้อมูลเพิ่มเติม
officials[] list เจ้าหน้าที่ที่มีสำนักงานตามที่แสดงไว้ข้างต้น จะแสดงเท่านั้น ถ้า includeOffices เป็นจริงในคำขอ ดูรายละเอียดเพิ่มเติมได้ที่ ตัวแทน แหล่งข้อมูลเพิ่มเติม

ลองใช้งาน