Representatives

این مجموعه شامل اطلاعاتی در مورد جغرافیای سیاسی و همچنین مقامات منتخب است.

برای لیست روش های این منبع، انتهای این صفحه را ببینید.

بازنمایی منابع

یک منبع در این مجموعه دارای سه بخش است که در زیر به تفصیل توضیح داده شده است. بخش divisions تقسیمات جغرافیایی سیاسی، مانند کشور، ایالت، شهرستان یا ناحیه قانونگذاری را فهرست می کند. (این که کدام بخش ها فهرست می شوند بستگی به درخواست API خاص ارائه شده دارد.) بخش offices پست های سیاسی را فهرست می کند که به نمایندگی از بخش ها در بخش اول انتخاب شده اند. بخش officials ، افرادی را که در حال حاضر در دفاتر ذکر شده خدمت می کنند، فهرست می کند. 

{
  "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
        }
      ]
    }
  ]
}

جغرافیای سیاسی

نام ملک ارزش توضیحات یادداشت ها
divisions object تقسیمات جغرافیایی سیاسی که حاوی آدرس درخواستی است.
divisions. (key) nested object شناسه منحصر به فرد Open Civic Data برای این بخش.
divisions.(key). alsoKnownAs[] list هر شناسه OCD معتبر دیگری که به همان بخش اشاره دارد.

از آنجایی که شناسه‌های OCD باید برای انسان قابل خواندن و حداقل تا حدودی قابل پیش‌بینی باشند، گهگاه چندین شناسه برای یک بخش وجود دارد. این شناسه ها معادل یکدیگر تعریف می شوند و همیشه یکی به عنوان شناسه اصلی نشان داده می شود. شناسه اصلی در ocd_id بالا بازگردانده می شود و هر شناسه معتبر معادل دیگری در این لیست بازگردانده می شود.

برای مثال، اگر شناسه OCD این بخش ocd-division/country:us/district:dc باشد، این شامل ocd-division/country:us/state:dc خواهد بود.
divisions.(key). name string نام بخش.
divisions.(key). officeIndices[] list فهرست شاخص‌ها در آرایه offices ، یکی برای هر دفتر انتخاب شده از این بخش. فقط در صورتی حضور خواهد داشت که includeOffices در درخواست درست باشد (یا وجود نداشته باشد).

دفاتر منتخب

نام ملک ارزش توضیحات یادداشت ها
offices[] list دفاتر منتخب ارجاع شده توسط بخش های ذکر شده در بالا. فقط در صورتی حضور خواهد داشت که includeOffices در درخواست درست باشد.
offices[]. divisionId string شناسه OCD بخشی که این دفتر با آن مرتبط است.
offices[]. levels[] list سطوح دولتی که این اداره بخشی از آن است. در مواردی که یک حوزه قضایی به طور مؤثر در دو سطح مختلف حکومت عمل می کند، ممکن است بیش از یک مورد وجود داشته باشد. برای مثال، شهردار ناحیه کلمبیا در سطح «محلی» عمل می‌کند، اما به‌طور مؤثر در هر دو administrativeArea2 و administrativeArea1 عمل می‌کند.

مقادیر معتبر عبارتند از:
  • international -- دولت های بین المللی، مانند سازمان ملل متحد یا اتحادیه اروپا.
  • country -- دولت های سطح ملی، مانند دولت فدرال ایالات متحده.
  • administrativeArea1 -- دولت‌های زیرمجموعه اداری سطح بالای یک کشور، مانند ایالت‌های ایالات متحده.
  • regional -- دولت های منطقه ای که حوزه قضایی آنها ممکن است از زیربخش های اداری استاندارد عبور کند. اینها در ایالات متحده غیر معمول هستند اما در شهرهای بزرگ در کشورهای دیگر رایج هستند.
  • administrativeArea2 -- دولت های زیربخش اداری سطح دوم یک کشور، مانند شهرستان های ایالات متحده.
  • locality -- دولت های شهر یا شهرداری.
  • subLocality1 -- دولت های زیربخش اداری سطح بالای یک شهر، مانند بخش های واشنگتن دی سی.
  • subLocality2 -- دولت های زیربخش اداری سطح دوم یک شهر، مانند شوراهای محله مشورتی واشنگتن دی سی.
  • special -- مناطق محلی که فقط برای دولت های خاص وجود دارند، مانند مناطق حفاظت از خاک و آب.
offices[]. name string نام قابل خواندن برای انسان دفتر.
offices[]. officialIndices[] list فهرست شاخص ها در آرایه رسمی افرادی که در حال حاضر این سمت را بر عهده دارند.
offices[]. roles[] list نقش هایی که این دفتر انجام می دهد. قرار نیست نقش‌ها جامع باشند، یا دقیقاً مجموعه مسئولیت‌های یک دفتر معین را مشخص کنند، بلکه مقوله‌های تقریبی هستند که برای انتخاب کلی یا مرتب‌سازی فهرستی از دفاتر مفید هستند.

مقادیر معتبر عبارتند از:
  • headOfState -- نماینده عمومی عمومی یک دولت. رئیس یک کشور معمولاً رئیس جمهور نامیده می شود.
  • headOfGovernment -- مدیر اجرایی یک دولت. در ایالات متحده، این رئیس جمهور است. در کشورهای دیگر، اغلب نخست وزیر است. در سطوح پایین تر ممکن است فرماندار یا شهردار باشد.
  • deputyHeadOfGovernment - افسری که در صورت فوت یا ناتوانی رئیس منتخب دولت مسئولیت ریاست دولت را بر عهده می گیرد. در ایالات متحده، این معاون رئیس جمهور است. این دفتر ممکن است وظایف دیگری نیز داشته باشد.
  • governmentOfficer - افسر منتخب شاخه اجرایی. در ایالت های ایالات متحده، این ممکن است شامل نقش هایی مانند دادستان کل، کنترلر، وزیر یا امور خارجه، یا خزانه دار باشد.
  • executiveCouncil - عضوی از یک شورای اجرایی که نقش های شاخه اجرایی را به عنوان یک گروه انجام می دهد. به عنوان مثال می توان به کمیسران شهرستان ایندیانا اشاره کرد.
  • legislatorUpperBody -- عضوی از هیئت فوقانی یک مجلس مقننه دو مجلسی، یا تنها هیئت قانونگذار تک مجلسی.
  • legislatorLowerBody -- عضوی از بدنه پایین یک مجلس قانونگذاری دو مجلسی.
  • highestCourtJudge - قاضی دادگاه عالی یک دولت خاص، مانند دادگاه عالی ایالتی.
  • judge - قاضی در هر دادگاهی که دادگاه عالی دولتی نیست.
  • schoolBoard - عضو هیئت مدیره مدرسه محلی.
  • specialPurposeOfficer - افسری که به یک هدف مشخص و مشخص عمل می کند، مانند عضوی از هیئت حفاظت از آب و خاک یا افسر کاهش پشه.
offices[]. sources[] list فهرستی از منابع این دفتر. اگر چندین منبع فهرست شده باشد، داده ها از آن منابع جمع آوری شده اند.
offices[].sources[]. name string نام منبع داده
offices[].sources[]. official boolean آیا این داده ها از یک منبع رسمی دولتی آمده است.

مقامات منتخب

نام ملک ارزش توضیحات یادداشت ها
officials[] list مقامات دارای دفاتر ذکر شده در بالا. فقط در صورتی حضور خواهد داشت که includeOffices در درخواست درست باشد.
officials[]. address[] list آدرس‌هایی که می‌توان با این مقام تماس گرفت.
officials[].address[]. city string شهر یا شهر برای آدرس.
officials[].address[]. line1 string نام خیابان و شماره این آدرس.
officials[].address[]. line2 string خط دوم آدرس، در صورت نیاز.
officials[].address[]. line3 string خط سوم آدرس در صورت نیاز.
officials[].address[]. locationName string نام مکان.
officials[].address[]. state string ایالات متحده دو حرف مخفف آدرس.
officials[].address[]. zip string کد پستی ایالات متحده آدرس.
officials[]. channels[] list فهرستی از کانال های رسانه های شناخته شده (اجتماعی) برای این مقام.
officials[].channels[]. id string شناسه عمومی منحصر به فرد برای کانال نامزد.
officials[].channels[]. type string نوع کانال لیست زیر لیستی از انواع کانال ها است، اما جامع نیست. ممکن است بعداً انواع کانال های بیشتری اضافه شوند. یکی از: یوتیوب، فیس بوک، توییتر
officials[]. emails[] list آدرس های ایمیل مستقیم برای مقام رسمی.
officials[]. name string نام مسئول
officials[]. party string نام کامل حزبی که مقام رسمی به آن تعلق دارد.
officials[]. phones[] list شماره تلفن های تماس عمومی این مقام.
officials[]. photoUrl string یک URL برای عکس رسمی.
officials[]. urls[] list نشانی های وب سایت عمومی رسمی.

روش ها

نمایندهInfoByAddress
جغرافیای سیاسی و اطلاعات نماینده را برای یک آدرس جستجو می کند.
نمایندهInfoByDivision
اطلاعات نماینده یک بخش جغرافیایی را جستجو می کند.