Method: validateAddress

یک آدرس را تأیید می کند.

درخواست HTTP

POST https://addressvalidation.googleapis.com/v1:validateAddress

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
زمینه های
address

object ( PostalAddress )

ضروری. آدرس در حال تایید است. آدرس‌های بدون قالب باید از طریق addressLines ارسال شوند.

طول کل فیلدهای این ورودی نباید از 280 کاراکتر تجاوز کند.

مناطق پشتیبانی شده را می توانید در اینجا پیدا کنید.

مقدار languageCode در آدرس ورودی برای استفاده های بعدی محفوظ است و امروز نادیده گرفته می شود. نتیجه آدرس تأیید شده بر اساس زبان ترجیحی برای آدرس داده شده، همانطور که توسط سیستم شناسایی شده است، پر می شود.

Address Validation API مقادیر موجود در recipients و organization را نادیده می گیرد. هر مقدار در آن فیلدها کنار گذاشته می شود و برگردانده نمی شود. لطفا آنها را تنظیم نکنید.

previousResponseId

string

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

enableUspsCass

boolean

حالت سازگار با USPS CASS را فعال می کند. این فقط فیلد google.maps.addressvalidation.v1.ValidationResult.usps_data google.maps.addressvalidation.v1.ValidationResult را تحت تأثیر قرار می دهد. توجه: برای درخواست‌های دارای USPS CASS برای آدرس‌هایی در پورتوریکو، یک address google.type.PostalAddress.region_code باید به‌عنوان "PR" ارائه شود، یا یک address google.type.PostalAddress.administrative_area باید به عنوان "Puerto" ارائه شود. ریکو" (بدون حساسیت به حروف بزرگ) یا "PR".

توصیه می شود از یک address کامپوننت شده استفاده کنید، یا حداقل دو google.type.PostalAddress.address_lines را مشخص کنید که در آن خط اول شامل شماره و نام خیابان و خط دوم شامل شهر، ایالت و کد پستی باشد.

languageOptions

object ( LanguageOptions )

اختیاری. Preview: این ویژگی در Preview (pre-GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.

Address Validation API را فعال می کند تا اطلاعات بیشتری را در پاسخ اضافه کند.

sessionToken

string

اختیاری. رشته ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می کند. باید یک URL و نام فایل ایمن رشته base64 با حداکثر 36 کاراکتر اسکی باشد. در غیر این صورت یک خطای INVALID_ARGUMENT برگردانده می شود.

جلسه زمانی شروع می شود که کاربر یک پرس و جو تکمیل خودکار انجام می دهد، و زمانی که یک مکان را انتخاب می کند و تماسی با جزئیات مکان یا اعتبارسنجی آدرس برقرار می شود، به پایان می رسد. هر جلسه می‌تواند چندین پرس‌وجو تکمیل خودکار داشته باشد و به دنبال آن یک درخواست جزییات مکان یا اعتبارسنجی آدرس ارائه شود. اعتبار استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر sessionToken حذف شود، یا اگر از یک نشانه جلسه استفاده مجدد کنید، هزینه جلسه به گونه ای محاسبه می شود که گویی هیچ نشانه جلسه ارائه نشده است (هر درخواست جداگانه صورتحساب می شود).

توجه: اعتبار آدرس فقط در جلسات با API تکمیل خودکار (جدید) قابل استفاده است، نه API تکمیل خودکار. برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/session-pricing مراجعه کنید.

بدن پاسخگو

پاسخ به یک درخواست اعتبار سنجی آدرس.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
زمینه های
result

object ( ValidationResult )

نتیجه اعتبار سنجی آدرس

responseId

string

UUID که این پاسخ را شناسایی می کند. اگر آدرس نیاز به تأیید مجدد داشته باشد، این UUID باید درخواست جدید را همراهی کند.

آدرس پستی

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

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

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

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

نمایندگی JSON
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
زمینه های
revision

integer

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

regionCode

string

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

languageCode

string

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

postalCode

string

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

sortingCode

string

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

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

گزینه های زبان

Preview: این ویژگی در Preview (pre-GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.

Address Validation API را فعال می کند تا اطلاعات بیشتری را در پاسخ اضافه کند.

نمایندگی JSON
{
  "returnEnglishLatinAddress": boolean
}
زمینه های
returnEnglishLatinAddress

boolean

پیش نمایش: یک google.maps.addressvalidation.v1.Address را به انگلیسی برگردانید. برای جزئیات به google.maps.addressvalidation.v1.ValidationResult.english_latin_address مراجعه کنید.

نتیجه اعتبارسنجی

نتیجه اعتبارسنجی یک آدرس

نمایندگی JSON
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
زمینه های
verdict

object ( Verdict )

پرچم های حکم کلی

address

object ( Address )

اطلاعات مربوط به خود آدرس بر خلاف ژئوکد.

geocode

object ( Geocode )

اطلاعات مربوط به مکان و مکانی که آدرس به آن کد جغرافیایی داده است.

metadata

object ( AddressMetadata )

سایر اطلاعات مربوط به قابلیت تحویل metadata برای هر آدرسی که به Address Validation API ارسال می شود، تضمین نمی شود.

uspsData

object ( UspsData )

پرچم های تحویل اضافی ارائه شده توسط USPS. فقط در منطقه US و PR ارائه شده است.

englishLatinAddress

object ( Address )

Preview: این ویژگی در Preview (pre-GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.

آدرس به انگلیسی ترجمه شده است.

آدرس های ترجمه شده به عنوان ورودی API قابل استفاده مجدد نیستند. این سرویس آنها را فراهم می کند تا کاربر بتواند از زبان مادری خود برای تأیید یا رد اعتبار آدرس ارائه شده اصلی استفاده کند.

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

این خروجی را با استفاده از پرچم google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address فعال کنید.

توجه: فیلد google.maps.addressvalidation.v1.Address.unconfirmed_component_types در englishLatinAddress و فیلدهای google.maps.addressvalidation.v1.AddressComponent.confirmation_level در englishLatinAddress.address_components پر نشده است.

حکم

نمای کلی سطح بالا از نتیجه اعتبارسنجی آدرس و کد جغرافیایی.

نمایندگی JSON
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}
زمینه های
inputGranularity

enum ( Granularity )

جزئیات آدرس ورودی این نتیجه تجزیه آدرس ورودی است و هیچ سیگنال اعتبار سنجی نمی دهد. برای سیگنال‌های اعتبارسنجی، به validationGranularity زیر مراجعه کنید.

به عنوان مثال، اگر آدرس ورودی شامل یک شماره آپارتمان خاص باشد، در اینجا inputGranularity SUB_PREMISE خواهد بود. اگر نتوانیم شماره آپارتمان را در پایگاه‌های اطلاعاتی مطابقت دهیم یا شماره آپارتمان نامعتبر باشد، validationGranularity احتمالا PREMISE یا پایین‌تر خواهد بود.

validationGranularity

enum ( Granularity )

سطح دانه بندی که API می تواند آدرس را به طور کامل تأیید کند . به عنوان مثال، validationGranularity از PREMISE نشان می دهد که تمام اجزای آدرس در سطح PREMISE یا بیشتر درشت می توانند اعتبار سنجی شوند.

نتیجه تأیید مؤلفه هر آدرس را می‌توانید در google.maps.addressvalidation.v1.Address.address_components پیدا کنید.

geocodeGranularity

enum ( Granularity )

اطلاعات در مورد دانه بندی geocode . این را می توان به عنوان معنای معنایی درشت یا ظریف بودن مکان جغرافیایی درک کرد.

این ممکن است با validationGranularity بالا گاهی اوقات متفاوت باشد. به عنوان مثال، پایگاه داده ما ممکن است وجود یک شماره آپارتمان را ثبت کند اما مکان دقیقی برای آپارتمان در یک مجتمع آپارتمانی بزرگ نداشته باشد. در آن صورت، validationGranularity SUB_PREMISE خواهد بود اما geocodeGranularity PREMISE خواهد بود.

addressComplete

boolean

اگر هیچ نشانه حل نشده، هیچ مؤلفه آدرس غیرمنتظره یا گم نشده ای وجود نداشته باشد، آدرس کامل در نظر گرفته می شود. اگر تنظیم نشده باشد، نشان می دهد که مقدار false است. برای جزئیات بیشتر به missingComponentTypes ، unresolvedTokens یا فیلدهای unexpected مراجعه کنید.

hasUnconfirmedComponents

boolean

حداقل یک جزء آدرس را نمی توان طبقه بندی یا تأیید کرد، برای جزئیات به google.maps.addressvalidation.v1.Address.address_components مراجعه کنید.

hasInferredComponents

boolean

حداقل یک جزء آدرس استنباط شد (اضافه شد) که در ورودی نبود، برای جزئیات به google.maps.addressvalidation.v1.Address.address_components مراجعه کنید.

hasReplacedComponents

boolean

حداقل یک جزء آدرس جایگزین شده است، برای جزئیات به google.maps.addressvalidation.v1.Address.address_components مراجعه کنید.

دانه دانه بودن

دانه بندی های مختلفی که یک آدرس یا یک ژئوکد می تواند داشته باشد. هنگامی که برای نشان دادن جزئیات برای یک آدرس استفاده می‌شود، این مقادیر نشان می‌دهند که آدرس تا چه اندازه یک مقصد پستی را مشخص می‌کند. به عنوان مثال، آدرسی مانند "123 Main Street, Redwood City, CA, 94061" یک PREMISE مشخص می کند در حالی که چیزی مانند "Redwood City, CA, 94061" یک LOCALITY مشخص می کند. با این حال، اگر نتوانیم یک ژئوکد برای "خیابان اصلی 123" در شهر ردوود پیدا کنیم، ممکن است ژئوکد ارسالی از LOCALITY دانه بندی باشد، حتی اگر آدرس دقیق تر باشد.

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

نشانی

جزئیات آدرس پس از پردازش. پس پردازش شامل تصحیح قسمت های آدرس اشتباه املایی، جایگزینی قسمت های نادرست و استنباط قسمت های گم شده است.

نمایندگی JSON
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
زمینه های
formattedAddress

string

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

postalAddress

object ( PostalAddress )

آدرس پس از پردازش به عنوان یک آدرس پستی نشان داده شده است.

addressComponents[]

object ( AddressComponent )

لیست نامرتب. اجزای آدرس منفرد آدرس فرمت شده و تصحیح شده، همراه با اطلاعات اعتبارسنجی. این اطلاعات در مورد وضعیت اعتبار سنجی اجزای جداگانه ارائه می دهد.

اجزای آدرس به روش خاصی مرتب نمی شوند. هیچ گونه فرضی در مورد ترتیب اجزای آدرس در لیست انجام ندهید.

missingComponentTypes[]

string

انواع مؤلفه هایی که انتظار می رفت در یک آدرس پستی با فرمت صحیح وجود داشته باشند اما در ورودی و یافت نشدند قابل استنباط نیستند. مؤلفه‌های این نوع در formattedAddress ، postalAddress ، یا addressComponents وجود ندارند. یک مثال ممکن است ['street_number', 'route'] برای ورودی مانند "Boulder, Colorado, 80301, USA" باشد. لیست انواع ممکن را می توان در اینجا یافت.

unconfirmedComponentTypes[]

string

انواع مؤلفه‌هایی که در addressComponents وجود دارند، اما صحت آنها تأیید نشد. این فیلد به منظور راحتی ارائه شده است: محتویات آن معادل تکرار از طریق addressComponents برای یافتن انواع همه مؤلفه‌هایی است که در آن confirmationLevel CONFIRMED نشده است یا پرچم inferred روی true تنظیم نشده است. لیست انواع ممکن را می توان در اینجا یافت.

unresolvedTokens[]

string

هر نشانه ای در ورودی که قابل حل نیست. ممکن است این ورودی باشد که به عنوان بخشی معتبر از یک آدرس شناسایی نشده باشد (برای مثال در ورودی مانند "123235253253 Main St, San Francisco, CA, 94105"، نشانه های حل نشده ممکن است مانند ["123235253253"] به نظر برسند. شبیه یک شماره خیابان معتبر نیست.

Address Component

نشان دهنده یک جزء آدرس، مانند یک خیابان، شهر یا ایالت است.

نمایندگی JSON
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
زمینه های
componentName

object ( ComponentName )

نام این جزء

componentType

string

نوع جزء آدرس جدول 2 را ببینید: انواع اضافی که توسط سرویس Places برگردانده شده است برای لیستی از انواع احتمالی.

confirmationLevel

enum ( ConfirmationLevel )

نشان دهنده میزان اطمینانی است که ما در مورد صحیح بودن مؤلفه داریم.

inferred

boolean

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

spellCorrected

boolean

تصحیح یک غلط املایی در نام مؤلفه را نشان می دهد. API همیشه تغییرات را از یک نوع املایی به دیگری علامت گذاری نمی کند، مانند زمانی که "مرکز" به "مرکز" تغییر می کند. همچنین همیشه اشتباهات املایی رایج را علامت گذاری نمی کند، مانند زمانی که "Amphitheatre Pkwy" را به "Amphitheatre Pkwy" تغییر می دهید.

replaced

boolean

نشان می دهد که نام مؤلفه با یک نام کاملاً متفاوت جایگزین شده است، به عنوان مثال یک کد پستی اشتباه با کدی که برای آدرس صحیح است جایگزین شده است. این یک تغییر زیبایی نیست، جزء ورودی به دیگری تغییر کرده است.

unexpected

boolean

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

نام قطعه

یک لفاف برای نام جزء.

نمایندگی JSON
{
  "text": string,
  "languageCode": string
}
زمینه های
text

string

متن نام. به عنوان مثال، "5th Avenue" برای نام یک خیابان یا "1253" برای یک شماره خیابان.

languageCode

string

کد زبان BCP-47. اگر نام مؤلفه با زبانی مانند شماره خیابان مرتبط نباشد، این مورد وجود نخواهد داشت.

سطح تایید

مقادیر مختلف ممکن برای سطوح تایید.

Enums
CONFIRMATION_LEVEL_UNSPECIFIED مقدار پیش فرض. این مقدار استفاده نشده است.
CONFIRMED ما توانستیم تأیید کنیم که این مؤلفه در زمینه بقیه آدرس وجود دارد و منطقی است.
UNCONFIRMED_BUT_PLAUSIBLE این مؤلفه قابل تأیید نیست، اما وجود آن قابل قبول است. به عنوان مثال، یک شماره خیابان در محدوده معتبر شناخته شده اعداد در خیابانی که شماره خانه های خاصی در آن مشخص نیست.
UNCONFIRMED_AND_SUSPICIOUS این مؤلفه تأیید نشد و احتمالاً اشتباه است. مثلا محله ای که به بقیه آدرس نمی خورد.

ژئوکد

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

نمایندگی JSON
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
زمینه های
location

object ( LatLng )

مکان جغرافیایی کد شده ورودی.

استفاده از شناسه‌های مکان بر استفاده از آدرس‌ها، مختصات طول و عرض جغرافیایی یا کدهای بعلاوه ترجیح داده می‌شود. استفاده از مختصات هنگام مسیریابی یا محاسبه مسیرهای رانندگی همیشه باعث می شود که نقطه به نزدیکترین جاده به آن مختصات گیر کند. ممکن است این جاده ای نباشد که به سرعت یا ایمن به مقصد منتهی شود و ممکن است نزدیک یک نقطه دسترسی به ملک نباشد. علاوه بر این، هنگامی که یک مکان معکوس جغرافیایی کدگذاری می شود، هیچ تضمینی وجود ندارد که آدرس برگشتی با آدرس اصلی مطابقت داشته باشد.

plusCode

object ( PlusCode )

کد مثبت مربوط به location .

bounds

object ( Viewport )

محدوده مکان ژئوکد شده.

featureSizeMeters

number

اندازه مکان ژئوکد شده، بر حسب متر. این یکی دیگر از معیارهای درشت بودن مکان جغرافیایی کد شده است، اما در اندازه فیزیکی به جای معنای معنایی.

placeId

string

شناسه مکان مکانی که این ورودی به آن کد جغرافیایی می‌دهد.

برای اطلاعات بیشتر درباره شناسه‌های مکان اینجا را ببینید.

placeTypes[]

string

نوع(های) مکانی که ورودی به آن کدگذاری شده است. برای مثال، ['locality', 'political'] . لیست کامل انواع را می توان در اینجا یافت.

LatLng

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

نمایندگی JSON
{
  "latitude": number,
  "longitude": number
}
زمینه های
latitude

number

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

longitude

number

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

پلاس کد

کد پلاس ( http://plus.codes ) یک مرجع مکان با دو قالب است: کد جهانی که مستطیل 14mx14m (1/8000 درجه) یا کوچکتر را تعریف می کند و کد ترکیبی که پیشوند را با یک مکان مرجع جایگزین می کند.

نمایندگی JSON
{
  "globalCode": string,
  "compoundCode": string
}
زمینه های
globalCode

string

کد جهانی (کامل) مکان، مانند "9FWM33GV+HQ"، که یک منطقه 1/8000 در 1/8000 درجه (~14 در 14 متر) را نشان می دهد.

compoundCode

string

کد ترکیبی Place، مانند "33GV+HQ، Ramberg، Norway"، حاوی پسوند کد جهانی و جایگزینی پیشوند با نام قالب بندی شده یک نهاد مرجع.

درگاه دید

یک نمای طول و عرض جغرافیایی که به صورت دو نقطه low و high به صورت مورب در مقابل هم نمایش داده می شود. یک viewport یک منطقه بسته در نظر گرفته می شود، یعنی شامل مرز آن می شود. محدوده عرض جغرافیایی باید بین 90- تا 90 درجه باشد و محدوده طول جغرافیایی باید بین 180- تا 180 درجه باشد. موارد مختلف عبارتند از:

  • اگر low = high ، نمای از همان نقطه واحد تشکیل شده است.

  • اگر low.longitude > high.longitude , محدوده طول معکوس می شود (نمایش از خط طول جغرافیایی 180 درجه عبور می کند).

  • اگر low.longitude = -180 درجه و high.longitude = 180 درجه باشد، درگاه دید شامل تمام طول‌های جغرافیایی می‌شود.

  • اگر low.longitude = 180 درجه و high.longitude = -180 درجه باشد، محدوده طول جغرافیایی خالی است.

  • اگر low.latitude > high.latitude ، محدوده عرض جغرافیایی خالی است.

هر دو low و high باید پر شوند و کادر نمایش داده شده نمی تواند خالی باشد (همانطور که در تعاریف بالا مشخص شده است). یک نمای خالی منجر به خطا می شود.

به عنوان مثال، این نما به طور کامل شهر نیویورک را در بر می گیرد:

{ "low": { "Latitude": 40.477398, "Litude": -74.259087 }, "high": { "Latitude": 40.91618, "Latitude": -73.70018 } }

نمایندگی JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
زمینه های
low

object ( LatLng )

ضروری. نقطه پایین دید.

high

object ( LatLng )

ضروری. نقطه اوج دید.

AddressMetadata

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

نمایندگی JSON
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
زمینه های
business

boolean

نشان می دهد که این آدرس یک کسب و کار است. اگر تنظیم نشده باشد، نشان دهنده ناشناخته بودن مقدار است.

poBox

boolean

نشان می دهد که آدرس یک صندوق پستی. اگر تنظیم نشده باشد، نشان دهنده ناشناخته بودن مقدار است.

residential

boolean

نشان می دهد که این آدرس یک محل سکونت است. اگر تنظیم نشده باشد، نشان دهنده ناشناخته بودن مقدار است.

UspsData

داده های USPS برای آدرس. uspsData برای هر آدرس ایالات متحده یا روابط عمومی ارسال شده به Address Validation API تضمین نمی شود که به طور کامل پر شود. اگر از uspsData به عنوان بخش اصلی پاسخ استفاده می کنید، توصیه می شود که فیلدهای آدرس پشتیبان را در پاسخ ادغام کنید.

نمایندگی JSON
{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}
زمینه های
standardizedAddress

object ( UspsAddress )

آدرس استاندارد USPS

deliveryPointCode

string

کد نقطه تحویل 2 رقمی

deliveryPointCheckDigit

string

رقم بررسی نقطه تحویل این شماره برای نامه های اسکن شده مکانیکی به انتهای بارکد_point_delivery اضافه می شود. با جمع کردن تمام ارقام delivery_point_barcode، deliveryPointCheckDigit، کد پستی و ZIP+4 باید عددی قابل بخش بر 10 به دست آید.

dpvConfirmation

string

مقادیر ممکن برای تایید DPV. یک کاراکتر را برمی‌گرداند یا هیچ مقداری را برمی‌گرداند.

  • N : اطلاعات اعداد اولیه و ثانویه تأیید DPV نشد.
  • D : آدرس فقط برای شماره اولیه DPV تأیید شد و اطلاعات شماره ثانویه وجود نداشت.
  • S : آدرس فقط برای شماره اولیه DPV تأیید شد و اطلاعات شماره ثانویه موجود بود اما تأیید نشد.
  • Y : آدرس DPV برای شماره های اولیه و ثانویه تایید شد.
  • خالی: اگر پاسخ حاوی مقدار dpvConfirmation نباشد، آدرس برای تأیید DPV ارسال نشده است.
dpvFootnote

string

پاورقی از اعتبار سنجی نقطه تحویل. ممکن است چندین پاورقی در یک رشته به هم متصل شوند.

  • AA : آدرس ورودی با فایل ZIP+4 مطابقت دارد
  • A1 : آدرس ورودی با فایل ZIP+4 مطابقت نداشت
  • BB : مطابق با DPV (همه اجزا)
  • CC : شماره ثانویه مطابقت ندارد و لازم نیست
  • C1 : شماره ثانویه مطابقت ندارد اما لازم است
  • N1 : آدرس بلند مرتبه فاقد شماره ثانویه است
  • M1 : شماره اولیه وجود ندارد
  • M3 : شماره اصلی نامعتبر است
  • P1 : آدرس ورودی PO، RR یا شماره جعبه HC موجود نیست
  • P3 : آدرس ورودی PO، RR یا شماره جعبه HC نامعتبر است
  • F1 : آدرس ورودی مطابق با یک آدرس نظامی است
  • G1 : آدرس ورودی با یک آدرس تحویل عمومی مطابقت دارد
  • U1 : آدرس ورودی مطابق با یک کد پستی منحصر به فرد
  • PB : آدرس ورودی با رکورد PBSA مطابقت دارد
  • RR : آدرس تأیید شده توسط DPV با اطلاعات PMB
  • R1 : آدرس تایید شده DPV بدون اطلاعات PMB
  • R7 : رکورد مسیر حامل R777 یا R779
  • IA : آدرس آگاه شناسایی شد
  • TA : عدد اولیه با حذف یک آلفای انتهایی مطابقت دارد
dpvCmra

string

نشان می دهد که آیا آدرس یک CMRA (آژانس دریافت نامه های تجاری) است - یک کسب و کار خصوصی که نامه دریافت می کند برای مشتریان. یک کاراکتر را برمی‌گرداند.

  • Y : آدرس یک CMRA است
  • N : آدرس یک CMRA نیست
dpvVacant

string

آیا این مکان خالی است؟ یک کاراکتر را برمی‌گرداند.

  • Y : آدرس خالی است
  • N : آدرس خالی نیست
dpvNoStat

string

آیا این یک آدرس بدون آمار است یا یک آدرس فعال؟ هیچ آدرس آماری، آدرس هایی نیستند که به طور مداوم اشغال نمی شوند یا آدرس هایی که USPS سرویس نمی دهد. یک کاراکتر را برمی‌گرداند.

  • Y : آدرس فعال نیست
  • N : آدرس فعال است
dpvNoStatReasonCode

integer

نوع NoStat را نشان می دهد. یک کد دلیل را به عنوان int برمی گرداند.

  • 1 : IDA (Internal Drop Address) - آدرس هایی که ایمیل را مستقیماً از USPS دریافت نمی کنند اما به آدرس drop تحویل داده می شوند که به آنها خدمات ارائه می دهد.
  • 2 : CDS - آدرس هایی که هنوز قابل تحویل نیستند. به عنوان مثال، یک بخش فرعی جدید که در آن قطعات و اعداد اولیه تعیین شده است، اما هنوز ساختاری برای اشغال وجود ندارد.
  • 3 : برخورد - آدرس هایی که در واقع DPV را تأیید نمی کنند.
  • 4 : CMZ (کالج، نظامی و انواع دیگر) - ZIP + 4 رکورد USPS در داده ها گنجانده شده است.
  • 5 : معمولی - نشان دهنده آدرس هایی است که تحویل دریافت نمی کنند و آدرس ها به عنوان تحویل های احتمالی محاسبه نمی شوند.
  • 6 : ثانویه مورد نیاز - آدرس به اطلاعات ثانویه نیاز دارد.
dpvDrop

string

پرچم نشان می‌دهد که نامه‌ها به یک مورد در یک سایت تحویل داده می‌شود. یک کاراکتر را برمی‌گرداند.

  • Y : نامه به یک نفر در یک سایت تحویل داده می شود.
  • N : نامه به یک فرد قابل دریافت در یک سایت تحویل داده نمی شود.
dpvThrowback

string

نشان می دهد که نامه به آدرس خیابان تحویل داده نمی شود. یک کاراکتر را برمی‌گرداند.

  • Y : نامه به آدرس خیابان تحویل داده نمی شود.
  • N : نامه به آدرس خیابان تحویل داده می شود.
dpvNonDeliveryDays

string

پرچم نشان می دهد که تحویل نامه در هر روز هفته انجام نمی شود. یک کاراکتر را برمی‌گرداند.

  • Y : تحویل پست هر روز هفته انجام نمی شود.
  • N : هیچ نشانه ای وجود ندارد که تحویل نامه در هر روز هفته انجام نمی شود.
dpvNonDeliveryDaysValues

integer

تعداد صحیح شناسایی روزهای بدون تحویل می توان آن را با استفاده از پرچم های بیت بازجویی کرد: 0x40 - یکشنبه یک روز بدون تحویل است 0x20 - دوشنبه یک روز بدون تحویل است 0x10 - سه شنبه یک روز بدون تحویل است 0x08 - چهارشنبه یک روز بدون تحویل است 0x04 - پنجشنبه یک روز غیر تحویل است -روز تحویل 0x02 - جمعه یک روز بدون تحویل است 0x01 - شنبه یک روز بدون تحویل است

dpvNoSecureLocation

string

پرچم نشان می دهد که درب قابل دسترسی است، اما بسته به دلیل نگرانی های امنیتی باقی نخواهد ماند. یک کاراکتر را برمی‌گرداند.

  • Y : بسته به دلیل نگرانی های امنیتی باقی نخواهد ماند.
  • N : هیچ نشانه ای وجود ندارد که بسته به دلیل نگرانی های امنیتی باقی نخواهد ماند.
dpvPbsa

string

نشان می دهد که آدرس با رکورد PBSA مطابقت داده شده است. یک کاراکتر را برمی‌گرداند.

  • Y : آدرس با رکورد PBSA مطابقت داشت.
  • N : آدرس با رکورد PBSA مطابقت نداشت.
dpvDoorNotAccessible

string

پرچم نشان‌دهنده آدرس‌هایی است که USPS نمی‌تواند برای تحویل نامه به درب بزند. یک کاراکتر را برمی‌گرداند.

  • Y : در قابل دسترس نیست.
  • N : هیچ نشانه ای وجود ندارد که درب قابل دسترسی نیست.
dpvEnhancedDeliveryCode

string

نشان می دهد که بیش از یک کد بازگشتی DPV برای آدرس معتبر است. یک کاراکتر را برمی‌گرداند.

  • Y : آدرس DPV برای شماره های اولیه و ثانویه تایید شد.
  • N : اطلاعات اعداد اولیه و ثانویه تأیید DPV نشد.
  • S : آدرس فقط برای شماره اولیه DPV تأیید شد، و اطلاعات شماره ثانویه موجود بود اما تأیید نشد، یا یک آلفای انتهایی روی یک شماره اولیه حذف شد تا مطابقت DPV و اطلاعات ثانویه مورد نیاز باشد.
  • D : آدرس فقط برای شماره اولیه DPV تأیید شد و اطلاعات شماره ثانویه وجود نداشت.
  • R : آدرس تأیید شده است اما به مسیر فانتوم R777 و R779 اختصاص داده شده است و تحویل USPS ارائه نشده است.
carrierRoute

string

کد مسیر حامل یک کد چهار کاراکتری متشکل از یک پیشوند یک حرفی و یک نشانگر مسیر سه رقمی.

پیشوندها:

  • C : مسیر حامل (یا مسیر شهری)
  • R : مسیر روستایی
  • H : مسیر قرارداد بزرگراه
  • B : بخش صندوق پست
  • G : واحد تحویل عمومی
carrierRouteIndicator

string

نشانگر مرتب‌سازی نرخ مسیر حامل.

ewsNoMatch

boolean

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

postOfficeCity

string

شهر پست اصلی

postOfficeState

string

ایالت اداره پست اصلی

abbreviatedCity

string

شهر به اختصار.

fipsCountyCode

string

کد شهرستان FIPS.

county

string

نام شهرستان.

elotNumber

string

شماره خط سفر پیشرفته (eLOT).

elotFlag

string

پرچم صعودی/نزولی eLOT (A/D).

poBoxOnlyPostalCode

boolean

کد پستی فقط صندوق پستی

pmbDesignator

string

تعیین کننده واحد PMB (جعبه پست خصوصی).

pmbNumber

string

شماره PMB (صندوق پست خصوصی)؛

addressRecordType

string

نوع رکورد آدرسی که با آدرس ورودی مطابقت دارد.

  • F : FIRM. این تطبیق با یک سابقه شرکت است، که بهترین سطح تطابق موجود برای یک آدرس است.
  • G : تحویل عمومی. این یک مسابقه با رکورد تحویل عمومی است.
  • H : ساختمان / آپارتمان. این یک تطابق با رکورد ساختمان یا آپارتمان است.
  • P : صندوق پستی. این مطابق با صندوق پستی است.
  • R : قرارداد مسیر روستایی یا بزرگراه: این مطابق با رکورد یک مسیر روستایی یا یک قرارداد بزرگراه است، که هر دو ممکن است محدوده‌های Box Number مرتبط داشته باشند.
  • S : STREET RECORD: این تطبیق با یک رکورد خیابانی است که دارای محدوده اعداد اولیه معتبر است.
defaultAddress

boolean

نشان می دهد که یک آدرس پیش فرض پیدا شده است، اما آدرس های خاص تری وجود دارد.

errorMessage

string

پیام خطا برای بازیابی اطلاعات USPS. زمانی که پردازش USPS به دلیل شناسایی آدرس‌های ایجاد شده مصنوعی به حالت تعلیق در می‌آید، پر می‌شود.

فیلدهای داده USPS ممکن است در صورت وجود این خطا پر نشوند.

cassProcessed

boolean

نشانگر این است که درخواست CASS پردازش شده است.

آدرس Usps

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

نمایندگی JSON
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
زمینه های
firstAddressLine

string

خط اول آدرس

firm

string

نام شرکت.

secondAddressLine

string

خط آدرس دوم

urbanization

string

نام شهرنشینی پورتوریکویی

cityStateZipAddressLine

string

شهر + ایالت + کد پستی.

city

string

نام شهر.

state

string

کد دولتی 2 حرفی

zipCode

string

کد پستی به عنوان مثال 10009.

zipCodeExtension

string

پسوند کد پستی 4 رقمی به عنوان مثال 5023.

،

یک آدرس را تأیید می کند.

درخواست HTTP

POST https://addressvalidation.googleapis.com/v1:validateAddress

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
زمینه های
address

object ( PostalAddress )

ضروری. آدرس در حال تایید است. آدرس‌های بدون قالب باید از طریق addressLines ارسال شوند.

طول کل فیلدهای این ورودی نباید از 280 کاراکتر تجاوز کند.

مناطق پشتیبانی شده را می توانید در اینجا پیدا کنید.

مقدار languageCode در آدرس ورودی برای استفاده های بعدی محفوظ است و امروز نادیده گرفته می شود. نتیجه آدرس تأیید شده بر اساس زبان ترجیحی برای آدرس داده شده، همانطور که توسط سیستم شناسایی شده است، پر می شود.

Address Validation API مقادیر موجود در recipients و organization را نادیده می گیرد. هر مقدار در آن فیلدها کنار گذاشته می شود و برگردانده نمی شود. لطفا آنها را تنظیم نکنید.

previousResponseId

string

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

enableUspsCass

boolean

حالت سازگار با USPS CASS را فعال می کند. این فقط فیلد google.maps.addressvalidation.v1.ValidationResult.usps_data google.maps.addressvalidation.v1.ValidationResult را تحت تأثیر قرار می دهد. توجه: برای درخواست‌های دارای USPS CASS برای آدرس‌هایی در پورتوریکو، یک address google.type.PostalAddress.region_code باید به‌عنوان "PR" ارائه شود، یا یک address google.type.PostalAddress.administrative_area باید به عنوان "Puerto" ارائه شود. ریکو" (بدون حساسیت به حروف بزرگ) یا "PR".

توصیه می شود از یک address کامپوننت شده استفاده کنید، یا حداقل دو google.type.PostalAddress.address_lines را مشخص کنید که در آن خط اول شامل شماره و نام خیابان و خط دوم شامل شهر، ایالت و کد پستی باشد.

languageOptions

object ( LanguageOptions )

اختیاری. Preview: این ویژگی در Preview (pre-GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.

Address Validation API را فعال می کند تا اطلاعات بیشتری را در پاسخ اضافه کند.

sessionToken

string

اختیاری. رشته ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می کند. باید یک URL و نام فایل ایمن رشته base64 با حداکثر 36 کاراکتر اسکی باشد. در غیر این صورت یک خطای INVALID_ARGUMENT برگردانده می شود.

جلسه زمانی شروع می شود که کاربر یک پرس و جو تکمیل خودکار انجام می دهد، و زمانی که یک مکان را انتخاب می کند و تماسی با جزئیات مکان یا اعتبارسنجی آدرس برقرار می شود، به پایان می رسد. هر جلسه می‌تواند چندین پرس‌وجو تکمیل خودکار داشته باشد و به دنبال آن یک درخواست جزییات مکان یا اعتبارسنجی آدرس ارائه شود. اعتبار استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر sessionToken حذف شود ، یا اگر از یک جلسه جلسه استفاده مجدد می کنید ، جلسه به نظر می رسد که هیچ نشانه ای از جلسه ارائه نشده است (هر درخواست به طور جداگانه صورتحساب می شود).

توجه: اعتبارسنجی آدرس فقط در جلسات با API خودکار (جدید) قابل استفاده است ، نه API خودکار. برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/session-pricing مراجعه کنید.

بدن پاسخ

پاسخ به درخواست اعتبارسنجی آدرس.

در صورت موفقیت ، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
زمینه های
result

object ( ValidationResult )

نتیجه اعتبارسنجی آدرس.

responseId

string

UUID که این پاسخ را مشخص می کند. اگر آدرس نیاز به اعتبار مجدد داشته باشد ، این UUID باید با درخواست جدید همراه باشد.

آدرس پستی

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

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

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

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

نمایندگی JSON
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
زمینه های
revision

integer

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

regionCode

string

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

languageCode

string

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

postalCode

string

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

sortingCode

string

اختیاری. کد مرتب سازی اضافی ، خاص کشور. این در بیشتر مناطق استفاده نمی شود. در جایی که از آن استفاده می شود ، مقدار یا رشته ای مانند "Cedex" است ، به صورت اختیاری به دنبال یک شماره (به عنوان مثال "Cedex 7") یا فقط یک شماره ، نمایانگر "کد بخش" (جامائیکا) ، "نشانگر منطقه تحویل" است. (مالاوی) یا "نشانگر اداره پست" (به عنوان مثال Côte d'Ivoire).

administrativeArea

string

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

locality

string

اختیاری. به طور کلی به بخش شهر/شهر آدرس اشاره دارد. نمونه ها: شهر ایالات متحده ، IT Comune ، UK Post Town. در مناطقی از جهان که محلی ها به خوبی تعریف نشده اند یا به خوبی در این ساختار قرار نمی گیرند ، محل را خالی بگذارید و از خطوط آدرس استفاده کنید.

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

زبان زبانی

پیش نمایش: این ویژگی در پیش نمایش (پیش GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.

API اعتبارسنجی آدرس را قادر می سازد تا اطلاعات اضافی را در پاسخ درج کند.

نمایندگی JSON
{
  "returnEnglishLatinAddress": boolean
}
زمینه های
returnEnglishLatinAddress

boolean

پیش نمایش: یک google.maps.addressvalidation.v1.Address را به زبان انگلیسی برگردانید. برای جزئیات بیشتر به google.maps.addressvalidation.v1.ValidationResult.english_latin_address مراجعه کنید.

اعتبار سنجی

نتیجه اعتبارسنجی یک آدرس.

نمایندگی JSON
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
زمینه های
verdict

object ( Verdict )

پرچم های حکم کلی

address

object ( Address )

اطلاعات مربوط به خود آدرس بر خلاف GeoCode.

geocode

object ( Geocode )

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

metadata

object ( AddressMetadata )

سایر اطلاعات مربوط به تحویل. metadata تضمین نمی شود که برای هر آدرس ارسال شده به API اعتبارسنجی آدرس کاملاً جمع شود.

uspsData

object ( UspsData )

پرچم های تحویل اضافی ارائه شده توسط USPS. فقط در منطقه US و PR ارائه شده است.

englishLatinAddress

object ( Address )

پیش نمایش: این ویژگی در پیش نمایش (پیش GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.

آدرس ترجمه شده به انگلیسی.

آدرس های ترجمه شده به عنوان ورودی API قابل استفاده مجدد نیستند. این سرویس آنها را فراهم می کند تا کاربر بتواند از زبان مادری خود برای تأیید یا انکار اعتبار آدرس اصلی ارائه شده استفاده کند.

اگر بخشی از آدرس دارای ترجمه انگلیسی نباشد ، این سرویس آن قسمت را به یک زبان متناوب باز می گرداند که از یک اسکریپت لاتین استفاده می کند. برای توضیح نحوه انتخاب زبان متناوب اینجا را ببینید. اگر بخشی از آدرس هیچ ترجمه یا ترجمه ای به زبانی که از یک اسکریپت لاتین استفاده می کند ، ندارد ، این سرویس آن قسمت را به زبان محلی مرتبط با آدرس باز می گرداند.

این خروجی را با استفاده از google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address فعال کنید.

توجه: قسمت google.maps.addressvalidation.v1.Address.unconfirmed_component_types در englishLatinAddress و google.maps.addressvalidation.v1.AddressComponent.confirmation_level در englishLatinAddress.address_components جمع نمی شوند.

حکم

نمای کلی سطح بالا از نتیجه اعتبارسنجی آدرس و GeoCode.

نمایندگی JSON
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}
زمینه های
inputGranularity

enum ( Granularity )

دانه بندی آدرس ورودی . این نتیجه تجزیه و تحلیل آدرس ورودی است و هیچ سیگنال اعتبار سنجی نمی دهد. برای سیگنال های اعتبار سنجی ، به validationGranularity زیر مراجعه کنید.

به عنوان مثال ، اگر آدرس ورودی شامل یک شماره آپارتمان خاص باشد ، در این صورت inputGranularity SUB_PREMISE خواهد بود. اگر نتوانیم با شماره آپارتمان در پایگاه داده ها مطابقت داشته باشیم یا شماره آپارتمان نامعتبر باشد ، validationGranularity احتمالاً PREMISE یا پایین تر خواهد بود.

validationGranularity

enum ( Granularity )

سطح دانه ای که API می تواند آدرس را به طور کامل تأیید کند . به عنوان مثال ، validationGranularity PREMISE نشان می دهد که کلیه مؤلفه های آدرس در سطح PREMISE یا درشت تر می توانند تأیید شوند.

نتیجه اعتبار سنجی مؤلفه آدرس را می توان در google.maps.addressvalidation.v1.Address.address_components یافت.

geocodeGranularity

enum ( Granularity )

اطلاعات مربوط به دانه بندی geocode . این را می توان به عنوان معنای معنایی از مکان درشت یا خوب مکان جغرافیایی درک کرد.

این می تواند متفاوت از validationGranularity فوق العاده باشد. به عنوان مثال ، پایگاه داده ما ممکن است وجود یک شماره آپارتمان را ثبت کند اما مکان دقیقی برای آپارتمان در یک مجتمع بزرگ آپارتمان ندارد. در این حالت ، validationGranularity SUB_PREMISE خواهد بود اما geocodeGranularity PREMISE خواهد بود.

addressComplete

boolean

در صورت عدم وجود نشانه های حل نشده ، هیچ مؤلفه آدرس غیر منتظره یا گمشده ، آدرس کامل در نظر گرفته می شود. در صورت عدم استفاده ، نشان می دهد که مقدار false است. برای اطلاعات بیشتر ، missingComponentTypes ، unresolvedTokens یا زمینه های unexpected را مشاهده کنید.

hasUnconfirmedComponents

boolean

حداقل یک مؤلفه آدرس را نمی توان طبقه بندی یا تأیید کرد ، برای جزئیات بیشتر به google.maps.addressvalidation.v1.Address.address_components مراجعه کنید.

hasInferredComponents

boolean

حداقل یک مؤلفه آدرس استنباط شد (اضافه شده) که در ورودی نبود ، برای جزئیات بیشتر به google.maps.addressvalidation.v1.Address.address_components مراجعه کنید.

hasReplacedComponents

boolean

حداقل یک مؤلفه آدرس جایگزین شد ، برای جزئیات بیشتر به google.maps.addressvalidation.v1.Address.address_components مراجعه کنید.

دانه دانه بودن

دانه های مختلفی که یک آدرس یا یک ژئوکد می تواند داشته باشد. هنگامی که برای نشان دادن دانه بندی برای یک آدرس استفاده می شود ، این مقادیر نشان می دهد که چگونه یک دانه بندی خوب آدرس یک مقصد پستی را مشخص می کند. به عنوان مثال ، آدرس مانند "خیابان 123 اصلی ، شهر ردوود ، کالیفرنیا ، 94061" PREMISE را مشخص می کند در حالی که چیزی مانند "Redwood City ، CA ، 94061" یک LOCALITY مشخص می کند. با این حال ، اگر ما نتوانیم یک جغرافیایی را برای "خیابان 123 اصلی" در شهر ردوود پیدا کنیم ، Geocode برگشت یافته ممکن است از گرانول بودن LOCALITY باشد ، حتی اگر این آدرس گرانول تر باشد.

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

نشانی

جزئیات آدرس پس از پردازش. پردازش پس از آن شامل تصحیح قسمت های غلط املایی ، جایگزینی قطعات نادرست و استنباط قطعات مفقود شده است.

نمایندگی JSON
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
زمینه های
formattedAddress

string

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

postalAddress

object ( PostalAddress )

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

addressComponents[]

object ( AddressComponent )

لیست نامرتب. مؤلفه های آدرس فردی آدرس فرمت شده و اصلاح شده ، به همراه اطلاعات اعتبار سنجی. این اطلاعات در مورد وضعیت اعتبار سنجی مؤلفه های فردی را ارائه می دهد.

مؤلفه های آدرس به روشی خاص سفارش داده نمی شوند. هیچ فرضیه ای در مورد سفارش اجزای آدرس در لیست انجام ندهید.

missingComponentTypes[]

string

انواع مؤلفه هایی که انتظار می رفت در یک آدرس پستی به درستی فرمت شده وجود داشته باشد اما در ورودی یافت نشد و قابل استنباط نیست. مؤلفه های این نوع در formattedAddress ، postalAddress یا addressComponents موجود نیستند. یک مثال ممکن است ['street_number', 'route'] برای ورودی مانند "بولدر ، کلرادو ، 80301 ، ایالات متحده" باشد. لیست انواع ممکن را می توان در اینجا یافت.

unconfirmedComponentTypes[]

string

انواع مؤلفه هایی که در addressComponents وجود دارد اما نمی تواند صحیح باشد. این زمینه به خاطر راحتی ارائه شده است: محتوای آن معادل تکرار از طریق addressComponents است تا انواع اجزای موجود در آن را پیدا کنید که در آن confirmationLevel CONFIRMED نشده یا پرچم inferred بر روی true تنظیم نشده است. لیست انواع ممکن را می توان در اینجا یافت.

unresolvedTokens[]

string

هر نشانه ای در ورودی که قابل حل نیست. این ممکن است ورودی باشد که به عنوان یک قسمت معتبر از یک آدرس شناخته نشده باشد (به عنوان مثال در ورودی مانند "123235253253 Main ST ، سان فرانسیسکو ، کالیفرنیا ، 94105" ، نشانه های حل نشده ممکن است مانند ["123235253253"] به نظر برسد. شبیه شماره خیابان معتبر نیست.

مؤلفه

نمایانگر یک مؤلفه آدرس مانند خیابان ، شهر یا ایالت است.

نمایندگی JSON
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
زمینه های
componentName

object ( ComponentName )

نام این مؤلفه.

componentType

string

نوع مؤلفه آدرس. به جدول 2 مراجعه کنید: انواع اضافی که توسط سرویس مکان ها برای لیستی از انواع ممکن برگردانده شده است .

confirmationLevel

enum ( ConfirmationLevel )

نشان می دهد سطح یقین که ما در مورد این مؤلفه صحیح است.

inferred

boolean

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

spellCorrected

boolean

نشان دهنده تصحیح اشتباه غلط در نام مؤلفه است. API همیشه تغییرات را از یک نوع املا به دیگری تغییر نمی دهد ، مانند هنگام تغییر "مرکز" به "مرکز". همچنین همیشه غلط غلط های مشترک را پرچم نمی کند ، مانند هنگام تغییر "آمفی تئاتر PKWY" به "آمفی تئاتر PKWY".

replaced

boolean

نشان می دهد که نام این مؤلفه با یک مورد کاملاً متفاوت جایگزین شده است ، به عنوان مثال یک کد پستی اشتباه با یک مورد مناسب برای آدرس جایگزین می شود. این یک تغییر آرایشی نیست ، مؤلفه ورودی به بخش دیگری تغییر یافته است.

unexpected

boolean

یک مؤلفه آدرس را نشان می دهد که انتظار نمی رود در یک آدرس پستی برای منطقه مشخص وجود داشته باشد. ما فقط به این دلیل که بخشی از ورودی بود ، آن را حفظ کرده ایم.

نام قطعه

بسته بندی برای نام مؤلفه.

نمایندگی JSON
{
  "text": string,
  "languageCode": string
}
زمینه های
text

string

متن نام به عنوان مثال ، "خیابان 5" برای نام خیابان یا "1253" برای شماره خیابان.

languageCode

string

کد زبان BCP-47. اگر نام مؤلفه با زبانی مانند شماره خیابان همراه نباشد ، این امر وجود نخواهد داشت.

سطح تأیید

مقادیر مختلف ممکن برای سطح تأیید.

Enums
CONFIRMATION_LEVEL_UNSPECIFIED مقدار پیش فرض. این مقدار بلااستفاده است.
CONFIRMED ما توانستیم تأیید کنیم که این مؤلفه در زمینه بقیه آدرس وجود دارد.
UNCONFIRMED_BUT_PLAUSIBLE این مؤلفه قابل تأیید نیست ، اما قابل قبول است که وجود دارد. به عنوان مثال ، یک شماره خیابانی در یک محدوده معتبر شناخته شده در خیابان در خیابان که شماره های خاص خانه مشخص نیست.
UNCONFIRMED_AND_SUSPICIOUS این مؤلفه تأیید نشده و احتمالاً اشتباه خواهد بود. به عنوان مثال ، محله ای که متناسب با بقیه آدرس نیست.

ژئوکد

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

نمایندگی JSON
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
زمینه های
location

object ( LatLng )

محل جغرافیایی ورودی.

استفاده از شناسه های مکان بیش از استفاده از آدرس ها ، مختصات عرض جغرافیایی/طول جغرافیایی یا کدهای به علاوه ترجیح داده می شود. استفاده از مختصات هنگام مسیریابی یا محاسبه جهت های رانندگی ، همیشه منجر به این خواهد شد که به جاده نزدیکترین به آن مختصات برسد. این ممکن است جاده ای نباشد که به سرعت یا با خیال راحت به مقصد منتهی شود و ممکن است در نزدیکی نقطه دسترسی به ملک نباشد. علاوه بر این ، هنگامی که یک مکان معکوس Geocoded است ، هیچ تضمینی وجود ندارد که آدرس برگشتی با اصل مطابقت داشته باشد.

plusCode

object ( PlusCode )

کد به علاوه مربوط به location .

bounds

object ( Viewport )

مرزهای مکان جغرافیایی.

featureSizeMeters

number

اندازه مکان جغرافیایی ، در متر. این یکی دیگر از معیارهای درشت مکان جغرافیایی است ، اما در اندازه فیزیکی و نه به معنای معنایی.

placeId

string

مکانید مکانی که این ورودی جغرافیایی می کند.

برای اطلاعات بیشتر در مورد شناسه های مکان ، اینجا را ببینید.

placeTypes[]

string

نوع (های) مکانی که ورودی از آن استفاده می کند. به عنوان مثال ، ['locality', 'political'] . لیست کامل انواع را می توان در اینجا یافت.

لنگه

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

نمایندگی JSON
{
  "latitude": number,
  "longitude": number
}
زمینه های
latitude

number

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

longitude

number

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

کد

کد به علاوه ( http://plus.codes ) یک مرجع مکان با دو قالب است: کد جهانی تعریف یک 14MX14M (1/8000 درجه درجه) یا مستطیل کوچکتر و کد مرکب ، جایگزین پیشوند با یک مکان مرجع.

نمایندگی JSON
{
  "globalCode": string,
  "compoundCode": string
}
زمینه های
globalCode

string

کد جهانی (کامل) مکان ، مانند "9FWM33GV+HQ" ، نماینده 1/8000 در منطقه 1/8000 درجه (14 پوند در 14 متر).

compoundCode

string

کد مرکب Place مانند "33GV+HQ ، RAMBERG ، نروژ" ، حاوی پسوند کد جهانی و جایگزین کردن پیشوند با نام فرمت یک موجود مرجع.

درگاه دید

نمای عرضه طول و عرض جغرافیایی ، که به عنوان دو مورب مخالف نقاط low و high نشان داده شده است. منظره یک منطقه بسته در نظر گرفته می شود ، یعنی مرز آن را شامل می شود. مرزهای عرض جغرافیایی باید بین -90 تا 90 درجه فراگیر باشد و مرزهای طول جغرافیایی باید بین -180 تا 180 درجه فراگیر باشد. موارد مختلف شامل:

  • اگر low = high ، نمای از همان نقطه واحد تشکیل شده است.

  • اگر low.longitude > high.longitude , محدوده طول معکوس می شود (نمایش از خط طول جغرافیایی 180 درجه عبور می کند).

  • اگر low.longitude = -180 درجه و high.longitude = 180 درجه باشد، درگاه دید شامل تمام طول‌های جغرافیایی می‌شود.

  • اگر low.longitude = 180 درجه و high.longitude = -180 درجه باشد، محدوده طول جغرافیایی خالی است.

  • اگر low.latitude > high.latitude ، محدوده عرض جغرافیایی خالی است.

هر دو low و high باید جمع شوند ، و جعبه نماینده نمی تواند خالی باشد (همانطور که توسط تعاریف فوق مشخص شده است). نمای خالی منجر به خطایی خواهد شد.

به عنوان مثال، این نما به طور کامل شهر نیویورک را در بر می گیرد:

{"کم": {"عرض جغرافیایی": 40.477398 ، "طول جغرافیایی": -74.259087} ، "بالا": {"عرض جغرافیایی": 40.91618 ، "طول": -73.70018}}}

نمایندگی JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
زمینه های
low

object ( LatLng )

ضروری. نقطه پایین منظره.

high

object ( LatLng )

ضروری. نقطه مرتفع منظره.

سخنرانی

ابرداده برای آدرس. metadata تضمین نمی شود که برای هر آدرس ارسال شده به API اعتبارسنجی آدرس کاملاً جمع شود.

نمایندگی JSON
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
زمینه های
business

boolean

نشان می دهد که این آدرس یک تجارت است. در صورت عدم استفاده ، نشان می دهد که مقدار ناشناخته است.

poBox

boolean

نشان می دهد که آدرس یک جعبه PO است. در صورت عدم استفاده ، نشان می دهد که مقدار ناشناخته است.

residential

boolean

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

uspsdata

داده های USPS برای آدرس. uspsData تضمین نمی شود که برای همه ایالات متحده یا آدرس روابط عمومی ارسال شده به API اعتبارسنجی آدرس کاملاً جمع شود. در صورت استفاده از USPSDATA به عنوان قسمت اصلی پاسخ ، توصیه می شود زمینه های آدرس پشتیبان را در پاسخ ادغام کنید.

نمایندگی JSON
{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}
زمینه های
standardizedAddress

object ( UspsAddress )

آدرس استاندارد USPS.

deliveryPointCode

string

کد نقطه تحویل 2 رقمی

deliveryPointCheckDigit

string

رقم بررسی نقطه تحویل. این شماره برای نامه های اسکن شده مکانیکی به انتهای تحویل_point_barcode اضافه می شود. اضافه کردن تمام رقم های تحویل_point_barcode ، تحویل pointCheckDigit ، کد پستی و ZIP+4 با هم باید یک عدد قابل تقسیم تا 10 باشد.

dpvConfirmation

string

مقادیر ممکن برای تأیید DPV. یک شخصیت واحد را برمی گرداند یا هیچ ارزش را برمی گرداند.

  • N : اطلاعات اولیه و هر شماره ثانویه در DPV تأیید نشد.
  • D : آدرس DPV فقط برای شماره اصلی تأیید شد و اطلاعات شماره ثانویه از دست رفته بود.
  • S : آدرس DPV فقط برای شماره اصلی تأیید شد ، و اطلاعات شماره ثانویه موجود بود اما تأیید نشده است.
  • Y : آدرس DPV برای شماره های اولیه و ثانویه تأیید شد.
  • خالی: اگر پاسخ حاوی مقدار dpvConfirmation نباشد ، آدرس برای تأیید DPV ارسال نشده است.
dpvFootnote

string

پاورقی ها از اعتبارسنجی نقطه تحویل. پاورقی های چندگانه ممکن است در همان رشته با هم جمع شوند.

  • AA : آدرس ورودی با پرونده ZIP+4 مطابقت دارد
  • A1 : آدرس ورودی با پرونده ZIP+4 مطابقت نداشت
  • BB : مطابق با DPV (همه مؤلفه ها)
  • CC : تعداد ثانویه مطابقت ندارد و لازم نیست
  • C1 : تعداد ثانویه مطابقت ندارد اما مورد نیاز است
  • N1 : آدرس بالایی که شماره ثانویه وجود ندارد
  • M1 : تعداد اولیه از دست رفته است
  • M3 : شماره اولیه نامعتبر است
  • P1 : آدرس ورودی PO ، RR یا شماره جعبه HC از دست رفته است
  • P3 : آدرس ورودی PO ، RR یا شماره جعبه HC نامعتبر است
  • F1 : آدرس ورودی با یک آدرس نظامی مطابقت دارد
  • G1 : آدرس ورودی با یک آدرس تحویل عمومی مطابقت دارد
  • U1 : آدرس ورودی با یک کد پستی منحصر به فرد مطابقت دارد
  • PB : آدرس ورودی با رکورد PBSA مطابقت دارد
  • RR : آدرس DPV با اطلاعات PMB تأیید شد
  • R1 : DPV آدرس تأیید شده بدون اطلاعات PMB
  • R7 : رکورد حامل مسیر R777 یا R779
  • IA : آدرس آگاهانه شناسایی شده است
  • TA : شماره اصلی با رها کردن یک آلفا دنباله دار مطابقت دارد
dpvCmra

string

نشان می دهد که آیا آدرس یک CMRA است (آژانس دریافت کننده نامه تجاری)-یک مشاغل خصوصی که برای مشتری نامه دریافت می کند. یک شخصیت واحد را برمی گرداند.

  • Y : آدرس CMRA است
  • N : آدرس CMRA نیست
dpvVacant

string

آیا این مکان خالی است؟ یک شخصیت واحد را برمی گرداند.

  • Y : آدرس خالی است
  • N : آدرس خالی نیست
dpvNoStat

string

آیا این یک آدرس stat یا آدرس فعال است؟ هیچ آدرس آماری مواردی نیست که به طور مداوم اشغال نشده باشد یا آدرس هایی را که USPS ارائه نمی دهد ، آدرس دهد. یک شخصیت واحد را برمی گرداند.

  • Y : آدرس فعال نیست
  • N : آدرس فعال است
dpvNoStatReasonCode

integer

نوع نوستات را نشان می دهد. یک کد دلیل را به عنوان int برمی گرداند.

  • 1 : IDA (آدرس افت داخلی) - آدرس هایی که مستقیماً از طریق USP ها نامه دریافت نمی کنند اما به آدرس قطره ای که به آنها خدمات می دهد تحویل داده می شوند.
  • 2 : CDS - آدرس هایی که هنوز تحویل داده نشده اند. به عنوان مثال ، یک زیر مجموعه جدید که تعداد زیادی از آنها و تعداد اصلی مشخص شده است ، اما هنوز هیچ ساختاری برای اشغال وجود ندارد.
  • 3 : برخورد - آدرس هایی که در واقع DPV نیستند.
  • 4 : CMZ (کالج ، نظامی و انواع دیگر) - ZIP + 4 سوابق USPS در داده ها گنجانیده شده است.
  • 5 : منظم - آدرس های دریافت کننده تحویل را نشان می دهد و آدرس ها به عنوان زایمان های احتمالی شمرده نمی شوند.
  • 6 : مورد نیاز ثانویه - آدرس به اطلاعات ثانویه نیاز دارد.
dpvDrop

string

پرچم نشان می دهد که نامه به یک گیرنده در یک سایت تحویل داده می شود. یک شخصیت واحد را برمی گرداند.

  • Y : نامه به یک گیرنده در یک سایت تحویل داده می شود.
  • N : نامه به یک گیرنده در یک سایت تحویل داده نمی شود.
dpvThrowback

string

نشان می دهد که نامه به آدرس خیابان تحویل داده نمی شود. یک شخصیت واحد را برمی گرداند.

  • Y : نامه به آدرس خیابان تحویل داده نمی شود.
  • N : نامه به آدرس خیابان تحویل داده می شود.
dpvNonDeliveryDays

string

پرچم نشان می دهد که تحویل نامه هر روز از هفته انجام نمی شود. یک شخصیت واحد را برمی گرداند.

  • Y : تحویل نامه هر روز از هفته انجام نمی شود.
  • N : هیچ نشانه ای از تحویل نامه هر روز از هفته انجام نمی شود.
dpvNonDeliveryDaysValues

integer

عدد صحیح شناسایی روزهای غیر تحویل. با استفاده از پرچم های بیت قابل بازجویی است: 0x40-یکشنبه یک روز غیر تحویل 0x20 است-دوشنبه یک روز غیر تحویل 0x10 است-سه شنبه یک روز غیر تحویل 0x08 است-چهارشنبه یک روز غیر تحویل 0x04 است-پنجشنبه غیر است -روز تحویل 0x02-جمعه یک روز غیر تحویل 0x01 است-شنبه یک روز غیر تحویل است

dpvNoSecureLocation

string

پرچم نشان می دهد که درب در دسترس است ، اما به دلیل نگرانی های امنیتی ، بسته باقی نمی ماند. یک شخصیت واحد را برمی گرداند.

  • Y : بسته به دلیل نگرانی های امنیتی باقی نمی ماند.
  • N : هیچ نشانه ای از بسته به دلیل نگرانی های امنیتی باقی نمی ماند.
dpvPbsa

string

نشان می دهد که آدرس با رکورد PBSA مطابقت داشت. یک شخصیت واحد را برمی گرداند.

  • Y : آدرس با رکورد PBSA مطابقت داشت.
  • N : آدرس با رکورد PBSA مطابقت نداشت.
dpvDoorNotAccessible

string

پرچم آدرس هایی را نشان می دهد که USPS برای تحویل نامه نمی تواند در را بکشد. یک شخصیت واحد را برمی گرداند.

  • Y : درب در دسترس نیست.
  • N : هیچ نشانه ای در دسترس نیست.
dpvEnhancedDeliveryCode

string

نشان می دهد که بیش از یک کد بازگشت DPV برای آدرس معتبر است. یک شخصیت واحد را برمی گرداند.

  • Y : آدرس DPV برای شماره های اولیه و ثانویه تأیید شد.
  • N : اطلاعات اولیه و هر شماره ثانویه در DPV تأیید نشد.
  • S : آدرس فقط برای شماره اصلی DPV تأیید شد ، و اطلاعات شماره ثانویه در حال حاضر وجود داشت اما تأیید نشده بود ، یا یک آلفا دنباله دار روی یک شماره اصلی کاهش یافت تا یک مسابقه DPV و اطلاعات ثانویه مورد نیاز باشد.
  • D : آدرس DPV فقط برای شماره اصلی تأیید شد و اطلاعات شماره ثانویه از دست رفته بود.
  • R : آدرس تأیید شده اما به مسیر فانتوم R777 و R779 و تحویل USPS اختصاص داده شده است.
carrierRoute

string

کد مسیر حامل. یک کد چهار کاراکتر متشکل از پیشوند یک حرف و یک طراح مسیر سه رقمی.

پیشوندها:

  • C : مسیر حامل (یا مسیر شهر)
  • R : مسیر روستایی
  • H : مسیر قرارداد بزرگراه
  • B : بخش صندوق پستی
  • G : واحد تحویل عمومی
carrierRouteIndicator

string

نشانگر مرتب سازی نرخ مسیر حامل.

ewsNoMatch

boolean

آدرس تحویل قابل مطابقت است ، اما پرونده EWS نشان می دهد که یک مسابقه دقیق به زودی در دسترس خواهد بود.

postOfficeCity

string

اداره اصلی اداره پست.

postOfficeState

string

ایالت اصلی اداره پست.

abbreviatedCity

string

شهر مختصر.

fipsCountyCode

string

کد شهرستان FIPS.

county

string

نام شهرستان

elotNumber

string

شماره پیشرفته خط سفر (ELOT).

elotFlag

string

پرچم صعودی/نزولی (A/D).

poBoxOnlyPostalCode

boolean

فقط کد پستی جعبه PO.

pmbDesignator

string

PMB (جعبه پستی خصوصی) طراح واحد.

pmbNumber

string

شماره PMB (جعبه پستی خصوصی) شماره ؛

addressRecordType

string

نوع ضبط آدرس که مطابق با آدرس ورودی است.

  • F : محکم. این یک مسابقه با یک رکورد محکم است که بهترین سطح مسابقه برای یک آدرس است.
  • G : تحویل عمومی. این مسابقه با یک رکورد تحویل عمومی است.
  • H : ساختمان / آپارتمان. این مسابقه با یک ساختمان یا رکورد آپارتمان است.
  • P : صندوق پستی. این مسابقه با یک صندوق پستی است.
  • R : مسیر روستایی یا قرارداد بزرگراه: این یک مسابقه برای یک مسیر روستایی یا یک رکورد قرارداد بزرگراه است که هر دو ممکن است دارای تعداد جعبه های مرتبط باشند.
  • S : Street Record: این یک مسابقه با یک رکورد خیابانی است که حاوی دامنه شماره اصلی معتبر است.
defaultAddress

boolean

نشانگر مبنی بر یافتن آدرس پیش فرض ، اما آدرس های خاص تری وجود دارد.

errorMessage

string

پیام خطا برای بازیابی داده های USPS. این امر در شرایطی جمع می شود که پردازش USPS به دلیل تشخیص آدرس های مصنوعی ایجاد شده به حالت تعلیق در می آید.

قسمتهای داده USPS ممکن است در صورت وجود این خطا جمع نشود.

cassProcessed

boolean

نشانگر این است که درخواست CASS پردازش شده است.

uspsaddress

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

نمایندگی JSON
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
زمینه های
firstAddressLine

string

خط آدرس اول.

firm

string

نام شرکت.

secondAddressLine

string

خط آدرس دوم.

urbanization

string

نام شهرنشینی پورتوریکو.

cityStateZipAddressLine

string

شهر + ایالت + کد پستی.

city

string

نام شهر.

state

string

2 کد دولت.

zipCode

string

کد پستی به عنوان مثال 10009.

zipCodeExtension

string

پسوند کد پستی 4 رقمی EG 5023.