Representatives: representativeInfoByAddress

एक पते के लिए, राजनैतिक भूगोल और प्रतिनिधि से जुड़ी जानकारी खोजता है. इसे अभी आज़माएं.

अनुरोध

एचटीटीपी अनुरोध

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

पैरामीटर

पैरामीटर का नाम मान ब्यौरा
वैकल्पिक क्वेरी पैरामीटर
address string खोजा जाने वाला पता. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब ocdId फ़ील्ड में वैल्यू न हो दिया गया है.
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
        }
      ]
    }
  ]
}
प्रॉपर्टी का नाम मान ब्यौरा नोट
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 वे राजनीतिक भौगोलिक विभाग, जिनमें अनुरोध किए गए शामिल हैं इससे पहले ही अपने कारोबार के हिसाब से name@yourcompany.com जैसा कोई ईमेल पता बनाएं. ज़्यादा जानकारी के लिए, यह देखें प्रतिनिधि संसाधन दस्तावेज़ सबमिट करें.
offices[] list ऊपर दी गई सूची में शामिल डिवीज़न के हिसाब से चुने गए ऑफ़िस. विल सिर्फ़ तभी मौजूद रहें, जब अनुरोध में includeOffices को शामिल किया गया हो. ज़्यादा जानकारी के लिए, यह देखें प्रतिनिधि संसाधन दस्तावेज़ सबमिट करें.
officials[] list ऊपर सूची में दिए गए ऑफ़िस संभालकर रखने वाले अधिकारी. सिर्फ़ मौजूद होंगे अगर includeOffices का अनुरोध सही था. ज़्यादा जानकारी के लिए, यह देखें प्रतिनिधि संसाधन दस्तावेज़ सबमिट करें.

इसे आज़माएं!