Representatives: representativeInfoByAddress

البحث عن المعلومات الجغرافية السياسية والمعلومات التمثيلية لعنوان واحد تجربة ذلك الآن

الطلب

طلب HTTP

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

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات طلب البحث الاختيارية
address string العنوان المطلوب البحث عنه. يمكن تحديده فقط إذا لم يكن الحقل ocdId المحدد في عنوان URL.
includeOffices boolean تحديد ما إذا كان يجب إرجاع معلومات عن المكاتب والمسؤولين في حال اختيار "false"، فقط سيتم عرض معلومات المنطقة ذات المستوى الأعلى. (القيمة التلقائية: 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 والسطر الثاني هو العنوان، إذا لزم الأمر.
normalizedInput.line3 string السطر الثالث من العنوان، إذا لزم الأمر.
normalizedInput.city string تمثّل هذه السمة المدينة أو البلدة التي يقع ضمنها العنوان.
normalizedInput.state string اختصار العنوان المكون من حرفين في الولايات المتحدة.
normalizedInput.zip string تمثّل هذه السمة الرمز البريدي للولايات المتحدة.
divisions object التقسيمات الجغرافية السياسية التي تضم العمليات المطلوبة الخاص بك. لمزيد من التفاصيل، يُرجى مراجعة الممثلون الموارد
offices[] list المكاتب المنتخَبة المُشار إليها من الأقسام المذكورة أعلاه سوف لا تكون موجودة إلا إذا كانت وتشمل addOffices صحيحة في الطلب. لمزيد من التفاصيل، يُرجى مراجعة الممثلون الموارد
officials[] list المسؤولون الذين يملكون المكاتب المذكورة أعلاه. ستكون موجودة فقط إذا كانت التضمينات مكتبية صحيحة في الطلب. لمزيد من التفاصيل، يُرجى مراجعة الممثلون الموارد

جرّب الآن