Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Avrupa Ekonomik Alanı (AEA) geliştiricileri
Maps JavaScript API'de neden adres doğrulama kullanılır?
Adres Doğrulama kitaplığı, adres bileşenlerini tanımlamak ve doğrulamak için giriş olarak bir adres alır. Ayrıca, posta adresi için standart bir biçim kullanır ve bilinen en iyi enlem/boylam koordinatlarını bulur. Dilerseniz ABD ve Porto Riko'daki adresler için
kodlama doğruluğu destek sistemini (CASS™) etkinleştirebilirsiniz.
Address Validation API ile teslimat öngörülebilirliğini artırabilir ve teslimat hatalarını azaltarak daha iyi bir müşteri deneyimi sunabilirsiniz.
Bunu, hatalı adresleri yakalayarak ve adres özelliklerini daha iyi anlayarak yapabilirsiniz.
Maps JavaScript API'deki Adres Doğrulama özelliğiyle, bir adresin gerçek bir yeri temsil edip etmediğini belirleyebilirsiniz. Adres gerçek bir yeri belirtmiyorsa API, düzeltmeleri müşterilerinize sunabileceğiniz olası hatalı bileşenleri belirleyebilir. Aşağıda örnek bir iş akışı verilmiştir:
Müşteri bir adres girer: Aşağıdaki resimde, müşterinin muhtemelen ödeme akışı kapsamında bir adres girmesine olanak tanıyan temel bir form gösterilmektedir.
Uygulama adresi API'ye gönderir: Uygulama, bu adresi fetchAddressValidation yöntemini kullanarak iletir.
API, adresi doğrular ve standart hale getirir: Adres Doğrulama API'si, yanıtında API tarafından belirlenen adresin tamamını döndürür veya bilgi eksik olan yerleri belirtir.
Müşteri adresi onaylar veya düzeltir: API'nin döndürdüğü değere bağlı olarak müşteriye aşağıdaki istemleri gösterebilirsiniz:
Önerilen adresi onaylayın.
Eksik bilgileri sağlayın.
Adresi düzeltin.
Maps JavaScript API'deki adres doğrulamasının işleyiş şekli
fetchAddressValidation adresine çağrı yapıldığında API aşağıdakileri dener:
Düzeltir: Mevcut olduğunda alt tesisler dahil olmak üzere bileşen düzeyinde doğrulama kontrolleri sağlar.
Tamamlandı: Eksik veya yanlış adres bileşenlerini tahmin etmeye çalışır.
Biçimlendirme: Adres bileşenlerinin biçimini temizler ve standart hale getirir.
CASS™ hakkında
United States Postal Service® (USPS®)1
adres doğrulama sağlayıcılarını desteklemek ve onaylamak için
Kodlama Doğruluğu Destek Sistemi'ni (CASS™)
yönetir. Adres Doğrulama API'si gibi CASS Certified™ hizmetleri, adresteki eksik bilgileri doldurma, standartlaştırma ve en güncel ve en doğru adresi sunmak için güncelleme özellikleriyle onaylanmıştır.
CASS varsayılan olarak etkin değildir ve yalnızca "US" ve "PR" bölgeleri için desteklenir. CASS'yi etkinleştirmek için doğrulama isteği kapsamında "enableUspsCass" parametresini "true" olarak ayarlayın. Daha fazla bilgi için Adres doğrulama başlıklı makaleyi inceleyin.
USPS hizmetlerini kullanımımız kapsamında, USPS yapay olarak oluşturulmuş adreslerle ilgili istekleri değerlendirir. USPS bir giriş adresini yapay olarak oluşturulmuş olarak tanımlarsa Google'ın müşterinin adreslerini doğrulamayı durdurması ve müşterinin iletişim bilgilerini (ad ve adres), ilgili giriş adresini ve toplu kullanım verilerini USPS'ye bildirmesi gerekir. API'yi kullanarak bu
Hizmete Özel Şartlar'ı kabul etmiş olursunuz.
Google Haritalar Platformu, United States Postal Service®'in münhasır olmayan bir lisans sahibidir. Aşağıdaki ticari markalar United States Postal Service®'e aittir ve izin alınarak kullanılır: United States Postal Service®, CASS™, CASS Certified™.
↩
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[],[],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n| This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage\n| descriptions](/maps/launch-stages).\n\nWhy use Address Validation in Maps JavaScript API? \n\nThe Address Validation library takes an address as input to identify and validate address\ncomponents. It also standardizes the address for mailing and finds the best known\nlatitude/longitude coordinates for it. Optionally, for addresses in the United States and\nPuerto Rico, you can enable the\n[Coding Accuracy Support System (CASS™)](https://developers.google.com/maps/documentation/address-validation/overview#about-cass).\n\nWith Address Validation API, you can improve delivery\npredictability and reduce delivery failures, thereby providing improved customer experience.\nYou do this by catching bad addresses and obtaining better awareness of address\ncharacteristics.\n| The Geocoding API might be a better match for your needs if you don't need to validate the individual address components. The Geocoding API **converts** addresses into latitude and longitude coordinates. The Address Validation API validates addresses for **correctness** . See [Building location validation capability using Google Maps Platform](https://developers.google.com/maps/architecture/geocoding-address-validation) in the Architecture Center for a detailed comparison.\n\nWhat you can do with Address Validation in Maps JavaScript API\n\nWith Address Validation in Maps JavaScript API, you can determine if an address refers to a\nreal place. If the address does not refer to a real place, the API can identify possibly wrong\ncomponents that you can present to your customers to correct. Here is a sample workflow:\n\n1.\n **Customer enters an address** --- The following image shows a basic form\n that allows a customer to enter an address, possibly as part of a checkout flow.\n\n2.\n **App sends the address to the API** --- The application passes this\n address using the `fetchAddressValidation` method.\n\n3.\n **API validates and standardizes the address** --- In its response, the\n Address Validation API returns the complete address as determined by the API, or\n indicates where information is missing.\n\n4.\n **Customer confirms or corrects the address** --- Depending on what the\n API returns, you can provide the following prompts to the customer:\n\n 1. Confirm the recommended address.\n 2. Provide missing information.\n 3. Fix the address.\n\nHow Address Validation in Maps JavaScript API works\n\nWhen a call to `fetchAddressValidation` is made the API attempts the following:\n\n- **Corrects** --- Provides component-level vaidation checks, including sub-premises where available.\n- **Completes** --- Attempts to infer missing or incorrect address components.\n- **Formats** --- Cleans up and standardizes the format for address components.\n\nAbout CASS™\n\nThe United States Postal Service® (USPS®)^[1](#fn1)^\nmaintains the [Coding Accuracy Support System (CASS™)](https://postalpro.usps.com/certifications/cass)\nto support and certify address validation providers. A CASS Certified™ service,\nsuch as the Address Validation API, has been confirmed for its\nability to fill in information missing from an address, standardize it, and\nupdate it to give you the most current and most accurate address.\n\nCASS is not enabled by default and is only supported for the \"US\" and \"PR\"\nregions. To enable CASS, set \\`enableUspsCass\\` to \\`true\\` as part of a validation\nrequest. For more information, see [Validate an address](/maps/documentation/javascript/address-validation/TBD).\n\nAs part of our use of USPS services, USPS evaluates requests for artificially created\naddresses. If USPS identifies an input address as being artificially created, Google is\nrequired to stop validating addresses for the customer and must report the customer's\ncontact information (name and address), the relevant input address, and aggregated usage\ndata to USPS. By using the API you consent to these\n[Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\n\nNext steps\n\n- [Get started with Address Validation in Maps JavaScript API](/maps/documentation/javascript/address-validation/start)\n\n*** ** * ** ***\n\n1. Google Maps Platform is a non-exclusive Licensee of the United States Postal Service®. The following trademark(s) are owned by the United States Postal Service® and used with permission: United States Postal Service®, CASS™, CASS Certified™. [↩](#fnref1)"]]
