Address Validation class
google.maps.addressValidation . AddressValidation
class
کلاس ایستا برای دسترسی به AddressValidation APIها.
با فراخوانی const {AddressValidation} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
روش های استاتیک | |
---|---|
| fetchAddressValidation(request) پارامترها:
مقدار بازگشتی: Promise < AddressValidation > یک آدرس را تأیید می کند. به https://developers.google.com/maps/documentation/javascript/address-validation/validate-address مراجعه کنید. |
خواص | |
---|---|
| نوع: Address optional اطلاعات مربوط به خود آدرس بر خلاف ژئوکد. |
| نوع: Geocode optional اطلاعات مربوط به مکان و مکانی که آدرس به آن کد جغرافیایی داده است. |
| نوع: AddressMetadata optional سایر اطلاعات مربوط به قابلیت تحویل metadata برای هر آدرسی که به Address Validation API ارسال می شود، تضمین نمی شود. |
| نوع: string optional UUID که این پاسخ را شناسایی می کند. اگر آدرس نیاز به تأیید مجدد داشته باشد، این UUID باید درخواست جدید را همراهی کند. |
| نوع: USPSData optional پرچم های تحویل اضافی ارائه شده توسط USPS. فقط در منطقه US و PR ارائه شده است. |
| نوع: Verdict optional پرچم های حکم کلی |
روش ها | |
---|---|
| toJSON() پارامترها: ندارد مقدار بازگشتی: Object کلاس AddressValidation را به یک شی JSON با همان ویژگی ها تبدیل می کند. |
رابط AddressValidationRequest
google.maps.addressValidation . AddressValidationRequest
رابط google.maps.addressValidation . AddressValidationRequest
درخواست رابط برای
. AddressValidation.fetchAddressValidation
خواص | |
---|---|
| نوع: PostalAddressLiteral آدرس در حال تایید است. آدرسهای بدون قالب باید از طریق PostalAddress.addressLines ارسال شوند. |
| نوع: string optional این فیلد نباید برای اولین درخواست تأیید اعتبار آدرس تنظیم شود. اگر درخواستهای بیشتری برای اعتبارسنجی کامل یک آدرس ضروری باشد (مثلاً اگر تغییراتی که کاربر پس از تأیید اولیه انجام میدهد نیاز به تأیید مجدد داشته باشد)، هر درخواست بعدی باید این فیلد را با عبارت پر کند. از اولین پاسخ در توالی اعتبارسنجی. |
| نوع: boolean optional حالت سازگار با USPS CASS را فعال می کند. این فقط بر روی فیلد AddressValidation . توجه: برای درخواستهای دارای USPS CASS برای آدرسهایی در پورتوریکو، یک PostalAddress.regionCode address باید بهعنوان "PR" ارائه شود، یا یک PostalAddress.administrativeArea address باید بهعنوان "Puerto Rico" (بدون حروف کوچک) یا "PR" ارائه شود. |
آدرس کلاس
google.maps.addressValidation . Address
کلاس
جزئیات آدرس پس از پردازش. پس پردازش شامل تصحیح قسمت های آدرس اشتباه املایی، جایگزینی قسمت های نادرست و استنباط قسمت های گم شده است.
با فراخوانی const {Address} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
| نوع: Array < AddressComponent > اجزای آدرس منفرد آدرس فرمت شده و تصحیح شده، همراه با اطلاعات اعتبارسنجی. این اطلاعات در مورد وضعیت اعتبار سنجی اجزای جداگانه ارائه می دهد. |
| نوع: string optional آدرس پس از پردازش، به عنوان یک آدرس تک خطی با پیروی از قوانین قالببندی آدرس منطقهای که آدرس در آن قرار دارد، قالببندی شده است. |
| نوع: Array <string> انواع مؤلفه هایی که انتظار می رفت در یک آدرس پستی با فرمت صحیح وجود داشته باشند اما در ورودی و یافت نشدند قابل استنباط نیستند. اجزای این نوع در formatted_address ، postal_address ، یا address_components وجود ندارند. یک مثال ممکن است ['street_number', 'route'] برای ورودی مانند "Boulder, Colorado, 80301, USA" باشد. لیست انواع ممکن را می توان در اینجا یافت. |
| نوع: PostalAddress optional آدرس پس از پردازش به عنوان یک آدرس پستی نشان داده شده است. |
| نوع: Array <string> انواع مؤلفههایی که در address_components وجود دارند، اما صحت آنها تأیید نشد. این فیلد به منظور راحتی ارائه شده است: محتویات آن معادل تکرار از طریق address_components برای یافتن انواع همه اجزایی است که در آن نیست یا پرچم روی true تنظیم نشده است. لیست انواع ممکن را می توان در اینجا یافت. |
| نوع: Array <string> هر نشانه ای در ورودی که قابل حل نیست. این ممکن است یک ورودی باشد که به عنوان بخشی معتبر از یک آدرس شناسایی نشده باشد (برای مثال در ورودی مانند "123235253253 Main St, San Francisco, CA, 94105"، نشانه های حل نشده ممکن است مانند ["123235253253"] به نظر برسند، زیرا شبیه یک شماره خیابان معتبر نیست. |
AddressComponent کلاس
google.maps.addressValidation . AddressComponent
کلاس
نشان دهنده یک جزء واحد از یک آدرس (مثلاً نام خیابان، شهر).
با فراخوانی const {AddressComponent} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
| نوع: string optional متن نام مؤلفه به عنوان مثال، "5th Avenue" برای نام یک خیابان یا "1253" برای یک شماره خیابان، |
| نوع: string optional کد زبان BCP-47. اگر نام مؤلفه با زبانی مانند شماره خیابان مرتبط نباشد، این مورد وجود نخواهد داشت. |
| نوع: string optional نوع جزء آدرس جدول 2 را ببینید: انواع اضافی که توسط سرویس Places برگردانده شده است برای لیستی از انواع احتمالی. |
| نوع: ConfirmationLevel optional نشان دهنده میزان اطمینان از صحیح بودن جزء است. |
| نوع: boolean اگر درست باشد، این مؤلفه بخشی از ورودی نیست، بلکه برای مکان آدرس استنباط شده است. گنجاندن این جزء برای یک آدرس کامل توصیه می شود. |
| نوع: boolean نشان می دهد که نام مؤلفه با یک نام کاملاً متفاوت جایگزین شده است. به عنوان مثال، جایگزین کردن یک کد پستی اشتباه با کدی که برای آدرس صحیح است. این یک تغییر زیبایی نیست. جزء ورودی به مولفه دیگری تغییر کرده است. |
| نوع: boolean تصحیح یک غلط املایی در نام مؤلفه را نشان می دهد. API همیشه تغییرات را از یک نوع املایی به نوع دیگر، مانند "مرکز" به "مرکز" علامت گذاری نمی کند. |
| نوع: boolean اگر درست باشد، انتظار نمی رود این مؤلفه در آدرس پستی منطقه داده شده وجود داشته باشد. فقط به این دلیل حفظ شده است که بخشی از ورودی بوده است. |
کلاس AddressMetadata
google.maps.addressValidation . AddressMetadata
کلاس google.maps.addressValidation . AddressMetadata
فراداده برای آدرس. AddressMetadata برای هر آدرسی که به Address Validation API ارسال می شود، تضمین نمی شود.
با فراخوانی const {AddressMetadata} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
| نوع: boolean |
| نوع: boolean |
| نوع: boolean |
ConfirmationLevel ثابت
google.maps.addressValidation . ConfirmationLevel
ثابت
مقادیر مختلف ممکن که میزان اطمینان از صحیح بودن جزء را نشان می دهد.
با فراخوانی const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
| |
| |
|
کلاس ژئوکد
google.maps.addressValidation . Geocode
کلاس google.maps.addressValidation . Geocode
حاوی اطلاعاتی درباره مکانی است که ورودی در آن کدگذاری شده است.
با فراخوانی const {Geocode} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
| نوع: LatLngBounds optional محدوده مکان ژئوکد شده. |
| نوع: number optional اندازه مکان ژئوکد شده، بر حسب متر. این یکی دیگر از معیارهای درشت بودن مکان جغرافیایی کد شده است، اما در اندازه فیزیکی به جای معنای معنایی. |
| نوع: LatLngAltitude optional مکان جغرافیایی کد شده ورودی. |
| نوع: string optional شناسه مکان مکان جغرافیایی کد شده. استفاده از Place بر استفاده از آدرس ها، مختصات طول و عرض جغرافیایی یا کدهای بعلاوه ترجیح داده می شود. استفاده از مختصات برای مسیریابی یا محاسبه مسیرهای رانندگی همیشه باعث می شود که نقطه به نزدیکترین جاده به آن مختصات گیر کند. ممکن است این جاده ای نباشد که به سرعت یا ایمن به مقصد منتهی شود و ممکن است نزدیک یک نقطه دسترسی به ملک نباشد. علاوه بر این، هنگامی که یک مکان معکوس جغرافیایی کدگذاری می شود، هیچ تضمینی وجود ندارد که آدرس برگشتی با آدرس اصلی مطابقت داشته باشد. |
| نوع: Array <string> نوع(های) مکانی که ورودی به آن کدگذاری شده است. برای مثال، ['locality', 'political'] . لیست کامل انواع را می توان در اسناد Geocoding API یافت. |
| نوع: PlusCode optional کد مثبت مربوط به location . |
روش ها | |
---|---|
| fetchPlace() پارامترها: ندارد ارزش بازگشتی: ندارد نمایش مکانی از این ژئوکد را برمیگرداند. برای دریافت جزئیات کامل مکان، باید با ()place.fetchFields تماس بگیرید. |
ثابت دانه بندی
google.maps.addressValidation . Granularity
ثابت google.maps.addressValidation . Granularity
دانه بندی های مختلفی که یک آدرس یا یک ژئوکد می تواند داشته باشد. هنگامی که برای نشان دادن جزئیات برای یک آدرس استفاده میشود، این مقادیر نشان میدهند که آدرس تا چه اندازه یک مقصد پستی را مشخص میکند. به عنوان مثال، آدرسی مانند "123 Main Street, Redwood City, CA, 94061" یک PREMISE
را مشخص می کند در حالی که چیزی مانند "Redwood City, CA, 94061" یک LOCALITY
را مشخص می کند. با این حال، اگر نتوانیم یک ژئوکد برای "خیابان اصلی 123" در شهر ردوود پیدا کنیم، ممکن است ژئوکد ارسالی از LOCALITY
دانه بندی باشد، حتی اگر آدرس دقیق تر باشد.
با فراخوانی const {Granularity} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
| آدرس یا ژئوکد یک بلوک را نشان می دهد. فقط در مناطقی استفاده می شود که آدرس دهی در سطح بلوک دارند، مانند ژاپن. |
| همه دانهبندیهای دیگر، که در کنار هم قرار میگیرند، زیرا قابل تحویل نیستند. |
| نتیجه در سطح ساختمان |
| یک ژئوکد که موقعیت مکانی آدرس را در سطح ساختمان تقریبی می کند. |
| ژئوکد یا آدرس برای مسیر، مانند خیابان، جاده یا بزرگراه، دانهبندی است. |
| نتیجه زیر سطح ساختمان، مانند یک آپارتمان. |
کلاس آدرس USPS
google.maps.addressValidation . USPSAddress
کلاس آدرس google.maps.addressValidation . USPSAddress
نمایندگی USPS از یک آدرس ایالات متحده.
با فراخوانی const {USPSAddress} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
| نوع: string optional نام شهر. |
| نوع: string optional خط آدرس حاوی شهر، ایالت و کد پستی. |
| نوع: string optional نام شرکت. |
| نوع: string optional خط اول آدرس |
| نوع: string optional خط دوم آدرس. |
| نوع: string optional کد حالت 2 حرفی |
| نوع: string optional نام شهرنشینی پورتوریکویی |
| نوع: string optional کد پستی، به عنوان مثال "10009". |
| نوع: string optional پسوند کد پستی 4 رقمی، به عنوان مثال "5023". |
کلاس USPSData
google.maps.addressValidation . USPSData
کلاس google.maps.addressValidation . USPSData
داده های USPS برای آدرس. USPSData برای هر آدرس ایالات متحده یا روابط عمومی ارسال شده به Address Validation API تضمین نمی شود که به طور کامل پر شود. اگر از uspsData به عنوان بخش اصلی پاسخ استفاده می کنید، توصیه می شود که فیلدهای آدرس پشتیبان را در پاسخ ادغام کنید.
با فراخوانی const {USPSData} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
| نوع: string optional شهر به اختصار. |
| نوع: string optional نوع رکورد آدرسی که با آدرس ورودی مطابقت دارد. |
| نوع: string optional کد مسیر حامل یک کد چهار کاراکتری متشکل از یک پیشوند یک حرفی و یک نشانگر مسیر سه رقمی. |
| نوع: string optional نشانگر مرتبسازی نرخ مسیر حامل. |
| نوع: boolean نشانگر این است که درخواست CASS پردازش شده است. |
| نوع: string optional نام شهرستان. |
| نوع: string optional رقم بررسی نقطه تحویل این شماره برای نامه های اسکن شده مکانیکی به انتهای بارکد_point_delivery اضافه می شود. با جمع کردن تمام ارقام بارکد_نقطه_تحویل، رقم_بررسی_نقطه_تحویل، کد پستی و ZIP+4 عددی قابل تقسیم بر 10 به دست میآید. |
| نوع: string optional کد 2 رقمی نقطه تحویل |
| نوع: string optional نشان می دهد که آیا آدرس یک CMRA (آژانس دریافت نامه های تجاری) است - یک کسب و کار خصوصی که نامه دریافت می کند برای مشتریان. یک کاراکتر را برمیگرداند. |
| نوع: string optional مقادیر ممکن برای تایید DPV. یک کاراکتر را برمیگرداند یا هیچ مقداری را برمیگرداند. |
| نوع: string optional پرچم نشاندهنده آدرسهایی است که USPS نمیتواند برای تحویل نامه به درب بزند. یک کاراکتر را برمیگرداند. |
| نوع: string optional پرچم نشان میدهد که نامهها به یک مورد در یک سایت تحویل داده میشود. یک کاراکتر را برمیگرداند. |
| نوع: string optional نشان می دهد که بیش از یک کد بازگشتی DPV برای آدرس معتبر است. یک کاراکتر را برمیگرداند. |
| نوع: string optional پاورقی از اعتبار سنجی نقطه تحویل. ممکن است چندین پاورقی در یک رشته به هم متصل شوند. |
| نوع: string optional پرچم نشان می دهد که تحویل نامه در هر روز هفته انجام نمی شود. یک کاراکتر را برمیگرداند. |
| نوع: number optional تعداد صحیح شناسایی روزهای بدون تحویل با استفاده از پرچمهای بیت قابل بازجویی است: 0x40 - یکشنبه یک روز بدون تحویل است 0x20 - دوشنبه یک روز بدون تحویل است 0x10 - سهشنبه یک روز بدون تحویل است 0x08 - چهارشنبه یک روز بدون تحویل است 0x04 - پنجشنبه یک روز بدون تحویل است 0x02 روز شنبه است - جمعه یک روز بدون تحویل است 0x02 - جمعه یک روز بدون تحویل است روز |
| نوع: string optional پرچم نشان می دهد که درب قابل دسترسی است، اما بسته به دلیل نگرانی های امنیتی باقی نخواهد ماند. یک کاراکتر را برمیگرداند. |
| نوع: string optional نشان می دهد که آیا آدرس یک آدرس بدون آمار یا یک آدرس فعال است. هیچ آدرس آماری، آدرس هایی نیستند که به طور مداوم اشغال نمی شوند یا آدرس هایی که USPS سرویس نمی دهد. یک کاراکتر را برمیگرداند. |
| نوع: number optional نوع NoStat را نشان می دهد. یک کد دلیل را به عنوان int برمی گرداند. |
| نوع: string optional نشان می دهد که آدرس با رکورد PBSA مطابقت داده شده است. یک کاراکتر را برمیگرداند. |
| نوع: string optional نشان می دهد که نامه به آدرس خیابان تحویل داده نمی شود. یک کاراکتر را برمیگرداند. |
| نوع: string optional نشان می دهد که آیا آدرس خالی است یا خیر. یک کاراکتر را برمیگرداند. |
| نوع: string optional پرچم صعودی/نزولی eLOT (A/D). |
| نوع: string optional شماره خط سفر پیشرفته (eLOT). |
| نوع: string optional پیام خطا برای بازیابی اطلاعات USPS. زمانی که پردازش USPS به دلیل شناسایی آدرسهای ایجاد شده مصنوعی به حالت تعلیق در میآید، پر میشود. |
| نوع: string optional کد شهرستان FIPS. |
| نوع: boolean نشان می دهد که یک آدرس پیش فرض پیدا شده است، اما آدرس های خاص تری وجود دارد. |
| نوع: boolean آدرس تحویل قابل تطبیق است، اما فایل EWS نشان می دهد که به زودی یک تطابق دقیق در دسترس خواهد بود. |
| نوع: string optional نشانگر LACSLlink. |
| نوع: string optional کد بازگشت LACSlink. |
| نوع: string optional تعیین کننده واحد PMB (جعبه پست خصوصی). |
| نوع: string optional شماره PMB (صندوق پست خصوصی). |
| نوع: boolean کد پستی فقط صندوق پستی |
| نوع: string optional شهر پست اصلی |
| نوع: string optional ایالت اداره پست اصلی |
| نوع: USPSAddress optional آدرس استاندارد USPS |
| نوع: string optional پاورقی از تطبیق یک خیابان یا رکورد بلند با اطلاعات مجموعه. اگر نام تجاری مطابقت پیدا شود، شماره ثانویه برگردانده می شود. |
کلاس حکم
google.maps.addressValidation . Verdict
کلاس google.maps.addressValidation . Verdict
نشان دهنده آدرس پس از پردازش برای آدرس ارائه شده است.
با فراخوانی const {Verdict} = await google.maps.importLibrary("addressValidation")
دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
خواص | |
---|---|
| نوع: boolean اگر هیچ نشانه حل نشده، هیچ مؤلفه آدرس غیرمنتظره یا گم نشده ای وجود نداشته باشد، آدرس کامل در نظر گرفته می شود. اگر تنظیم نشده باشد، نشان می دهد که مقدار false است. ببینید یا فیلدهای برای جزئیات بیشتر. |
| نوع: Granularity optional اطلاعاتی در مورد جزئیات Geocode . این را می توان به عنوان معنای معنایی درشت یا ظریف بودن مکان جغرافیایی درک کرد. |
| نوع: boolean حداقل یک جزء آدرس استنباط شد (یعنی اضافه شد) که در ورودی نبود، برای جزئیات به AddressComponent مراجعه کنید. |
| نوع: boolean optional حداقل یک جزء آدرس جایگزین شد - برای جزئیات به AddressComponent مراجعه کنید. |
| نوع: boolean حداقل یک جزء آدرس را نمی توان دسته بندی یا تأیید کرد، برای جزئیات بیشتر به AddressComponent مراجعه کنید. |
| نوع: Granularity optional جزئیات آدرس ورودی این نتیجه تجزیه آدرس ورودی است و هیچ سیگنال اعتبار سنجی نمی دهد. برای سیگنالهای اعتبارسنجی، به validationGranularity مراجعه کنید. |
| نوع: Granularity optional سطح دانه بندی که API می تواند آدرس را به طور کامل تأیید کند . به عنوان مثال، validationGranularity از PREMISE نشان میدهد که تمام اجزای آدرس در سطح PREMISE و گستردهتر قابل تأیید هستند. |