Address Validation

AddressValidation sınıfı

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") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
fetchAddressValidation
fetchAddressValidation(request)
Parametreler: 
Dönüş Değeri:  Promise<AddressValidation>
Adresleri 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 kodlandığı konum ve yer hakkında bilgi.
metadata
Tür:  AddressMetadata optional
Teslim edilebilirlikle ilgili diğer bilgiler. metadata, Address Validation API'ye gönderilen her adres için tamamen doldurulmayabilir.
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ölgelerinde sunulur.
verdict
Tür:  Verdict optional
Genel karar işaretleri
toJSON
toJSON()
Parametreler:  Yok
Dönüş 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
Doğrulanan adres. 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 jetonuna 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 adresi tam olarak doğrulamak için daha fazla istek gerekiyorsa (örneğin, kullanıcının ilk doğrulamadan sonra yaptığı değişikliklerin yeniden doğrulanması gerekiyorsa) her takip isteği, doğrulama sırasındaki ilk yanıttan alınan AddressValidation.responseId ile bu alanı 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 modunu etkinleştirir. Bu, AddressValidation öğesinin yalnızca AddressValidation.uspsData alanını etkiler. Not: Porto Riko'daki adresler için USPS CASS etkinleştirilmiş isteklerde, address öğesinin PostalAddress.regionCode değeri "PR" olarak veya address öğesinin PostalAddress.administrativeArea değeri "Puerto Rico" (büyük/küçük harfe duyarlı değil) ya da "PR" olarak sağlanmalıdır.

Address sınıfı

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

Sonradan işlenen 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") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
components
Biçimlendirilmiş ve düzeltilmiş adresin ayrı adres bileşenleri ve doğrulama bilgileri. Bu, her bir bileşenin 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ş, sonradan işlenen adres.
missingComponentTypes
Tür:  Array<string>
Doğru biçimlendirilmiş bir posta adresinde bulunması beklenen ancak girişte bulunamayan VE tahmin edilemeyen bileşen türleri. Bu tür bileşenler formatted_address, postal_address veya address_components içinde mevcut değil. Ö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
Posta adresi olarak temsil edilen, sonradan işlenmiş adres.
unconfirmedComponentTypes
Tür:  Array<string>
address_components içinde bulunan ancak doğru olduğu onaylanamayan bileşenlerin türleri. Bu alan kolaylık sağlamak için sunulmuştur: İçeriği, AddressComponent.confirmationLevel değerinin ConfirmationLevel.CONFIRMED olmadığı veya AddressComponent.inferred işaretinin true olarak ayarlanmadığı tüm bileşenlerin türlerini bulmak için address_components üzerinde iterasyon yapmaya eşdeğerdir. Olası türlerin listesini burada bulabilirsiniz.
unresolvedTokens
Tür:  Array<string>
Girişte çözümlenemeyen jetonlar. Bu, bir 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 sokak numarası gibi görünmediğinden ["123235253253"] gibi görünebilir.

AddressComponent sınıfı

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") numarasını 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 sokak numarası için "1253".
componentNameLanguageCode
Tür:  string optional
BCP-47 dil kodu. Bileşen adı bir dille ilişkili değilse (ör. sokak numarası) bu bilgi gösterilmez.
componentType
Tür:  string optional
Adres bileşeninin türü. Olası türlerin listesi için Tablo 2: Places hizmeti tarafından döndürülen ek türler bölümüne bakın.
confirmationLevel
Tür:  ConfirmationLevel optional
Bileşenin doğru olduğuna dair kesinlik düzeyini gösterir.
inferred
Tür:  boolean
Bu özelliğin true (doğru) olması, bu bileşenin girişin bir parçası olmadığını ancak adres konumu için tahmin edildiğini ifade eder. Adresin eksiksiz olması için bu bileşenin eklenmesi önerilir.
replaced
Tür:  boolean
Bileşen adının tamamen farklı bir adla değiştirildiğini gösterir. Örneğin, yanlış bir posta kodunu adres için doğru olan bir posta koduyla değiştirmek. 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 bir 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" yerine "center" yazılması) her zaman işaretlemez.
unexpected
Tür:  boolean
Bu özelliğin true (doğru) olması, bu bileşenin belirtilen bölge için posta adresinde bulunmasının beklenmediğini ifade eder. Yalnızca girişin bir parçası olduğu için saklanmıştır.

AddressMetadata sınıfı

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

Adresin meta verileri. AddressMetadata'nın, Address Validation API'ye gönderilen her adres için tamamen doldurulacağı garanti edilmez.

const {AddressMetadata} = await google.maps.importLibrary("addressValidation") numarasını 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 sabitleri

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") numarasını 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") numarasını 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 kodlanmış yerin metre cinsinden boyutu. Bu, coğrafi kodlanmış konumun kabalığının başka bir ölçüsüdür ancak anlamsal anlamdan ziyade fiziksel boyuttadır.
location
Tür:  LatLngAltitude optional
Girişin coğrafi kodlanmış konumu.
placeId
Tür:  string optional
Coğrafi kodlanmış yerin yer kimliği. Adres, enlem/boylam koordinatları veya Plus Code'lar yerine Place kullanılması tercih edilir. Rota oluşturmak veya arabayla yol tarifini hesaplamak için koordinatların kullanılması, her zaman noktanın bu koordinatlara en yakın yola sabitlenmesine neden olur. Bu yol, hedefe hızlı veya güvenli bir şekilde ulaşmanızı sağlamayabilir ve mülke erişim noktasının yakınında olmayabilir. Ayrıca, bir konum tersine 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 belgelerinde bulabilirsiniz.
plusCode
Tür:  PlusCode optional
location ile eşleşen Plus Code.
fetchPlace
fetchPlace()
Parametreler:  Yok
Döndürülen değer:  Yok
Bu coğrafi kodun yer temsilini döndürür. Yer ayrıntılarının tamamını 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. Bir adresin ayrıntı düzeyini belirtmek için kullanıldığında bu değerler, adresin bir posta hedefini ne kadar ayrıntılı tanımladığını gösterir. Örneğin, "123 Main Street, Redwood City, CA, 94061" gibi bir adres PREMISE tanımlarken "Redwood City, CA, 94061" gibi bir adres LOCALITY tanımlar. Ancak Redwood City'deki "123 Main Street" için bir coğrafi kod bulamazsak döndürülen coğrafi kod, adres daha ayrıntılı olsa bile LOCALITY ayrıntı düzeyinde olabilir.

const {Granularity} = await google.maps.importLibrary("addressValidation") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
BLOCK Adres veya coğrafi kod bir blok gösteriyor. Yalnızca Japonya gibi blok düzeyinde adreslemenin kullanıldığı 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 konumuna yaklaşık olarak karşılık gelen bir coğrafi kod.
ROUTE Coğrafi kod veya adres, rota düzeyinde ayrıntılıdır (ör. sokak, yol veya otoyol).
SUB_PREMISE Bina altı düzeyinde sonuç (ör. apartman dairesi).

PossibleNextAction sabitleri

google.maps.addressValidation.PossibleNextAction sabitler

API yanıtının yorumlayıcı bir özetini sunar. Bu özet, bir sonraki olası işlemi belirlemenize yardımcı olmak için tasarlanmıştır. Bu alan, API yanıtındaki diğer alanlardan türetilir ve adres doğruluğu veya teslim edilebilirlik garantisi olarak kabul edilmemelidir.

const {PossibleNextAction} = await google.maps.importLibrary("addressValidation") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
ACCEPT API yanıtı, diğer PossibleNextAction değerlerinden birini gerektiren sinyaller içermiyor. Müşterinizden daha fazla bilgi istemeden, sonradan işlenen adresi kullanmayı düşünebilirsiniz. Ancak bu, adresin geçerli olduğunu garanti etmez ve adres hâlâ düzeltmeler içerebilir. Kendi risk değerlendirmenize bağlı olarak müşterinizden onay isteyip istemeyeceğinizi ve bunu nasıl yapacağınızı belirlemek sizin sorumluluğunuzdadır.
CONFIRM API yanıtının bir veya daha fazla alanı, sonradan işlenen adresle ilgili olası küçük sorunları gösterir. Örneğin, postal_code adres bileşeni replaced. Müşterinizden adresi incelemesini istemek, adresin kalitesini artırmaya yardımcı olabilir.
CONFIRM_ADD_SUBPREMISES API yanıtı, sonradan işlenen adreste bir alt tesisin eksik olabileceğini gösteriyor. Müşterinizden adresi incelemesini ve bir birim numarası eklemesini istemek, adresin kalitesini artırmaya yardımcı olabilir. Sonradan işlenen adreste 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ı, sonradan işlenen adresle ilgili olası bir sorunu gösterir (ör. verdict.validation_granularity, OTHER). Müşterinizden adresi düzenlemesini istemek, adresin kalitesini artırmaya yardımcı olabilir.

USPSAddress sınıfı

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

ABD adresinin USPS gösterimi.

const {USPSAddress} = await google.maps.importLibrary("addressValidation") numarasını 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'daki kentleş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, Address Validation API'ye gönderilen her ABD veya Porto Riko adresi için tam olarak doldurulacağı garanti edilmez. Yanıtta uspsData'yı birincil bölüm olarak kullanıyorsanız yanıttaki yedek adres alanlarını entegre etmeniz önerilir.

const {USPSData} = await google.maps.importLibrary("addressValidation") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
abbreviatedCity
Tür:  string optional
Kısaltılmış şehir adı.
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 ön ek ve üç haneli rota belirleyiciden oluşan dört karakterli bir kod.
carrierRouteIndicator
Tür:  string optional
Kargo şirketi rotası ücret sıralama göstergesi.
cassProcessed
Tür:  boolean
İsteğin CASS tarafından işlendiğini gösteren gösterge.
county
Tür:  string optional
İlçe adı.
deliveryPointCheckDigit
Tür:  string optional
Teslimat noktası kontrol basamağı. Bu sayı, mekanik olarak taranan postalar için delivery_point_barcode'un sonuna eklenir. delivery_point_barcode, delivery_point_check_digit, posta kodu ve ZIP+4 değerlerinin tüm basamakları toplandığında 10'a bölünebilen bir sayı elde edilmelidir.
deliveryPointCode
Tür:  string optional
2 haneli teslimat noktası kodu.
dpvCMRA
Tür:  string optional
Adresin bir CMRA (Ticari Posta Alma Kurumu) 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ı çalamayacağı 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 bir araya getirilebilir.
dpvNonDeliveryDays
Tür:  string optional
İşaret, posta teslimatının haftanın her günü yapılmadığını gösterir. Tek bir karakter döndürür.
dpvNonDeliveryDaysValues
Tür:  number optional
Teslimat yapılmayan 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ıya erişilebildiğini ancak güvenlik nedeniyle paketin bırakılmayacağını gösterir. Tek bir karakter döndürür.
dpvNoStat
Tür:  string optional
Adresin istatistik dışı bir adres mi yoksa etkin bir adres mi olduğunu gösterir. "No stat" adresler, sürekli olarak kullanılmayan veya USPS'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
Postaların açık adrese 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şlemi için hata mesajı. Yapay olarak oluşturulmuş adreslerin tespit edilmesi nedeniyle USPS işlemleri askıya alındığında bu alan doldurulur.
fipsCountyCode
Tür:  string optional
FIPS ilçe kodu.
hasDefaultAddress
Tür:  boolean
Varsayılan bir adresin bulunduğunu ancak daha spesifik adreslerin mevcut olduğunu gösteren gösterge.
hasNoEWSMatch
Tür:  boolean
Teslimat adresi eşleştirilebilir ancak EWS dosyası, yakında tam eşleşmenin mümkün olacağını gösteriyor.
lacsLinkIndicator
Tür:  string optional
LACSLink göstergesi.
lacsLinkReturnCode
Tür:  string optional
LACSLink dönüş kodu.
pmbDesignator
Tür:  string optional
PMB (Özel Posta Kutusu) 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 süit bilgileriyle eşleştirilmesinden elde edilen dipnotlar. İşletme adı eşleşmesi bulunursa ikincil numara döndürülür.

Verdict sınıfı

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

Sağlanan adresin sonradan işlenen adresini temsil eder.

const {Verdict} = await google.maps.importLibrary("addressValidation") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
addressComplete
Tür:  boolean
Çözümlenmemiş jeton, beklenmeyen veya eksik adres bileşeni yoksa adres eksiksiz 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 ayrıntı düzeyi hakkında bilgi. Bu, coğrafi kodlu konumun ne kadar kaba veya hassas olduğunun semantik anlamı olarak anlaşılabilir.
hasInferredComponents
Tür:  boolean
Girişte bulunmayan en az bir adres bileşeni tahmin edildi (yani eklendi). Ayrıntılar için AddressComponent adresine bakın.
hasReplacedComponents
Tür:  boolean optional
En az bir adres bileşeni değiştirildi. Ayrıntılar için AddressComponent adresine bakın.
hasUnconfirmedComponents
Tür:  boolean
En az bir adres bileşeni kategorize edilemiyor veya doğrulanamıyor. Ayrıntılar için AddressComponent adresine 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 sayfasına bakın.
BetapossibleNextAction
Tür:  PossibleNextAction optional
API yanıtındaki diğer alanlara göre gerçekleştirilebilecek bir sonraki işlem. Ayrıntılar için PossibleNextAction öğesine bakın.
validationGranularity
Tür:  Granularity optional
API'nin adresi tam olarak doğrulayabildiği ayrıntı düzeyi. Örneğin, PREMISE değerine sahip bir validationGranularity, PREMISE düzeyindeki ve daha geniş düzeydeki tüm adres bileşenlerinin doğrulanabileceğini gösterir.