البحث عن التقسيمات الجغرافية السياسية لعنوان واحد جرِّب ذلك الآن.
الطلب
طلب HTTP
GET https://www.googleapis.com/civicinfo/v2/divisionsByAddress
المعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات طلب البحث الاختيارية | ||
address |
string |
العنوان المطلوب البحث عنه |
نص الطلب
لا تقدِّم محتوى طلب باستخدام هذه الطريقة.
الرد
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:
{ "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 |
لتحديد نوع المورد القيمة: السلسلة الثابتة |
|
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 |
معرّف البيانات المدنية المفتوحة (OCD) الفريد للقسمة. | |
divisions.(key).alsoKnownAs[] |
list |
أي معرّفات أخرى صالحة لقسم التسويق عبر الإنترنت تشير إلى القسم نفسه بما أنّ معرّفات OCD سهلة القراءة ويمكن توقّعها، هناك أحيانًا عدة معرّفات لقسم واحد. يتم تحديد هذه المعرّفات على أنّها متكافئة مع بعضها، ويتم دائمًا الإشارة إلى أحدها على أنّه المعرّف الأساسي. يتم عرض المعرّف الأساسي في معرّف OCD، ويتم عرض أي معرّفات صالحة أخرى مماثلة في القائمة. على سبيل المثال، إذا كان رقم تعريف OCD للقسم التالي هو |
|
divisions.(key).name |
string |
اسم القسم |