Address Validation (beta)

Address Validation class

google.maps.addressValidation . AddressValidation class

کلاس ایستا برای دسترسی به AddressValidation APIها.

با فراخوانی const {AddressValidation} = await google.maps.importLibrary("addressValidation") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Beta fetchAddressValidation
fetchAddressValidation(request)
پارامترها:
مقدار بازگشتی: Promise < AddressValidation >
یک آدرس را تأیید می کند. به https://developers.google.com/maps/documentation/javascript/address-validation/validate-address مراجعه کنید.
Beta address
نوع: Address optional
اطلاعات مربوط به خود آدرس بر خلاف ژئوکد.
Beta geocode
نوع: Geocode optional
اطلاعات مربوط به مکان و مکانی که آدرس به آن کد جغرافیایی داده است.
Beta metadata
نوع: AddressMetadata optional
سایر اطلاعات مربوط به قابلیت تحویل metadata برای هر آدرسی که به Address Validation API ارسال می شود، تضمین نمی شود.
Beta responseId
نوع: string optional
UUID که این پاسخ را شناسایی می کند. اگر آدرس نیاز به تأیید مجدد داشته باشد، این UUID باید درخواست جدید را همراهی کند.
Beta uspsData
نوع: USPSData optional
پرچم های تحویل اضافی ارائه شده توسط USPS. فقط در منطقه US و PR ارائه شده است.
Beta verdict
نوع: Verdict optional
پرچم های حکم کلی
Beta toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
کلاس AddressValidation را به یک شی JSON با همان ویژگی ها تبدیل می کند.

رابط AddressValidationRequest

google.maps.addressValidation . AddressValidationRequest رابط google.maps.addressValidation . AddressValidationRequest

درخواست رابط برای Beta AddressValidation.fetchAddressValidation .

Beta address
آدرس در حال تایید است. آدرس‌های بدون قالب باید از طریق PostalAddress.addressLines ارسال شوند.
Beta previousResponseId optional
نوع: string optional
این فیلد نباید برای اولین درخواست تأیید اعتبار آدرس تنظیم شود. اگر درخواست‌های بیشتری برای اعتبارسنجی کامل یک آدرس ضروری باشد (مثلاً اگر تغییراتی که کاربر پس از تأیید اولیه انجام می‌دهد نیاز به تأیید مجدد داشته باشد)، هر درخواست بعدی باید این فیلد را با عبارت پر کند. Beta AddressValidation.responseId از اولین پاسخ در توالی اعتبارسنجی.
Beta uspsCASSEnabled optional
نوع: boolean optional
حالت سازگار با USPS CASS را فعال می کند. این فقط بر روی Beta AddressValidation.uspsData فیلد Beta AddressValidation.uspsData 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 ببینید.

Beta components
نوع: Array < AddressComponent >
اجزای آدرس منفرد آدرس فرمت شده و تصحیح شده، همراه با اطلاعات اعتبارسنجی. این اطلاعات در مورد وضعیت اعتبار سنجی اجزای جداگانه ارائه می دهد.
Beta formattedAddress
نوع: string optional
آدرس پس از پردازش، به عنوان یک آدرس تک خطی با پیروی از قوانین قالب‌بندی آدرس منطقه‌ای که آدرس در آن قرار دارد، قالب‌بندی شده است.
Beta missingComponentTypes
نوع: Array <string>
انواع مؤلفه هایی که انتظار می رفت در یک آدرس پستی با فرمت صحیح وجود داشته باشند اما در ورودی و یافت نشدند قابل استنباط نیستند. اجزای این نوع در formatted_address ، postal_address ، یا address_components وجود ندارند. یک مثال ممکن است ['street_number', 'route'] برای ورودی مانند "Boulder, Colorado, 80301, USA" باشد. لیست انواع ممکن را می توان در اینجا یافت.
Beta postalAddress
نوع: PostalAddress optional
آدرس پس از پردازش به عنوان یک آدرس پستی نشان داده شده است.
Beta unconfirmedComponentTypes
نوع: Array <string>
انواع مؤلفه‌هایی که در address_components وجود دارند، اما صحت آن‌ها تأیید نشد. این فیلد به منظور راحتی ارائه شده است: محتویات آن معادل تکرار از طریق address_components برای یافتن انواع همه اجزایی است که در آن Beta AddressComponent.confirmationLevel نیست Beta ConfirmationLevel.CONFIRMED یا Beta AddressComponent.inferred پرچم Beta AddressComponent.inferred روی true تنظیم نشده است. لیست انواع ممکن را می توان در اینجا یافت.
Beta unresolvedTokens
نوع: 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 ببینید.

Beta componentName
نوع: string optional
متن نام مؤلفه به عنوان مثال، "5th Avenue" برای نام یک خیابان یا "1253" برای یک شماره خیابان،
Beta componentNameLanguageCode
نوع: string optional
کد زبان BCP-47. اگر نام مؤلفه با زبانی مانند شماره خیابان مرتبط نباشد، این مورد وجود نخواهد داشت.
Beta componentType
نوع: string optional
Beta confirmationLevel
نوع: ConfirmationLevel optional
نشان دهنده میزان اطمینان از صحیح بودن جزء است.
Beta inferred
نوع: boolean
اگر درست باشد، این مؤلفه بخشی از ورودی نیست، بلکه برای مکان آدرس استنباط شده است. گنجاندن این جزء برای یک آدرس کامل توصیه می شود.
Beta replaced
نوع: boolean
نشان می دهد که نام مؤلفه با یک نام کاملاً متفاوت جایگزین شده است. به عنوان مثال، جایگزین کردن یک کد پستی اشتباه با کدی که برای آدرس صحیح است. این یک تغییر زیبایی نیست. جزء ورودی به مولفه دیگری تغییر کرده است.
Beta spellCorrected
نوع: boolean
تصحیح یک غلط املایی در نام مؤلفه را نشان می دهد. API همیشه تغییرات را از یک نوع املایی به نوع دیگر، مانند "مرکز" به "مرکز" علامت گذاری نمی کند.
Beta unexpected
نوع: boolean
اگر درست باشد، انتظار نمی رود این مؤلفه در آدرس پستی منطقه داده شده وجود داشته باشد. فقط به این دلیل حفظ شده است که بخشی از ورودی بوده است.

کلاس AddressMetadata

google.maps.addressValidation . AddressMetadata کلاس google.maps.addressValidation . AddressMetadata

فراداده برای آدرس. AddressMetadata برای هر آدرسی که به Address Validation API ارسال می شود، تضمین نمی شود.

با فراخوانی const {AddressMetadata} = await google.maps.importLibrary("addressValidation") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Beta business
نوع: boolean
Beta poBox
نوع: boolean
Beta residential
نوع: boolean

ConfirmationLevel ثابت

google.maps.addressValidation . ConfirmationLevel ثابت

مقادیر مختلف ممکن که میزان اطمینان از صحیح بودن جزء را نشان می دهد.

با فراخوانی const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Beta CONFIRMED
Beta UNCONFIRMED_AND_SUSPICIOUS
Beta UNCONFIRMED_BUT_PLAUSIBLE

کلاس ژئوکد

google.maps.addressValidation . Geocode کلاس google.maps.addressValidation . Geocode

حاوی اطلاعاتی درباره مکانی است که ورودی در آن کدگذاری شده است.

با فراخوانی const {Geocode} = await google.maps.importLibrary("addressValidation") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Beta bounds
نوع: LatLngBounds optional
محدوده مکان ژئوکد شده.
Beta featureSizeMeters
نوع: number optional
اندازه مکان ژئوکد شده، بر حسب متر. این یکی دیگر از معیارهای درشت بودن مکان جغرافیایی کد شده است، اما در اندازه فیزیکی به جای معنای معنایی.
Beta location
نوع: LatLngAltitude optional
مکان جغرافیایی کد شده ورودی.
Beta placeId
نوع: string optional
شناسه مکان مکان جغرافیایی کد شده. استفاده از Place بر استفاده از آدرس ها، مختصات طول و عرض جغرافیایی یا کدهای بعلاوه ترجیح داده می شود. استفاده از مختصات برای مسیریابی یا محاسبه مسیرهای رانندگی همیشه باعث می شود که نقطه به نزدیکترین جاده به آن مختصات گیر کند. ممکن است این جاده ای نباشد که به سرعت یا ایمن به مقصد منتهی شود و ممکن است نزدیک یک نقطه دسترسی به ملک نباشد. علاوه بر این، هنگامی که یک مکان معکوس جغرافیایی کدگذاری می شود، هیچ تضمینی وجود ندارد که آدرس برگشتی با آدرس اصلی مطابقت داشته باشد.
Beta placeTypes
نوع: Array <string>
نوع(های) مکانی که ورودی به آن کدگذاری شده است. برای مثال، ['locality', 'political'] . لیست کامل انواع را می توان در اسناد Geocoding API یافت.
Beta plusCode
نوع: PlusCode optional
کد مثبت مربوط به location .
Beta fetchPlace
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 ببینید.

Beta BLOCK آدرس یا ژئوکد یک بلوک را نشان می دهد. فقط در مناطقی استفاده می شود که آدرس دهی در سطح بلوک دارند، مانند ژاپن.
Beta OTHER همه دانه‌بندی‌های دیگر، که در کنار هم قرار می‌گیرند، زیرا قابل تحویل نیستند.
Beta PREMISE نتیجه در سطح ساختمان
Beta PREMISE_PROXIMITY یک ژئوکد که موقعیت مکانی آدرس را در سطح ساختمان تقریبی می کند.
Beta ROUTE ژئوکد یا آدرس برای مسیر، مانند خیابان، جاده یا بزرگراه، دانه‌بندی است.
Beta SUB_PREMISE نتیجه زیر سطح ساختمان، مانند یک آپارتمان.

کلاس آدرس USPS

google.maps.addressValidation . USPSAddress کلاس آدرس google.maps.addressValidation . USPSAddress

نمایندگی USPS از یک آدرس ایالات متحده.

با فراخوانی const {USPSAddress} = await google.maps.importLibrary("addressValidation") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Beta city
نوع: string optional
نام شهر.
Beta cityStateZipAddressLine
نوع: string optional
خط آدرس حاوی شهر، ایالت و کد پستی.
Beta firm
نوع: string optional
نام شرکت.
Beta firstAddressLine
نوع: string optional
خط اول آدرس
Beta secondAddressLine
نوع: string optional
خط دوم آدرس.
Beta state
نوع: string optional
کد حالت 2 حرفی
Beta urbanization
نوع: string optional
نام شهرنشینی پورتوریکویی
Beta zipCode
نوع: string optional
کد پستی، به عنوان مثال "10009".
Beta zipCodeExtension
نوع: 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 ببینید.

Beta abbreviatedCity
نوع: string optional
شهر به اختصار.
Beta addressRecordType
نوع: string optional
نوع رکورد آدرسی که با آدرس ورودی مطابقت دارد.
Beta carrierRoute
نوع: string optional
کد مسیر حامل یک کد چهار کاراکتری متشکل از یک پیشوند یک حرفی و یک نشانگر مسیر سه رقمی.
Beta carrierRouteIndicator
نوع: string optional
نشانگر مرتب‌سازی نرخ مسیر حامل.
Beta cassProcessed
نوع: boolean
نشانگر این است که درخواست CASS پردازش شده است.
Beta county
نوع: string optional
نام شهرستان.
Beta deliveryPointCheckDigit
نوع: string optional
رقم بررسی نقطه تحویل این شماره برای نامه های اسکن شده مکانیکی به انتهای بارکد_point_delivery اضافه می شود. با جمع کردن تمام ارقام بارکد_نقطه_تحویل، رقم_بررسی_نقطه_تحویل، کد پستی و ZIP+4 عددی قابل تقسیم بر 10 به دست می‌آید.
Beta deliveryPointCode
نوع: string optional
کد 2 رقمی نقطه تحویل
Beta dpvCMRA
نوع: string optional
نشان می دهد که آیا آدرس یک CMRA (آژانس دریافت نامه های تجاری) است - یک کسب و کار خصوصی که نامه دریافت می کند برای مشتریان. یک کاراکتر را برمی‌گرداند.
Beta dpvConfirmation
نوع: string optional
مقادیر ممکن برای تایید DPV. یک کاراکتر را برمی‌گرداند یا هیچ مقداری را برمی‌گرداند.
Beta dpvDoorNotAccessible
نوع: string optional
پرچم نشان‌دهنده آدرس‌هایی است که USPS نمی‌تواند برای تحویل نامه به درب بزند. یک کاراکتر را برمی‌گرداند.
Beta dpvDrop
نوع: string optional
پرچم نشان می‌دهد که نامه‌ها به یک مورد در یک سایت تحویل داده می‌شود. یک کاراکتر را برمی‌گرداند.
Beta dpvEnhancedDeliveryCode
نوع: string optional
نشان می دهد که بیش از یک کد بازگشتی DPV برای آدرس معتبر است. یک کاراکتر را برمی‌گرداند.
Beta dpvFootnote
نوع: string optional
پاورقی از اعتبار سنجی نقطه تحویل. ممکن است چندین پاورقی در یک رشته به هم متصل شوند.
Beta dpvNonDeliveryDays
نوع: string optional
پرچم نشان می دهد که تحویل نامه در هر روز هفته انجام نمی شود. یک کاراکتر را برمی‌گرداند.
Beta dpvNonDeliveryDaysValues
نوع: number optional
تعداد صحیح شناسایی روزهای بدون تحویل با استفاده از پرچم‌های بیت قابل بازجویی است: 0x40 - یکشنبه یک روز بدون تحویل است 0x20 - دوشنبه یک روز بدون تحویل است 0x10 - سه‌شنبه یک روز بدون تحویل است 0x08 - چهارشنبه یک روز بدون تحویل است 0x04 - پنج‌شنبه یک روز بدون تحویل است 0x02 روز شنبه است - جمعه یک روز بدون تحویل است 0x02 - جمعه یک روز بدون تحویل است روز
Beta dpvNoSecureLocation
نوع: string optional
پرچم نشان می دهد که درب قابل دسترسی است، اما بسته به دلیل نگرانی های امنیتی باقی نخواهد ماند. یک کاراکتر را برمی‌گرداند.
Beta dpvNoStat
نوع: string optional
نشان می دهد که آیا آدرس یک آدرس بدون آمار یا یک آدرس فعال است. هیچ آدرس آماری، آدرس هایی نیستند که به طور مداوم اشغال نمی شوند یا آدرس هایی که USPS سرویس نمی دهد. یک کاراکتر را برمی‌گرداند.
Beta dpvNoStatReasonCode
نوع: number optional
نوع NoStat را نشان می دهد. یک کد دلیل را به عنوان int برمی گرداند.
Beta dpvPBSA
نوع: string optional
نشان می دهد که آدرس با رکورد PBSA مطابقت داده شده است. یک کاراکتر را برمی‌گرداند.
Beta dpvThrowback
نوع: string optional
نشان می دهد که نامه به آدرس خیابان تحویل داده نمی شود. یک کاراکتر را برمی‌گرداند.
Beta dpvVacant
نوع: string optional
نشان می دهد که آیا آدرس خالی است یا خیر. یک کاراکتر را برمی‌گرداند.
Beta elotFlag
نوع: string optional
پرچم صعودی/نزولی eLOT (A/D).
Beta elotNumber
نوع: string optional
شماره خط سفر پیشرفته (eLOT).
Beta errorMessage
نوع: string optional
پیام خطا برای بازیابی اطلاعات USPS. زمانی که پردازش USPS به دلیل شناسایی آدرس‌های ایجاد شده مصنوعی به حالت تعلیق در می‌آید، پر می‌شود.
Beta fipsCountyCode
نوع: string optional
کد شهرستان FIPS.
Beta hasDefaultAddress
نوع: boolean
نشان می دهد که یک آدرس پیش فرض پیدا شده است، اما آدرس های خاص تری وجود دارد.
Beta hasNoEWSMatch
نوع: boolean
آدرس تحویل قابل تطبیق است، اما فایل EWS نشان می دهد که به زودی یک تطابق دقیق در دسترس خواهد بود.
Beta lacsLinkIndicator
نوع: string optional
نشانگر LACSLlink.
Beta lacsLinkReturnCode
نوع: string optional
کد بازگشت LACSlink.
Beta pmbDesignator
نوع: string optional
تعیین کننده واحد PMB (جعبه پست خصوصی).
Beta pmbNumber
نوع: string optional
شماره PMB (صندوق پست خصوصی).
Beta poBoxOnlyPostalCode
نوع: boolean
کد پستی فقط صندوق پستی
Beta postOfficeCity
نوع: string optional
شهر پست اصلی
Beta postOfficeState
نوع: string optional
ایالت اداره پست اصلی
Beta standardizedAddress
نوع: USPSAddress optional
آدرس استاندارد USPS
Beta suiteLinkFootnote
نوع: string optional
پاورقی از تطبیق یک خیابان یا رکورد بلند با اطلاعات مجموعه. اگر نام تجاری مطابقت پیدا شود، شماره ثانویه برگردانده می شود.

کلاس حکم

google.maps.addressValidation . Verdict کلاس google.maps.addressValidation . Verdict

نشان دهنده آدرس پس از پردازش برای آدرس ارائه شده است.

با فراخوانی const {Verdict} = await google.maps.importLibrary("addressValidation") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Beta addressComplete
نوع: boolean
اگر هیچ نشانه حل نشده، هیچ مؤلفه آدرس غیرمنتظره یا گم نشده ای وجود نداشته باشد، آدرس کامل در نظر گرفته می شود. اگر تنظیم نشده باشد، نشان می دهد که مقدار false است. ببینید Beta Address.missingComponentTypes Beta Address.unresolvedTokens یا Beta AddressComponent.unexpected فیلدهای Beta AddressComponent.unexpected برای جزئیات بیشتر.
Beta geocodeGranularity
نوع: Granularity optional
اطلاعاتی در مورد جزئیات Geocode . این را می توان به عنوان معنای معنایی درشت یا ظریف بودن مکان جغرافیایی درک کرد.
Beta hasInferredComponents
نوع: boolean
حداقل یک جزء آدرس استنباط شد (یعنی اضافه شد) که در ورودی نبود، برای جزئیات به AddressComponent مراجعه کنید.
Beta hasReplacedComponents
نوع: boolean optional
حداقل یک جزء آدرس جایگزین شد - برای جزئیات به AddressComponent مراجعه کنید.
Beta hasUnconfirmedComponents
نوع: boolean
حداقل یک جزء آدرس را نمی توان دسته بندی یا تأیید کرد، برای جزئیات بیشتر به AddressComponent مراجعه کنید.
Beta inputGranularity
نوع: Granularity optional
جزئیات آدرس ورودی این نتیجه تجزیه آدرس ورودی است و هیچ سیگنال اعتبار سنجی نمی دهد. برای سیگنال‌های اعتبارسنجی، به validationGranularity مراجعه کنید.
Beta validationGranularity
نوع: Granularity optional
سطح دانه بندی که API می تواند آدرس را به طور کامل تأیید کند . به عنوان مثال، validationGranularity از PREMISE نشان می‌دهد که تمام اجزای آدرس در سطح PREMISE و گسترده‌تر قابل تأیید هستند.