Divisions: divisionsByAddress

חיפוש של חלוקות גיאוגרפיות פוליטיות לכתובת אחת. רוצים לנסות עכשיו?

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר	ערך	תיאור
פרמטרים אופציונליים של שאילתות
address	string	הכתובת לחיפוש.

גוף הבקשה

לא צריך לספק גוף בקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:

{
  "kind": "civicinfo#divisionsByAddressResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string,
  },
  "divisions": {
    key: {
      "name": string,
        "alsoKnownAs": [
        string
      ],
    },
  }

שם הנכס	ערך	תיאור	הערות
kind	string	מזהה את סוג המשאב. ערך: המחרוזת הקבועה "civicinfo#divisionsByAddressResponse".
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	חלוקות גיאוגרפיות פוליטיות שמכילות את הכתובת המבוקשת.
divisions.(key)	nested object	המזהה הייחודי של Open Civic Data (OCD ID) של המחלקה.
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	שם החטיבה.

נסה בעצמך!