Address Validation

AddressValidation sınıfı

sınıf google.maps.addressValidation.AddressValidation
kitaplık "addressValidation"

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

const {AddressValidation} = await google.maps.importLibrary("addressValidation");

Statik Yöntemler
fetchAddressValidation	fetchAddressValidation(request) Parametreler: request: AddressValidationRequest Dönüş Değeri: Promise<AddressValidation> Adresleri doğrular. https://developers.google.com/maps/documentation/javascript/address-validation/validate-address adresini ziyaret edin.

Özellikler
address readonly	Tür: Address optional Coğrafi kodun aksine adresin kendisiyle ilgili bilgiler.
geocode readonly	Tür: Geocode optional Adresin coğrafi kodlandığı konum ve yer hakkında bilgi.
metadata readonly	Tür: AddressMetadata optional Teslim edilebilirlikle ilgili diğer bilgiler. metadata, Address Validation API'ye gönderilen her adres için tamamen doldurulmayabilir.
responseId readonly	Tür: string optional Bu yanıtı tanımlayan UUID. Adresin yeniden doğrulanması gerekiyorsa bu UUID yeni istekle birlikte gönderilmelidir.
uspsData readonly	Tür: USPSData optional USPS tarafından sağlanan ek teslim edilebilirlik işaretleri. Yalnızca US ve PR bölgelerinde sunulur.
verdict readonly	Tür: Verdict optional Genel karar işaretleri

Yöntemler
Devralındı: toJSON

AddressValidationRequest arayüzü

arayüz google.maps.addressValidation.AddressValidationRequest

AddressValidation.fetchAddressValidation için istek arayüzü.

Özellikler
address	Tür: PostalAddressLiteral Doğrulanan adres. Biçimlendirilmemiş adresler PostalAddress.addressLines üzerinden gönderilmelidir.
internalUsageAttributionIds isteğe bağlı	Tür: Iterable<string> optional Çağrıları belirli paketlerle veya OSS kitaplıklarıyla ilişkilendirmek için kullanılan tanımlayıcılar.
placeAutocompleteElement isteğe bağlı	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 isteğe bağlı	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 isteğe bağlı	Tür: AutocompleteSessionToken optional Faturalandırma amacıyla bir otomatik tamamlama oturumunu tanımlayan jeton.
uspsCASSEnabled isteğe bağlı	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ı

sınıf google.maps.addressValidation.Address
kitaplık "addressValidation"

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");

Özellikler
components readonly	Tür: Array<AddressComponent> 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 readonly	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 readonly	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 readonly	Tür: PostalAddress optional Posta adresi olarak temsil edilen, sonradan işlenmiş adres.
unconfirmedComponentTypes readonly	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 readonly	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.

Yöntemler
Devralındı: toJSON

AddressComponent sınıfı

sınıf google.maps.addressValidation.AddressComponent
kitaplık "addressValidation"

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

const {AddressComponent} = await google.maps.importLibrary("addressValidation");

Özellikler
componentName readonly	Tür: string optional Bileşen adı metni. Örneğin, sokak adı için "5. Cadde" veya sokak numarası için "1253".
componentNameLanguageCode readonly	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 readonly	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 readonly	Tür: ConfirmationLevel optional Bileşenin doğru olduğuna dair kesinlik düzeyini gösterir.
inferred readonly	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 readonly	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 readonly	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 readonly	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ı

sınıf google.maps.addressValidation.AddressMetadata
kitaplık "addressValidation"

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");

Özellikler
business readonly	Tür: boolean
poBox readonly	Tür: boolean
residential readonly	Tür: boolean

Yöntemler
Devralındı: toJSON

ConfirmationLevel sabitleri

sabitler google.maps.addressValidation.ConfirmationLevel
kitaplık "addressValidation"

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

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri ConfirmationLevelString türüyle tanımlanır.

const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation");

Sabitler
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

Geocode sınıfı

sınıf google.maps.addressValidation.Geocode
kitaplık "addressValidation"

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

const {Geocode} = await google.maps.importLibrary("addressValidation");

Özellikler
bounds readonly	Tür: LatLngBounds optional Coğrafi olarak kodlanmış yerin sınırları.
featureSizeMeters readonly	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 readonly	Tür: LatLngAltitude optional Girişin coğrafi kodlanmış konumu.
placeId readonly	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 readonly	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 readonly	Tür: PlusCode optional location ile eşleşen Plus Code.

Yöntemler
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.
Devralındı: toJSON

Ayrıntı düzeyi sabitleri

sabitler google.maps.addressValidation.Granularity
kitaplık "addressValidation"

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.

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri GranularityString türüyle tanımlanır.

const {Granularity} = await google.maps.importLibrary("addressValidation");

Sabitler
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

sabitler google.maps.addressValidation.PossibleNextAction
kitaplık "addressValidation"

Not: Yalnızca v=beta kanalında kullanılabilir.

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.

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri PossibleNextActionString türüyle tanımlanır.

const {PossibleNextAction} = await google.maps.importLibrary("addressValidation");

Sabitler
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ı

sınıf google.maps.addressValidation.USPSAddress
kitaplık "addressValidation"

ABD adresinin USPS gösterimi.

const {USPSAddress} = await google.maps.importLibrary("addressValidation");

Özellikler
city readonly	Tür: string optional Şehir adı.
cityStateZipAddressLine readonly	Tür: string optional Şehir, eyalet ve posta kodunu içeren adres satırı.
firm readonly	Tür: string optional Firmanın adı.
firstAddressLine readonly	Tür: string optional Adresin ilk satırı.
secondAddressLine readonly	Tür: string optional Adresin ikinci satırı.
state readonly	Tür: string optional 2 harfli eyalet kodu.
urbanization readonly	Tür: string optional Porto Riko'daki kentleşme adı.
zipCode readonly	Tür: string optional Posta kodu (ör. "10009").
zipCodeExtension readonly	Tür: string optional 4 haneli posta kodu uzantısı (ör. "5023").

Yöntemler
Devralındı: toJSON

USPSData sınıfı

sınıf google.maps.addressValidation.USPSData
kitaplık "addressValidation"

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");

Özellikler
abbreviatedCity readonly	Tür: string optional Kısaltılmış şehir adı.
addressRecordType readonly	Tür: string optional Giriş adresiyle eşleşen adres kaydının türü.
carrierRoute readonly	Tür: string optional Kargo rotası kodu. Bir harfli ön ek ve üç haneli rota belirleyiciden oluşan dört karakterli bir kod.
carrierRouteIndicator readonly	Tür: string optional Kargo şirketi rotası ücret sıralama göstergesi.
cassProcessed readonly	Tür: boolean İsteğin CASS tarafından işlendiğini gösteren gösterge.
county readonly	Tür: string optional İlçe adı.
deliveryPointCheckDigit readonly	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 readonly	Tür: string optional 2 haneli teslimat noktası kodu.
dpvCMRA readonly	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 readonly	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 readonly	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 readonly	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 readonly	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 readonly	Tür: string optional Teslimat noktası doğrulamasından alınan dipnotlar. Aynı dizede birden fazla dipnot bir araya getirilebilir.
dpvNonDeliveryDays readonly	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 readonly	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 readonly	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 readonly	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 readonly	Tür: number optional NoStat türünü belirtir. Neden kodunu int olarak döndürür.
dpvPBSA readonly	Tür: string optional Adresin PBSA kaydıyla eşleştiğini gösterir. Tek bir karakter döndürür.
dpvThrowback readonly	Tür: string optional Postaların açık adrese teslim edilmediğini gösterir. Tek bir karakter döndürür.
dpvVacant readonly	Tür: string optional Adresin boş olup olmadığını gösterir. Tek bir karakter döndürür.
elotFlag readonly	Tür: string optional eLOT Artan/Azalan İşareti (A/D).
elotNumber readonly	Tür: string optional Gelişmiş Seyahat Hattı (eLOT) numarası.
errorMessage readonly	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 readonly	Tür: string optional FIPS ilçe kodu.
hasDefaultAddress readonly	Tür: boolean Varsayılan bir adresin bulunduğunu ancak daha spesifik adreslerin mevcut olduğunu gösteren gösterge.
hasNoEWSMatch readonly	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 readonly	Tür: string optional LACSLink göstergesi.
lacsLinkReturnCode readonly	Tür: string optional LACSLink dönüş kodu.
pmbDesignator readonly	Tür: string optional PMB (Özel Posta Kutusu) birim tanımlayıcısı.
pmbNumber readonly	Tür: string optional PMB (Özel Posta Kutusu) numarası.
poBoxOnlyPostalCode readonly	Tür: boolean Yalnızca posta kutusu posta kodu.
postOfficeCity readonly	Tür: string optional Ana postane şehri.
postOfficeState readonly	Tür: string optional Ana postane eyaleti.
standardizedAddress readonly	Tür: USPSAddress optional USPS standartlarına uygun adres.
suiteLinkFootnote readonly	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.

Yöntemler
Devralındı: toJSON

Verdict sınıfı

sınıf google.maps.addressValidation.Verdict
kitaplık "addressValidation"

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

const {Verdict} = await google.maps.importLibrary("addressValidation");

Özellikler
addressComplete readonly	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 readonly	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 readonly	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 readonly	Tür: boolean optional En az bir adres bileşeni değiştirildi. Ayrıntılar için AddressComponent adresine bakın.
hasUnconfirmedComponents readonly	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 readonly	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.
possibleNextAction readonly	Not: Yalnızca v=beta kanalında kullanılabilir. 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 readonly	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.