يبحث عن المعلومات الجغرافية السياسية والمعلومات التمثيلية عن عنوان واحد. التجربة الآن
الطلب
طلب HTTP
GET https://www.googleapis.com/civicinfo/v2/representatives
المَعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات طلب البحث الاختيارية | ||
address |
string |
العنوان الذي تريد البحث عنه. يمكن فقط تحديده إذا لم يتم تقديم الحقل ocdId في عنوان URL. |
includeOffices |
boolean |
ما إذا كان يجب عرض معلومات عن المكاتب والمسؤولين. في حال اختيار "خطأ"، لن يتم عرض
سوى معلومات المنطقة ذات المستوى الأعلى.
(القيمة التلقائية: true )
|
levels |
string |
قائمة بمستويات المكتب المطلوب الفلترة حسبها. لن يتم إرجاع سوى المكاتب التي تخدم واحدًا
على الأقل من هذه المستويات. لن يتم إرجاع الأقسام التي لا تحتوي
على مكتب مطابق.
القيم المقبولة هي:
|
roles |
string |
قائمة بأدوار المكتب المطلوب الفلترة حسبها. لن يتم إرجاع سوى المكاتب التي تؤدي
أحد هذه الأدوار. ولن يتم إرجاع الأقسام التي لا تحتوي
على مكتب مطابق.
القيم المقبولة هي:
|
نص الطلب
لا توفِّر نص طلب بهذه الطريقة.
الإجابة
إذا نجحت هذه الطريقة، ستعرض هذه الطريقة نص استجابة بالبنية التالية:
{ "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 صحيحة في الطلب. للحصول على مزيد من التفاصيل، اطّلِع على مستندات مورد الممثّلين. |