Address Validation (beta)

AddressValidation class

google.maps.addressValidation.AddressValidation sınıf

AddressValidation API'lerine erişmek için statik sınıf.

const {AddressValidation} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
fetchAddressValidation
fetchAddressValidation(request)
Parametreler: 
İade Değeri:  Promise<AddressValidation>
Bir adresi doğrular. https://developers.google.com/maps/documentation/javascript/address-validation/validate-address adresini ziyaret edin.
address
Tür:  Address optional
Coğrafi kodun aksine adresin kendisiyle ilgili bilgiler.
geocode
Tür:  Geocode optional
Adresin coğrafi kodunun oluşturulduğu konum ve yer hakkında bilgi.
metadata
Tür:  AddressMetadata optional
Teslim edilebilirlikle ilgili diğer bilgiler. metadata, Adres Doğrulama API'sine gönderilen her adres için tam olarak doldurulacağı garanti edilmez.
responseId
Tür:  string optional
Bu yanıtı tanımlayan UUID. Adresin yeniden doğrulanması gerekiyorsa bu UUID, yeni istekle birlikte gönderilmelidir.
uspsData
Tür:  USPSData optional
USPS tarafından sağlanan ek teslim edilebilirlik işaretleri. Yalnızca US ve PR bölgesinde sağlanır.
verdict
Tür:  Verdict optional
Genel değerlendirme işaretleri
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  Object
AddressValidation sınıfını aynı özelliklere sahip bir JSON nesnesine dönüştürür.

AddressValidationRequest arayüzü

google.maps.addressValidation.AddressValidationRequest arayüz

AddressValidation.fetchAddressValidation için istek arayüzü.
address
Adres doğrulanıyor. Biçimlendirilmemiş adresler PostalAddress.addressLines üzerinden gönderilmelidir.
placeAutocompleteElement optional
Tür:  PlaceAutocompleteElement optional
PlaceAutocompleteElement kullanıyorsanız AddressValidation API çağrılarını otomatik tamamlama oturum jetonuyla bağlamak için buraya ekleyin.
previousResponseId optional
Tür:  string optional
Bu alan, ilk adres doğrulama isteği için ayarlanmamalıdır. Tek bir adresin tam olarak doğrulanması için daha fazla istek gerekliyse (örneğin, kullanıcının ilk doğrulamanın ardından yaptığı değişikliklerin yeniden doğrulanması gerekiyorsa) her takip isteği bu alanı doğrulama sırasındaki ilk yanıttan alınan AddressValidation.responseId ile doldurmalıdır.
sessionToken optional
Tür:  AutocompleteSessionToken optional
Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan jeton.
uspsCASSEnabled optional
Tür:  boolean optional
USPS CASS uyumlu modu etkinleştirir. Bu durum AddressValidation öğesinin yalnızca AddressValidation.uspsData alanını etkiler. Not: Porto Riko'daki adresler için USPS CASS etkinleştirilmiş isteklerde, address'nın PostalAddress.regionCode değeri "PR" olarak veya address'nın PostalAddress.administrativeArea değeri "Puerto Rico" (büyük/küçük harf duyarsız) veya "PR" olarak sağlanmalıdır.

Address class

google.maps.addressValidation.Address sınıf

İşlem sonrası adresin ayrıntıları. İşleme sonrası, adresin yanlış yazılmış kısımlarını düzeltmeyi, yanlış kısımları değiştirmeyi ve eksik kısımları tahmin etmeyi içerir.

const {Address} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
components
Biçimlendirilmiş ve düzeltilmiş adresin tek tek adres bileşenleri ve doğrulama bilgileri. Bu, tek tek bileşenlerin doğrulama durumu hakkında bilgi sağlar.
formattedAddress
Tür:  string optional
Adresin bulunduğu bölgenin adres biçimlendirme kurallarına göre tek satırlık adres olarak biçimlendirilmiş, işlenmiş adres.
missingComponentTypes
Tür:  Array<string>
Doğru biçimlendirilmiş bir posta adresinde bulunması beklenen ancak girişte bulunmayan VE tahmin edilemeyen bileşen türleri. Bu türdeki bileşenler formatted_address, postal_address veya address_components içinde bulunmaz. Örneğin, "Boulder, Colorado, 80301, ABD" gibi bir giriş için ['street_number', 'route'] olabilir. Olası türlerin listesini burada bulabilirsiniz.
postalAddress
Tür:  PostalAddress optional
Sonradan işlenmiş adres, posta adresi olarak gösterilir.
unconfirmedComponentTypes
Tür:  Array<string>
address_components içinde bulunan ancak doğru olduğu onaylanamayan bileşen türleri. Bu alan kolaylık sağlamak amacıyla sunulur: İçeriği, address_components içinde yineleme yaparak AddressComponent.confirmationLevel değerinin ConfirmationLevel.CONFIRMED olmadığı veya AddressComponent.inferred işaretinin true olarak ayarlanmadığı tüm bileşen türlerini bulmaya eşdeğerdir. Olası türlerin listesini burada bulabilirsiniz.
unresolvedTokens
Tür:  Array<string>
Girişte çözümlenemeyen jetonlar. Bu, adresin geçerli bir parçası olarak tanınmayan bir giriş olabilir (örneğin, "123235253253 Main St, San Francisco, CA, 94105" gibi bir girişte, çözümlenmemiş jetonlar geçerli bir bina numarası gibi görünmediğinden ["123235253253"] şeklinde olabilir).

AddressComponent class

google.maps.addressValidation.AddressComponent sınıf

Bir adresin tek bir bileşenini (ör. sokak adı, şehir) temsil eder.

const {AddressComponent} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
componentName
Tür:  string optional
Bileşen adı metni. Örneğin, sokak adı için "5. Cadde" veya bina numarası için "1253"
componentNameLanguageCode
Tür:  string optional
BCP-47 dil kodu. Bileşen adı bir dille ilişkilendirilmemişse (ör. bina numarası) bu alan bulunmaz.
componentType
Tür:  string optional
Adres bileşeninin türü. Olası türlerin listesi için Tablo 2: Yerler hizmeti tarafından döndürülen ek türler'e bakın.
confirmationLevel
Tür:  ConfirmationLevel optional
Bileşenin doğru olduğuna dair kesinlik düzeyini gösterir.
inferred
Tür:  boolean
Doğruysa bu bileşen girişte yer almamış ancak adres konumu için tahmin edilmiştir. Tam adres için bu bileşenin eklenmesi önerilir.
replaced
Tür:  boolean
Bileşenin adının tamamen farklı bir adla değiştirildiğini gösterir. Örneğin, yanlış posta kodunu adres için doğru olanla değiştirme. Bu, görünümle ilgili bir değişiklik değildir. Giriş bileşeni farklı bir bileşenle değiştirilmiştir.
spellCorrected
Tür:  boolean
Bileşen adındaki yazım hatasının düzeltildiğini gösterir. API, bir yazım varyantından diğerine yapılan değişiklikleri (ör. "centre"dan "center"a) her zaman işaretlemez.
unexpected
Tür:  boolean
Bu özellik doğruysa bu bileşenin, belirtilen bölgedeki bir posta adresinde bulunması beklenmez. Yalnızca girişin bir parçası olduğu için saklanmıştır.

AddressMetadata class

google.maps.addressValidation.AddressMetadata sınıf

Adresin meta verileri. AddressMetadata'nın, Adres Doğrulama API'sine gönderilen her adres için tam olarak doldurulacağı garanti edilmez.

const {AddressMetadata} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
business
Tür:  boolean
poBox
Tür:  boolean
residential
Tür:  boolean

ConfirmationLevel constants

google.maps.addressValidation.ConfirmationLevel sabitler

Bileşenin doğru olduğundan ne kadar emin olunduğunu gösteren farklı olası değerler.

const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

Geocode sınıfı

google.maps.addressValidation.Geocode sınıf

Girişin coğrafi olarak kodlandığı yerle ilgili bilgileri içerir.

const {Geocode} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
bounds
Tür:  LatLngBounds optional
Coğrafi olarak kodlanmış yerin sınırları.
featureSizeMeters
Tür:  number optional
Coğrafi olarak kodlanmış yerin boyutu (metre cinsinden). Bu, coğrafi olarak kodlanmış konumun kabalığının bir başka ölçüsüdür ancak anlamsal anlamda değil, fiziksel boyutta ölçülür.
location
Tür:  LatLngAltitude optional
Girişin coğrafi kodlanmış konumu.
placeId
Tür:  string optional
Coğrafi olarak kodlanmış yerin yer kimliği. Adres, enlem/boylam koordinatları veya Plus Code kullanmak yerine Yer kullanılması tercih edilir. Rotalandırma veya sürüş yol tariflerini hesaplama için koordinat kullanıldığında nokta her zaman bu koordinatlara en yakın yola sabitlenir. Bu yol, varış noktasına hızlı veya güvenli bir şekilde ulaşmanızı sağlamayabilir ve mülke erişim noktasına yakın olmayabilir. Ayrıca, bir konum ters coğrafi kodlandığında döndürülen adresin orijinal adresle eşleşeceği garanti edilmez.
placeTypes
Tür:  Array<string>
Girişin coğrafi olarak kodlandığı yer türleri. Örneğin, ['locality', 'political']. Türlerin tam listesini Geocoding API dokümanında bulabilirsiniz.
plusCode
Tür:  PlusCode optional
location'ya karşılık gelen plus code.
fetchPlace
fetchPlace()
Parametreler: Yok
Döndürülen Değer: Yok
Bu coğrafi kodun yer gösterimini döndürür. Yerle ilgili tüm ayrıntıları almak için place.fetchFields() çağrısı yapılmalıdır.

Ayrıntı düzeyi sabitleri

google.maps.addressValidation.Granularity sabitler

Bir adresin veya coğrafi kodun sahip olabileceği çeşitli ayrıntı düzeyleri. Adres için ayrıntı düzeyini belirtmek üzere kullanıldığında bu değerler, adresin posta hedefi olarak ne kadar ayrıntılı bir şekilde tanımlandığını gösterir. Örneğin, "123 Main Street, Redwood City, CA, 94061" gibi bir adres PREMISE'yı tanımlarken "Redwood City, CA, 94061" gibi bir adres LOCALITY'yı tanımlar. Ancak Redwood City'deki "123 Main Street" için bir coğrafi kod bulamazsak adres daha ayrıntılı olmasına rağmen döndürülen coğrafi kod LOCALITY ayrıntı düzeyinde olabilir.

const {Granularity} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
BLOCK Adres veya coğrafi kod bir bloğu gösteriyor. Yalnızca Japonya gibi blok düzeyinde adreslemenin olduğu bölgelerde kullanılır.
OTHER Yayınlanamadıkları için birlikte gruplandırılan diğer tüm ayrıntı düzeyleri.
PREMISE Bina düzeyinde sonuç.
PREMISE_PROXIMITY Adresin bina düzeyindeki konumunu yaklaşık olarak belirten bir coğrafi kod.
ROUTE Coğrafi kod veya adres, rota düzeyinde (ör. sokak, yol veya otoyol) ayrıntılıdır.
SUB_PREMISE Bina altı seviyesinde sonuç (ör. daire).

PossibleNextAction constants

google.maps.addressValidation.PossibleNextAction sabitler

API yanıtının yorumlayıcı bir özetini sunar. Amaç, daha sonra atılacak olası bir adımı belirlemeye yardımcı olmaktır. Bu alan, API yanıtındaki diğer alanlardan türetilir ve adres doğruluğu veya teslim edilebilirliği garantisi olarak kabul edilmemelidir.

const {PossibleNextAction} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
ACCEPT API yanıtı, diğer olası sonraki işlem değerlerinden birini gerektiren sinyaller içermiyor. Müşterinize başka bir istem göndermeden, işlem sonrası adresi kullanmayı düşünebilirsiniz. Ancak bu, adresin geçerli olduğunu garanti etmez ve adreste düzeltmeler olabilir. Kendi risk değerlendirmenize bağlı olarak müşterinize istem gönderip göndermeyeceğinizi ve nasıl göndereceğinizi belirlemek sizin sorumluluğunuzdadır.
CONFIRM API yanıtının bir veya daha fazla alanı, sonradan işlenen adreste olası küçük sorunlar olduğunu gösteriyor. Örneğin, postal_code adres bileşeni replaced. Müşterinizden adresi incelemesini istemek, adresin kalitesini artırmanıza yardımcı olabilir.
CONFIRM_ADD_SUBPREMISES API yanıtı, işlem sonrası adreste alt birimin eksik olabileceğini gösteriyor. Müşterinizden adresi incelemesini ve birim numarası eklemeyi düşünmesini istemek, adresin kalitesini artırmaya yardımcı olabilir. İşlem sonrası adreslerde başka küçük sorunlar da olabilir. Not: Bu enum değeri yalnızca ABD adresleri için döndürülebilir.
FIX API yanıtının bir veya daha fazla alanında, sonradan işlenen adresle ilgili olası bir sorun olduğu belirtiliyor. Örneğin, verdict.validation_granularity OTHER. Müşterinizi adresi düzenlemeye yönlendirmek, adresin kalitesini artırmanıza yardımcı olabilir.

USPSAddress class

google.maps.addressValidation.USPSAddress sınıf

ABD adresinin USPS gösterimi.

const {USPSAddress} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
city
Tür:  string optional
Şehir adı.
cityStateZipAddressLine
Tür:  string optional
Şehir, eyalet ve posta kodunu içeren adres satırı.
firm
Tür:  string optional
Firmanın adı.
firstAddressLine
Tür:  string optional
Adresin ilk satırı.
secondAddressLine
Tür:  string optional
Adresin ikinci satırı.
state
Tür:  string optional
2 harfli eyalet kodu.
urbanization
Tür:  string optional
Porto Riko şehirleşme adı.
zipCode
Tür:  string optional
Posta kodu (ör. "10009")
zipCodeExtension
Tür:  string optional
4 haneli posta kodu uzantısı (ör. "5023")

USPSData sınıfı

google.maps.addressValidation.USPSData sınıf

Adresle ilgili USPS verileri. USPSData'nın, Adres Doğrulama API'sine gönderilen her ABD veya PR adresi için tam olarak doldurulacağı garanti edilmez. Yanıtın birincil kısmı olarak uspsData'yı kullanıyorsanız yedek adres alanlarını yanıta entegre etmeniz önerilir.

const {USPSData} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
abbreviatedCity
Tür:  string optional
Kısaltılmış şehir.
addressRecordType
Tür:  string optional
Giriş adresiyle eşleşen adres kaydının türü.
carrierRoute
Tür:  string optional
Kargo rotası kodu. Bir harfli önek ve üç haneli rota tanımlayıcısından oluşan dört karakterli kod.
carrierRouteIndicator
Tür:  string optional
Kargo rotası ücreti sıralama göstergesi.
cassProcessed
Tür:  boolean
İsteğin CASS'de işlendiğini gösteren işaret.
county
Tür:  string optional
İlçe adı.
deliveryPointCheckDigit
Tür:  string optional
Teslimat noktası kontrol basamağı. Bu numara, mekanik olarak taranan postalar için delivery_point_barcode öğesinin sonuna eklenir. delivery_point_barcode, delivery_point_check_digit, posta kodu ve ZIP+4 değerlerinin tüm basamaklarının toplamı 10'a bölünebilen bir sayı olmalıdır.
deliveryPointCode
Tür:  string optional
2 haneli teslimat noktası kodu.
dpvCMRA
Tür:  string optional
Adresin CMRA (Ticari Posta Alma Ajansı) olup olmadığını belirtir. CMRA, müşteriler için posta alan özel bir işletmedir. Tek bir karakter döndürür.
dpvConfirmation
Tür:  string optional
DPV onayı için olası değerler. Tek bir karakter döndürür veya değer döndürmez.
dpvDoorNotAccessible
Tür:  string optional
İşaret, USPS'nin posta teslim etmek için kapıyı çalamadığı adresleri gösterir. Tek bir karakter döndürür.
dpvDrop
Tür:  string optional
İşaret, postanın bir sitedeki tek bir alıcıya teslim edildiğini gösterir. Tek bir karakter döndürür.
dpvEnhancedDeliveryCode
Tür:  string optional
Adres için birden fazla DPV dönüş kodunun geçerli olduğunu gösterir. Tek bir karakter döndürür.
dpvFootnote
Tür:  string optional
Teslimat noktası doğrulamasından alınan dipnotlar. Aynı dizede birden fazla dipnot birleştirilebilir.
dpvNonDeliveryDays
Tür:  string optional
İşaret, posta tesliminin haftanın her günü yapılmadığını gösterir. Tek bir karakter döndürür.
dpvNonDeliveryDaysValues
Tür:  number optional
Teslimatın yapılmadığı günleri tanımlayan tam sayı. Bit işaretleri kullanılarak sorgulanabilir: 0x40 – Pazar günü teslimat yapılmaz 0x20 – Pazartesi günü teslimat yapılmaz 0x10 – Salı günü teslimat yapılmaz 0x08 – Çarşamba günü teslimat yapılmaz 0x04 – Perşembe günü teslimat yapılmaz 0x02 – Cuma günü teslimat yapılmaz 0x01 – Cumartesi günü teslimat yapılmaz
dpvNoSecureLocation
Tür:  string optional
İşaret, kapının erişilebilir olduğunu gösteriyor ancak güvenlik endişeleri nedeniyle paket bırakılmayacak. Tek bir karakter döndürür.
dpvNoStat
Tür:  string optional
Adresin istatistik içermeyen bir adres mi yoksa etkin bir adres mi olduğunu gösterir. Statik olmayan adresler, sürekli olarak kullanılmayan veya ABD Posta Servisi'nin hizmet vermediği adreslerdir. Tek bir karakter döndürür.
dpvNoStatReasonCode
Tür:  number optional
NoStat türünü belirtir. Neden kodunu int olarak döndürür.
dpvPBSA
Tür:  string optional
Adresin PBSA kaydıyla eşleştiğini gösterir. Tek bir karakter döndürür.
dpvThrowback
Tür:  string optional
Postanın sokak adresine teslim edilmediğini gösterir. Tek bir karakter döndürür.
dpvVacant
Tür:  string optional
Adresin boş olup olmadığını gösterir. Tek bir karakter döndürür.
elotFlag
Tür:  string optional
eLOT Artan/Azalan İşareti (A/D).
elotNumber
Tür:  string optional
Gelişmiş Seyahat Hattı (eLOT) numarası.
errorMessage
Tür:  string optional
USPS veri alma işlemiyle ilgili hata mesajı. Bu alan, yapay olarak oluşturulmuş adresler tespit edildiği için USPS işleme askıya alındığında doldurulur.
fipsCountyCode
Tür:  string optional
FIPS ilçe kodu.
hasDefaultAddress
Tür:  boolean
Varsayılan bir adresin bulunduğu ancak daha spesifik adreslerin mevcut olduğunu gösterir.
hasNoEWSMatch
Tür:  boolean
Teslimat adresi eşleştirilebilir ancak EWS dosyası, tam eşleşmenin yakında kullanıma sunulacağını belirtiyor.
lacsLinkIndicator
Tür:  string optional
LACSLink göstergesi.
lacsLinkReturnCode
Tür:  string optional
LACSLink dönüş kodu.
pmbDesignator
Tür:  string optional
PMB (Private Mail Box) birim tanımlayıcısı.
pmbNumber
Tür:  string optional
PMB (Özel Posta Kutusu) numarası.
poBoxOnlyPostalCode
Tür:  boolean
Yalnızca posta kutusu posta kodu.
postOfficeCity
Tür:  string optional
Ana postane şehri.
postOfficeState
Tür:  string optional
Ana postane eyaleti.
standardizedAddress
Tür:  USPSAddress optional
USPS standartlarına uygun adres.
suiteLinkFootnote
Tür:  string optional
Bir sokak veya yüksek bina kaydının daire bilgileriyle eşleştirilmesinden kaynaklanan dipnotlar. İşletme adı eşleşmesi bulunursa ikincil numara döndürülür.

Verdict class

google.maps.addressValidation.Verdict sınıf

Sağlanan adresin işlenmiş halini gösterir.

const {Verdict} = await google.maps.importLibrary("addressValidation") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
addressComplete
Tür:  boolean
Çözümlenmemiş jetonlar, beklenmeyen veya eksik adres bileşenleri yoksa adres tamamlanmış kabul edilir. Ayarlanmamışsa değerin false olduğunu gösterir. Daha fazla bilgi için Address.missingComponentTypes, Address.unresolvedTokens veya AddressComponent.unexpected alanlarına bakın.
geocodeGranularity
Tür:  Granularity optional
Geocode'nın ayrıntı düzeyi hakkında bilgi. Bu, coğrafi olarak kodlanmış konumun ne kadar kaba veya ince olduğunun semantik anlamı olarak anlaşılabilir.
hasInferredComponents
Tür:  boolean
Girişte bulunmayan en az bir adres bileşeni çıkarıldı (ör.eklendi). Ayrıntılar için AddressComponent bölümüne bakın.
hasReplacedComponents
Tür:  boolean optional
En az bir adres bileşeni değiştirildi. Ayrıntılar için AddressComponent bölümüne bakın.
hasUnconfirmedComponents
Tür:  boolean
Adres bileşenlerinden en az biri kategorize edilemiyor veya doğrulanamıyor. Ayrıntılar için AddressComponent bölümüne bakın.
inputGranularity
Tür:  Granularity optional
Giriş adresinin ayrıntı düzeyi. Bu, giriş adresinin ayrıştırılmasının sonucudur ve herhangi bir doğrulama sinyali vermez. Doğrulama sinyalleri için validationGranularity başlıklı makaleyi inceleyin.
possibleNextAction
Tür:  PossibleNextAction optional
API yanıtındaki diğer alanlara göre yapılabilecek olası bir sonraki işlem. Ayrıntılar için PossibleNextAction öğesine bakın.
validationGranularity
Tür:  Granularity optional
API'nin adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Örneğin, validationGranularity PREMISE, PREMISE düzeyindeki ve daha geniş tüm adres bileşenlerinin doğrulanabileceğini gösterir.