Package google.type

شاخص

LatLng

شیئی که نشان دهنده یک جفت طول و عرض جغرافیایی است. این به صورت یک جفت دوتایی برای نشان دادن درجه عرض جغرافیایی و درجه طول جغرافیایی بیان می شود. مگر اینکه طور دیگری مشخص شده باشد، این شی باید با استاندارد WGS84 مطابقت داشته باشد. مقادیر باید در محدوده نرمال شده باشند.

فیلدها
latitude

double

عرض جغرافیایی بر حسب درجه باید در محدوده [-90.0، +90.0] باشد.

longitude

double

طول جغرافیایی بر حسب درجه باید در محدوده [-180.0، +180.0] باشد.

آدرس پستی

نشان دهنده یک آدرس پستی است، به عنوان مثال برای آدرس های تحویل پستی یا پرداخت. با توجه به آدرس پستی، یک سرویس پستی می تواند اقلام را به محل، صندوق پستی یا موارد مشابه تحویل دهد. مدل سازی مکان های جغرافیایی (جاده ها، شهرها، کوه ها) در نظر گرفته نشده است.

در استفاده معمولی، بسته به نوع فرآیند، یک آدرس از طریق ورودی کاربر یا از وارد کردن داده‌های موجود ایجاد می‌شود.

توصیه‌هایی در مورد ورودی/ویرایش آدرس: - از ویجت آدرس آماده بین‌المللی‌سازی مانند https://github.com/google/libaddressinput استفاده کنید - به کاربران نباید عناصر رابط کاربری برای ورودی یا ویرایش فیلدها در خارج از کشورهایی که آن فیلد وجود دارد ارائه شود. استفاده می شود.

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرح، لطفاً به این آدرس مراجعه کنید: https://support.google.com/business/answer/6397478

فیلدها
revision

int32

بازبینی طرحواره PostalAddress . هر مقداری غیر از 0 باعث می شود API یک خطای INVALID_ARGUMENT را برگرداند.

region_ code

string

اختیاری. کد منطقه CLDR کشور/منطقه آدرس. برای جزئیات به https://cldr.unicode.org/ و https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس. اگر کد منطقه ارائه نشده باشد، از آدرس استنباط می شود. برای بهترین عملکرد، توصیه می‌شود در صورت اطلاع، کد منطقه را نیز وارد کنید. داشتن مناطق ناسازگار یا تکراری می تواند منجر به عملکرد ضعیف شود، برای مثال، اگر address_lines قبلاً منطقه را شامل می شود، دوباره کد منطقه را در این قسمت ارائه نکنید. مناطق پشتیبانی شده را می توان در پرسش های متداول یافت.

language_ code

string

کد زبان در آدرس ورودی برای استفاده های بعدی رزرو شده است و امروز نادیده گرفته می شود. API آدرس را به زبان مناسبی که آدرس در آن قرار دارد برمی گرداند.

postal_ code

string

اختیاری. کد پستی آدرس همه کشورها از وجود کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر قسمت‌های آدرس (مثلاً اعتبارسنجی ایالت/زیپ در ایالات متحده آمریکا) ایجاد کنند.

sorting_ code

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است، که به صورت اختیاری با یک عدد دنبال می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی، نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر ناحیه تحویل» است. (مالاوی) یا «نشانگر اداره پست» (مثلاً ساحل عاج).

administrative_ area

string

اختیاری. بالاترین بخش اداری که برای آدرس های پستی یک کشور یا منطقه استفاده می شود. به عنوان مثال، این می تواند یک ایالت، یک استان، یک استان یا یک استان باشد. به طور خاص، برای اسپانیا این استان است و نه جامعه خودمختار (مثلاً "بارسلونا" و نه "کاتالونیا"). بسیاری از کشورها از یک منطقه اداری در آدرس های پستی استفاده نمی کنند. به عنوان مثال در سوئیس این باید خالی از سکنه بماند.

locality

string

اختیاری. عموماً به بخش شهر/شهرک آدرس اشاره دارد. مثال: شهر ایالات متحده، کمون فناوری اطلاعات، شهر پست بریتانیا. در مناطقی از جهان که محلی ها به خوبی تعریف نشده اند یا به خوبی در این ساختار قرار نمی گیرند، محلی را خالی بگذارید و از خطوط آدرس استفاده کنید.

sublocality

string

اختیاری. موقعیت فرعی آدرس به عنوان مثال، این می تواند محله، محله، منطقه باشد.

address_ lines[]

string

مورد نیاز. خطوط آدرس بدون ساختار که سطوح پایین یک آدرس را توصیف می کند.

از آنجایی که مقادیر در address_lines اطلاعات نوع ندارند و گاهی اوقات ممکن است حاوی چندین مقدار در یک فیلد واحد باشند (به عنوان مثال "Austin, TX")، واضح بودن ترتیب خطوط مهم است. ترتیب خطوط آدرس باید "سفارش پاکت" برای کشور/منطقه آدرس باشد.

حداقل نمایش ساختاری مجاز یک آدرس شامل تمام اطلاعاتی است که در address_lines قرار داده شده است. اگر region_code ارائه نشده باشد، منطقه از خطوط آدرس استنباط می شود.

ایجاد آدرسی که فقط حاوی address_lines باشد و سپس رمزگذاری جغرافیایی روشی توصیه شده برای رسیدگی به آدرس‌های کاملاً بدون ساختار است (برخلاف حدس زدن اینکه کدام قسمت‌های آدرس باید محل‌ها یا مناطق اداری باشند).

recipients[]

string

لطفا از تنظیم این فیلد خودداری کنید. Address Validation API در حال حاضر از آن استفاده نمی کند. اگرچه در این زمان API درخواست‌های دارای مجموعه فیلد را رد نمی‌کند، اطلاعات دور ریخته می‌شوند و در پاسخ بازگردانده نمی‌شوند.

organization

string

لطفا از تنظیم این فیلد خودداری کنید. Address Validation API در حال حاضر از آن استفاده نمی کند. اگرچه در این زمان API درخواست‌های دارای مجموعه فیلد را رد نمی‌کند، اطلاعات دور ریخته می‌شوند و در پاسخ بازگردانده نمی‌شوند.