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 قائمة بأدوار المكتب المطلوب الفلترة حسبها. لن يتم إرجاع سوى المكاتب التي تؤدي أحد هذه الأدوار. ولن يتم إرجاع الأقسام التي لا تحتوي على مكتب مطابق.

القيم المقبولة هي:
  • "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
        }
      ]
    }
  ]
}
اسم الموقع القيمة الوصف Notes
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 المكاتب المنتخبة المشار إليها في الأقسام المذكورة أعلاه. لن يتم توفيرها إلا إذا كانت includeOffices صحيحة في الطلب. للحصول على مزيد من التفاصيل، اطّلِع على مستندات مورد الممثّلين.
officials[] list المسؤولون الذين لديهم المناصب المذكورة أعلاه. لن يتم توفيرها إلا إذا كانت includeOffices صحيحة في الطلب. للحصول على مزيد من التفاصيل، اطّلِع على مستندات مورد الممثّلين.

تجربة