Method: validateAddress

Adresi doğrular.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
Alanlar
address

object (PostalAddress)

Zorunlu. Doğrulanan adres. Biçimlendirilmemiş adresler addressLines üzerinden gönderilmelidir.

Bu girişteki alanların toplam uzunluğu 280 karakteri aşmamalıdır.

Desteklenen bölgeleri burada bulabilirsiniz.

Giriş adresindeki languageCode değeri gelecekteki kullanımlar için ayrılmıştır ve şu anda yoksayılır. Doğrulanmış adres sonucu, sistem tarafından tanımlanan belirli bir adres için tercih edilen dile göre doldurulur.

Address Validation API, recipients ve organization içindeki değerleri yok sayar. Bu alanlardaki tüm değerler atılır ve döndürülmez. Lütfen bunları ayarlamayınız.
previousResponseId

string

İlk adres doğrulama isteği için bu alan boş olmalıdır. Tek bir adresi tamamen doğrulamak için daha fazla istek gerekirse (örneğin, kullanıcının ilk doğrulamadan sonra yaptığı değişikliklerin yeniden doğrulanması gerekiyorsa) her takip isteği bu alanı, doğrulama sırasının ilk yanıtındaki responseId ile doldurmalıdır.
enableUspsCass

boolean

USPS CASS uyumlu modu etkinleştirir. Bu durum, google.maps.addressvalidation.v1.ValidationResult öğesinin google.maps.addressvalidation.v1.ValidationResult.usps_data alanını yalnızca etkiler. Not: Porto Riko'daki adresler için USPS CASS etkinleştirilmiş isteklerde, address google.type.PostalAddress.region_code değeri "PR" olarak veya address google.type.PostalAddress.administrative_area değeri "Porto Riko" (büyük/küçük harf duyarlı değildir) veya "PR" olarak sağlanmalıdır.

Bileşenli bir address kullanılması önerilir. Alternatif olarak, ilk satırın sokak numarasını ve adını, ikinci satırın ise şehri, eyaletini ve posta kodunu içerdiği en az iki google.type.PostalAddress.address_lines belirtebilirsiniz.
languageOptions

object (LanguageOptions)

İsteğe bağlı. Önizleme: Bu özellik önizleme sürümündedir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Address Validation API'nin yanıta ek bilgiler eklemesini sağlar.
sessionToken

string

İsteğe bağlı. Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan dize. En fazla 36 ASCII karakter uzunluğunda, URL ve dosya adı için güvenli bir base64 dizesi olmalıdır. Aksi takdirde INVALID_ARGUMENT hatası döndürülür.

Oturum, kullanıcı bir Otomatik Tamamlama sorgusu yaptığında başlar ve kullanıcı bir yer seçip Yer Ayrıntıları veya Adres Doğrulama çağrısı yapıldığında sona erer. Her oturumda birden fazla Otomatik Tamamlama sorgusu ve ardından bir Yer Ayrıntıları veya Adres Doğrulama isteği olabilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessionToken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Not: Adres Doğrulama, yalnızca Autocomplete API ile değil, Autocomplete (Yeni) API ile olan oturumlarda kullanılabilir. Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/session-pricing adresini ziyaret edin.

Yanıt gövdesi

Adres doğrulama isteğine verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
Alanlar
result

object (ValidationResult)

Adres doğrulamasının sonucu.
responseId

string

Bu yanıtı tanımlayan UUID. Adresin yeniden doğrulanması gerekiyorsa bu UUID yeni isteğe eklenmelidir.

PostalAddress

Posta adresini (ör. posta teslimatı veya ödeme adresleri için) temsil eder. Posta hizmetleri, posta adresi verilen öğeleri bir tesise, posta kutusuna veya benzeri bir yere teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.

Normal kullanımda, adresler işlem türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi veya düzenlemeyle ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararasılaştırmaya hazır bir adres widget'ı kullanın. - Kullanıcılara, ilgili alanın kullanıldığı ülkeler dışındaki alanların girişi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla bilgi için https://support.google.com/business/answer/6397478 adresini ziyaret edin.

JSON gösterimi 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Alanlar
revision

integer

PostalAddress öğesinin şema düzeltmesi. 0 dışındaki tüm değerler API'nin INVALID_ARGUMENT hatası döndürmesine neden olur.
regionCode

string

İsteğe bağlı. Adresin bulunduğu ülke/bölgenin CLDR bölge kodu. Ayrıntılar için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adreslerine bakın. Örnek: İsviçre için "CH". Bölge kodu sağlanmazsa adresten anlaşılır. En iyi performans için, biliyorsanız bölge kodunu eklemeniz önerilir. Tutarsız veya yinelenen bölgelerin olması performansın düşmesine neden olabilir. Örneğin, addressLines zaten bölgeyi içeriyorsa bu alanda bölge kodunu tekrar sağlamaz. Desteklenen bölgeleri SSS bölümünde bulabilirsiniz.
languageCode

string

Giriş adresindeki dil kodu gelecekteki kullanımlar için ayrılmıştır ve şu anda yoksayılır. API, adresi bulunduğu yere uygun dilde döndürür.
postalCode

string

İsteğe bağlı. Adresin posta kodu. Posta kodları her ülkede kullanılmaz veya zorunlu tutulmaz ancak kullanıldıkları yerlerde adresin diğer bölümleriyle birlikte ek doğrulama tetiklenebilir (ör. ABD'de eyalet veya posta kodu doğrulaması).
sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu, çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, "CEDEX" gibi bir dizedir ve isteğe bağlı olarak bir sayı (ör. "CEDEX 7") ekler veya "sektör kodu"nu (Jamaika), "teslimat bölgesi göstergesini" (Malavi) ya da "posta ofisi göstergesini" (Côte d'Ivoire) temsil eden tek bir sayıdır.
administrativeArea

string

İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim. Örneğin, bu bir eyalet, il, oblast veya idari bölge olabilir. İspanya için bu, özerk topluluk değil ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülkede posta adreslerinde idari bölge kullanılmaz. Örneğin, İsviçre'de bu alan doldurulmamalıdır.
locality

string

İsteğe bağlı. Genellikle adresin şehir veya kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da komün, Birleşik Krallık'ta posta bölgesi. Yerelliklerin iyi tanımlanmadığı veya bu yapıya iyi uymadığı bölgelerde locality alanını boş bırakın ve addressLines alanını kullanın.
sublocality

string

İsteğe bağlı. Adresin alt mahallesi. Örneğin, bu bir mahalle, semt veya ilçe olabilir.
addressLines[]

string

Zorunlu. Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.

addressLines içindeki değerler tür bilgisine sahip olmadığı ve bazen tek bir alanda birden fazla değer içerebildiği için (ör. "Austin, TX") satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin bulunduğu ülke/bölge için "zarf sırası" olmalıdır.

Bir adresin izin verilen minimum yapısal temsili, addressLines içine yerleştirilen tüm bilgilerden oluşur. regionCode sağlanmazsa bölge, adres satırlarından anlaşılır.

Tamamen yapılandırılmamış adresleri işlemek için önerilen yöntem, yalnızca addressLines içeren bir adres oluşturmak ve ardından coğrafi kodlama yapmaktır (adresin hangi bölümlerinin yerel yönetim bölgeleri veya idari bölgeler olması gerektiğini tahmin etmek yerine).
recipients[]

string

Lütfen bu alanı ayarlamayın. Address Validation API şu anda bu özelliği kullanmıyor. API şu anda bu alanın ayarlandığı istekleri reddetmese de bilgiler atılır ve yanıtta döndürülmez.
organization

string

Lütfen bu alanı ayarlamayın. Address Validation API şu anda bu özelliği kullanmıyor. API şu anda bu alanın ayarlandığı istekleri reddetmese de bilgiler atılır ve yanıtta döndürülmez.

LanguageOptions

Önizleme: Bu özellik önizleme sürümündedir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Address Validation API'nin yanıta ek bilgiler eklemesini sağlar.

JSON gösterimi 
{
  "returnEnglishLatinAddress": boolean
}
Alanlar
returnEnglishLatinAddress

boolean

Önizleme: İngilizce bir google.maps.addressvalidation.v1.Address döndürür. Ayrıntılar için google.maps.addressvalidation.v1.ValidationResult.english_latin_address sayfasına bakın.

ValidationResult

Bir adresin doğrulanmasının sonucu.

JSON gösterimi 
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
Alanlar
verdict

object (Verdict)

Genel karar işaretleri
address

object (Address)

Coğrafi kod yerine adresin kendisiyle ilgili bilgiler.
geocode

object (Geocode)

Adresin coğrafi kodlandığı konum ve yer hakkında bilgi.
metadata

object (AddressMetadata)

Yayınlanabilirlikle ilgili diğer bilgiler. metadata değerinin, Address Validation API'ye gönderilen her adres için tam olarak doldurulacağı garanti edilmez.
uspsData

object (UspsData)

USPS tarafından sağlanan ek teslim edilebilirlik işaretleri. Yalnızca US ve PR bölgesinde sağlanır.
englishLatinAddress

object (Address)

Önizleme: Bu özellik önizleme sürümündedir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Adresin İngilizceye çevrilmiş hali.

Çevrilmiş adresler API girişi olarak yeniden kullanılamaz. Hizmet, kullanıcının ilk verilen adresin doğrulanmasını onaylamak veya reddetmek için kendi ana dilini kullanabilmesi amacıyla bu seçenekleri sunar.

Adresin bir kısmının İngilizce çevirisi yoksa hizmet bu kısmı Latin alfabesi kullanan alternatif bir dilde döndürür. Alternatif dilin nasıl seçildiğiyle ilgili açıklama için burayı inceleyin. Adresin bir kısmının Latin alfabesi kullanan bir dilde çevirisi veya transliterasyonu yoksa hizmet bu kısmı adresle ilişkili yerel dilde döndürür.

google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address işaretini kullanarak bu çıkışı etkinleştirin.

Not: englishLatinAddress içindeki google.maps.addressvalidation.v1.Address.unconfirmed_component_types alanı ve englishLatinAddress.address_components içindeki google.maps.addressvalidation.v1.AddressComponent.confirmation_level alanları doldurulmamıştır.

Sonuç

Adres doğrulama sonucuna ve coğrafi kodlamaya genel bakış.

JSON gösterimi 
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}
Alanlar
inputGranularity

enum (Granularity)

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 aşağıdaki validationGranularity bölümüne bakın.

Örneğin, giriş adresi belirli bir daire numarasını içeriyorsa buradaki inputGranularity değeri SUB_PREMISE olur. Apartman numarası veritabanlarında eşleşemezse veya geçersizse validationGranularity muhtemelen PREMISE veya daha kötü olur.
validationGranularity

enum (Granularity)

API'nin adresi tamamen doğrulayabileceği ayrıntı düzeyi. Örneğin, PREMISE değerinin PREMISE olması, PREMISE düzeyindeki veya daha kaba düzeydeki tüm adres bileşenlerinin doğrulanabileceğini gösterir.validationGranularity

Adres bileşeni başına doğrulama sonucunu google.maps.addressvalidation.v1.Address.address_components'te bulabilirsiniz.
geocodeGranularity

enum (Granularity)

geocode öğesinin ayrıntı düzeyi hakkında bilgi. Bu, coğrafi kodlanmış konumun ne kadar kaba veya hassas olduğunun anlamsal anlamı olarak anlaşılabilir.

Bu, bazen yukarıdaki validationGranularity değerinden farklı olabilir. Örneğin, veri tabanımızda bir apartman numarasının varlığı kaydedilmiş olabilir ancak büyük bir apartman kompleksindeki apartmanın tam konumu olmayabilir. Bu durumda validationGranularity SUB_PREMISE olur ancak geocodeGranularity PREMISE olur.
addressComplete

boolean

Çözümlenmemiş jeton, beklenmedik veya eksik adres bileşeni yoksa adresin eksik olmadığı kabul edilir. Ayarlanmamışsa değerin false olduğunu gösterir. Daha fazla bilgi için missingComponentTypes, unresolvedTokens veya unexpected alanlarına bakın.
hasUnconfirmedComponents

boolean

En az bir adres bileşeni kategorize edilemiyor veya doğrulanamıyor. Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components bölümüne bakın.
hasInferredComponents

boolean

Girişte bulunmayan en az bir adres bileşeni çıkarıldı (eklendi). Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components bölümüne bakın.
hasReplacedComponents

boolean

En az bir adres bileşeni değiştirildi. Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components bölümüne bakın.

Ayrıntı düzeyi

Bir adresin veya coğrafi kodun sahip olabileceği çeşitli ayrıntı düzeyleri. Bir adres için ayrıntı düzeyini belirtmek amacıyla kullanıldığında bu değerler, adresin posta adresini ne kadar ayrıntılı bir şekilde tanımladığını gösterir. Örneğin, "123 Ana Cadde, Redwood City, CA, 94061" gibi bir adres PREMISE'ü, "Redwood City, CA, 94061" gibi bir adres ise LOCALITY'ü tanımlar. Ancak Redwood City'deki "123 Main Street" için coğrafi kod bulamıyorsak adres daha ayrıntılı olsa bile döndürülen coğrafi kod LOCALITY ayrıntı düzeyinde olabilir.

Sıralamalar
GRANULARITY_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
SUB_PREMISE Apartman gibi bina düzeyinin altındaki sonuç.
PREMISE Bina düzeyinde sonuç.
PREMISE_PROXIMITY Adresin bina düzeyindeki konumuna yaklaşık olarak karşılık gelen bir coğrafi kod.
BLOCK Adres veya coğrafi kod, bir bloğu gösterir. Yalnızca Japonya gibi blok düzeyinde adresleme bulunan bölgelerde kullanılır.
ROUTE Coğrafi kod veya adres, cadde, yol veya otoyol gibi rotaya göre ayrıntılıdır.
OTHER Yayınlanamadığı için birlikte gruplandırılan diğer tüm ayrıntı düzeyleri.

Adres

Son işleme tabi tutulan adresin ayrıntıları. İşleme sonrası, adresin yanlış yazılan kısımlarının düzeltilmesi, yanlış kısımların değiştirilmesi ve eksik kısımların tahmin edilmesi işlemlerini içerir.

JSON gösterimi 
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
Alanlar
formattedAddress

string

Adresin bulunduğu bölgenin adres biçimlendirme kurallarına uygun olarak tek satırlık bir adres olarak biçimlendirilmiş, son işleme tabi tutulan adres.

Not: Bu adresin biçimi, postalAddress alanındaki adresin biçimiyle eşleşmeyebilir. Örneğin, postalAddress her zaman ülkeyi 2 harfli bir regionCode olarak temsil eder (ör. "US" veya "NZ"). Buna karşılık bu alanda, ülke adının daha uzun bir biçimi (ör. "ABD" veya "Yeni Zelanda") kullanılır.
postalAddress

object (PostalAddress)

Posta adresi olarak temsil edilen, son işleme tabi tutulan adres.
addressComponents[]

object (AddressComponent)

Sırasız liste. Biçimlendirilmiş ve düzeltilmiş adresin ayrı adres bileşenleri ile doğrulama bilgileri. Bu sayfada, bileşenlerin doğrulama durumu hakkında bilgi verilir.

Adres bileşenleri belirli bir düzende sıralanmamalıdır. Listede adres bileşenlerinin sıralaması hakkında herhangi bir varsayımda bulunmayın.
missingComponentTypes[]

string

Doğru biçimlendirilmiş bir posta adresinde bulunması beklenen ancak girişte bulunmayan VE çıkarılamayan bileşen türleri. Örneğin, "Boulder, Colorado, 80301, ABD" gibi bir giriş için ['street_number', 'route'] kullanılabilir. Olası türlerin listesini burada bulabilirsiniz.

Not: Eksik bileşeni zaten sağladığınızı düşündüğünüzde eksik bileşen türü görebilirsiniz. Örneğin, giriş adresi bina adını içeriyorsa ancak tesis numarasını içermiyorsa bu durumla karşılaşabilirsiniz. "渋谷区渋谷３丁目　Shibuya Stream" adresinde, "Shibuya Stream" bina adı premise bileşen türüne sahiptir ancak tesis numarası eksik olduğundan missingComponentTypes, premise değerini içerir.
unconfirmedComponentTypes[]

string

addressComponents içinde bulunan ancak doğru olduğu doğrulanamayan bileşen türleri. Bu alan kolaylık sağlamak için sağlanmıştır: İçeriği, confirmationLevel'un CONFIRMED olmadığı veya inferred işaretinin true olarak ayarlanmadığı tüm bileşenlerin türlerini bulmak için addressComponents içinde iterasyon gerçekleştirmekle aynıdır. Olası türlerin listesini burada bulabilirsiniz.
unresolvedTokens[]

string

Girişteki çözülemeyen jetonlar. Bu, bir adresin geçerli bir parçası olarak tanınmayan bir giriş olabilir. Örneğin, "Parsel 0000123123 ve 0000456456 Cadde # Guthrie Center IA 50115 ABD" gibi bir giriş için çözülmemiş jetonlar ["Parcel", "0000123123", "&", "0000456456"] gibi görünebilir.

AddressComponent

Sokak, şehir veya eyalet gibi bir adres bileşenini temsil eder.

JSON gösterimi 
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
Alanlar
componentName

object (ComponentName)

Bu bileşenin adı.
componentType

string

Adres bileşeninin türü. Olası türlerin listesi için Tablo 2: Yerler hizmeti tarafından döndürülen ek türler bölümüne bakın.
confirmationLevel

enum (ConfirmationLevel)

Bileşenin doğru olduğuna dair sahip olduğumuz kesinlik düzeyini gösterir.
inferred

boolean

Bileşenin girişin bir parçası olmadığını, ancak adres konumu için tahmin edildiğini ve tam bir adres için sağlanmasının gerektiğini gösterir.
spellCorrected

boolean

Bileşen adındaki bir yazım hatasının düzeltildiğini gösterir. API, her zaman bir yazım varyantından diğerine yapılan değişiklikleri işaretlemez (ör. "centre" yerine "center"). Ayrıca, "Amphitheater Pkwy"nin "Amphitheatre Pkwy" olarak değiştirilmesi gibi yaygın yazım hatalarını her zaman işaretlemez.
replaced

boolean

Bileşenin adının tamamen farklı bir adla değiştirildiğini gösterir. Örneğin, yanlış bir posta kodu, adres için doğru olan bir adla değiştirilmiştir. Bu, görünümle ilgili bir değişiklik değildir. Giriş bileşeni farklı bir bileşenle değiştirilmiştir.
unexpected

boolean

Belirli bir bölgenin posta adresinde bulunması beklenmeyen bir adres bileşenini gösterir. Bu ifadeyi yalnızca girişin bir parçası olduğu için koruduk.

ComponentName

Bileşenin adı için bir sarmalayıcı.

JSON gösterimi 
{
  "text": string,
  "languageCode": string
}
Alanlar
text

string

Ad metni. Örneğin, sokak adı için "5. Cadde" veya bina numarası için "1253".
languageCode

string

BCP-47 dil kodu. Bileşen adı bir dil (ör. bina numarası) ile ilişkilendirilmemişse bu alan gösterilmez.

ConfirmationLevel

Onay düzeyleri için olası farklı değerler.

Sıralamalar
CONFIRMATION_LEVEL_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
CONFIRMED Bu bileşenin mevcut olduğunu ve adresin geri kalanıyla uyumlu olduğunu doğrulayabildik.
UNCONFIRMED_BUT_PLAUSIBLE Bu bileşen doğrulanamadı ancak var olduğu varsayılabilir. Örneğin, belirli bina numaralarının bilinmediği bir sokaktaki bilinen geçerli bir sayı aralığındaki bir sokak numarası.
UNCONFIRMED_AND_SUSPICIOUS Bu bileşen doğrulanmadı ve yanlış olabilir. Örneğin, adresin geri kalanına uymayan bir mahalle.

Coğrafi kod

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

JSON gösterimi 
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
Alanlar
location

object (LatLng)

Girişin coğrafi kodlanmış konumu.

Adresler, enlem/boylam koordinatları veya plus code'lar yerine yer kimlikleri tercih edilir. Rota belirlerken veya sürüş yol tariflerini hesaplarken koordinatlar kullanıldığında, nokta her zaman bu koordinatlara en yakın yola sabitlenir. Bu yol, hedefe hızlı veya güvenli bir şekilde ulaşan bir yol olmayabilir ve tesisin erişim noktasının yakınında olmayabilir. Ayrıca, bir konumun ters coğrafi kodlaması yapıldığında, döndürülen adresin orijinal adresle eşleşeceği garanti edilmez.
plusCode

object (PlusCode)

location değerine karşılık gelen plus code.
bounds

object (Viewport)

Coğrafi olarak kodlanmış yerin sınırları.
featureSizeMeters

number

Coğrafi kodlanmış yerin metre cinsinden boyutu. Bu, coğrafi kodlanmış konumun kabalığının başka bir ölçümüdür ancak semantik anlam yerine fiziksel boyuttadır.
placeId

string

Bu girişin coğrafi kodladığı yerin PlaceID'si.

Yer kimlikleri hakkında daha fazla bilgi için burayı ziyaret edin.
placeTypes[]

string

Girişin coğrafi kodlandığı yer türleri. Örneğin, ['locality', 'political']. Türlerin tam listesini burada bulabilirsiniz.

LatLng

Bir enlem/boylam çiftini temsil eden nesne. Bu değer, enlem derecelerini ve boylam derecelerini temsil eden bir çift çift olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90,0; +90,0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180,0; +180,0] aralığında olmalıdır.

PlusCode

Plus code (http://plus.codes), iki biçime sahip bir konum referansı: 14 m x 14 m (derecenin 1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan genel kod ve ön eki referans konumla değiştiren birleşik kod.

JSON gösterimi 
{
  "globalCode": string,
  "compoundCode": string
}
Alanlar
globalCode

string

"9FWM33GV+HQ" gibi yerin küresel (tam) kodu. 1/8000 ile 1/8000 derecelik bir alanı (~14 metreye 14 metre) temsil eder.
compoundCode

string

Yerin birleşik kodu ("33GV+HQ, Ramberg, Norveç" gibi). Bu kod, genel kodun son ekini içerir ve ön eki, referans öğenin biçimlendirilmiş adıyla değiştirir.

Görüntü alanı

Çapraz olarak karşı karşıya iki low ve high noktası olarak gösterilen bir enlem-boylam görüntü alanı. Görüntü alanı kapalı bir bölge olarak kabul edilir. Yani görüntü alanı, sınırını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (dahil) arasında olmalıdır. Çeşitli durumlar şunlardır:

  • low = high ise görüntü alanı tek bir noktadan oluşur.

  • low.longitude > high.longitude ise boylam aralığı tersine çevrilir (görüntü alanı 180 derece boylam çizgisini geçer).

  • low.longitude = -180 derece ve high.longitude = 180 derece ise görüntü alanı tüm boylamları içerir.

  • low.longitude = 180 derece ve high.longitude = -180 derece ise boylam aralığı boştur.

  • low.latitude > high.latitude ise enlem aralığı boştur.

Hem low hem de high doldurulmalıdır ve temsil edilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Boş bir görüntü alanı hataya neden olur.

Örneğin, bu görüntü alanı New York'u tamamen kapsıyor:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON gösterimi 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Alanlar
low

object (LatLng)

Zorunlu. Görüntü alanının alt noktası.
high

object (LatLng)

Zorunlu. Görüntü alanının en yüksek noktası.

AddressMetadata

Adresin meta verileri. metadata değerinin, Address Validation API'ye gönderilen her adres için tam olarak doldurulacağı garanti edilmez.

JSON gösterimi 
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
Alanlar
business

boolean

Bu adresin bir işletmenin adresi olduğunu gösterir. Ayarlanmamışsa değerin bilinmediğini gösterir.
poBox

boolean

Adresin posta kutusuna ait olduğunu belirtir. Ayarlanmamışsa değerin bilinmediğini gösterir.
residential

boolean

Bu adresin bir konutun adresini belirtir. Ayarlanmamışsa değerin bilinmediğini gösterir.

UspsData

Adresin USPS verileri. Address Validation API'ye gönderilen her ABD veya PR adresi için uspsData değerinin tam olarak doldurulacağı garanti edilmez. Yanıtın birincil kısmı olarak uspsData'yı kullanıyorsanız yedek adres alanlarının yanıta entegre edilmesi önerilir.

JSON gösterimi 
{
  "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
}
Alanlar
standardizedAddress

object (UspsAddress)

USPS standartlaştırılmış adresi.
deliveryPointCode

string

2 haneli teslimat noktası kodu
deliveryPointCheckDigit

string

Teslimat noktası kontrol basamağı. Bu numara, mekanik olarak taranan posta için delivery_point_barcode değerinin sonuna eklenir. delivery_point_barcode, deliveryPointCheckDigit, postal_code ve ZIP+4 değerlerinin tüm basamakları toplandığında 10'a bölünebilen bir sayı elde edilmelidir.
dpvConfirmation

string

DPV onayı için olası değerler. Tek bir karakter döndürür veya hiçbir değer döndürmez.

  • N: Birincil ve ikincil numara bilgileri DPV ile onaylanamadı.
  • D: Adres, yalnızca birincil numara için DPV onaylıydı ve ikincil numara bilgileri eksikti.
  • S: Adres yalnızca birincil numara için DPV onayı almış, ikincil numara bilgileri mevcut ancak onaylanmamış.
  • Y: Adres, birincil ve ikincil numaralar için DPV onayı aldı.
  • Boş: Yanıt dpvConfirmation değeri içermiyorsa adres, DPV onayı için gönderilmemiştir.
dpvFootnote

string

Teslimat noktası doğrulamasından alınan dipnotlar. Aynı dize içinde birden fazla dipnot bulunabilir.

  • AA: ZIP+4 dosyasıyla eşleşen giriş adresi
  • A1: Giriş adresi, ZIP+4 dosyasıyla eşleşmedi
  • BB: DPV ile eşleştirildi (tüm bileşenler)
  • CC: İkincil numara eşleşmedi ve gerekli değil
  • C1: İkincil numara eşleşmedi ancak gerekli
  • N1: Yüksek katlı binanın adresinde ikincil numara eksik
  • M1: Birincil numara eksik
  • M3: Birincil numara geçersiz
  • P1: Giriş adresi PO, RR veya HC posta kutusu numarası eksik
  • P3: Giriş adresi PO, RR veya HC posta kutusu numarası geçersiz
  • F1: Giriş adresi, askeri bir adresle eşleşti
  • G1: Giriş adresi, genel teslimat adresiyle eşleşti
  • U1: Benzersiz bir posta koduyla eşleşen giriş adresi
  • PB: Giriş adresi PBSA kaydıyla eşleşti
  • RR: PMB bilgileriyle DPV onaylı adres
  • R1: PMB bilgileri olmadan DPV onaylı adres
  • R7: Operatör Rotası R777 veya R779 kaydı
  • IA: Bildirilen adres belirlendi
  • TA: Sonuna bir alfabe karakteri ekleyerek eşleşen birincil sayı
dpvCmra

string

Adresin CMRA (ticari posta alma acentesi) olup olmadığını belirtir. CMRA, müşteriler için posta alan özel bir işletmedir. Tek bir karakter döndürür.

  • Y: Adres bir CMRA ise
  • N: Adres CMRA değil
dpvVacant

string

Burası boş mu? Tek bir karakter döndürür.

  • Y: Adres boş
  • N: Adres boş değil
dpvNoStat

string

Bu adres istatistikleri olmayan bir adres mi yoksa etkin bir adres mi? No stat addresses, sürekli olarak kullanılmayan veya USPS'nin hizmet vermediği adreslerdir. Tek bir karakter döndürür.

  • Y: Adres etkin değil
  • N: Adres etkin
dpvNoStatReasonCode

integer

NoStat türünü belirtir. Neden kodunu int olarak döndürür.

  • 1: IDA (Dahili Posta Adresi) – Doğrudan USPS'den posta almayan ancak kendilerine hizmet veren bir posta adresine teslim edilen adresler.
  • 2: CDS: Henüz teslimat için hazır olmayan adresler. Örneğin, parsellerin ve birincil numaraların belirlendiği ancak henüz yerleşim için yapı bulunmayan yeni bir alt bölüm.
  • 3: Çakışma: DPV ile doğrulanmayan adresler.
  • 4: CMZ (Kolej, Askeri ve Diğer Türleri) - USPS'nin verilere dahil ettiği posta kodu + 4 kaydı.
  • 5: Normal: Teslimat yapılmayan adresleri gösterir ve bu adresler olası teslimatlar olarak sayılmaz.
  • 6: İkincil Bilgi Gerekli: Adres için ikincil bilgiler gereklidir.
dpvDrop

string

İşaret, postanın bir sitedeki tek bir alıcıya teslim edildiğini gösterir. Tek bir karakter döndürür.

  • Y: Posta, bir sitedeki tek bir posta kutusuna teslim edilir.
  • N: Posta, bir sitedeki tek bir posta kutusuna teslim edilmiyor.
dpvThrowback

string

Postanın sokak adresine teslim edilmediğini gösterir. Tek bir karakter döndürür.

  • Y: Posta, açık adrese teslim edilmiyor.
  • N: Posta, açık adrese teslim edilir.
dpvNonDeliveryDays

string

İşaret, posta tesliminin haftanın her günü yapılmadığını gösterir. Tek bir karakter döndürür.

  • Y: Posta teslimatı haftanın her günü yapılmaz.
  • N: Posta teslimatının haftanın her günü yapılmadığına dair bir gösterge yok.
dpvNonDeliveryDaysValues

integer

Yayınlanmayan günleri tanımlayan tam sayı. Bit işaretleri kullanılarak sorgulanabilir: 0x40 – Pazar teslimat yapılmayan bir gündür 0x20 – Pazartesi teslimat yapılmayan bir gündür 0x10 – Salı teslimat yapılmayan bir gündür 0x08 – Çarşamba teslimat yapılmayan bir gündür 0x04 – Perşembe teslimat yapılmayan bir gündür 0x02 – Cuma teslimat yapılmayan bir gündür 0x01 – Cumartesi teslimat yapılmayan bir gündür
dpvNoSecureLocation

string

İşaret, kapıya erişilebildiğini ancak güvenlik nedeniyle paketin bırakılmayacağını gösterir. Tek bir karakter döndürür.

  • Y: Güvenlik nedeniyle paket bırakılmaz.
  • N: Güvenlik endişeleri nedeniyle paketin bırakılmayacağına dair bir gösterge yok.
dpvPbsa

string

Adresin PBSA kaydıyla eşleştiğini gösterir. Tek bir karakter döndürür.

  • Y: Adres, PBSA kaydıyla eşleştirildi.
  • N: Adres, PBSA kaydıyla eşleşmedi.
dpvDoorNotAccessible

string

İşaret, USPS'nin posta dağıtmak için kapı çalamadığı adresleri gösterir. Tek bir karakter döndürür.

  • Y: Kapıya erişilemiyor.
  • N: Kapıya erişilemediğine dair bir işaret yok.
dpvEnhancedDeliveryCode

string

Adres için birden fazla DPV dönüş kodu geçerli olduğunu gösterir. Tek bir karakter döndürür.

  • Y: Adres, birincil ve ikincil numaralar için DPV onayı aldı.
  • N: Birincil ve ikincil numara bilgileri DPV ile onaylanamadı.
  • S: Adres, yalnızca birincil numara için DPV onayı aldı ve ikincil numara bilgileri mevcuttu ancak onaylanmadı veya DPV eşleşmesi ve ikincil bilginin gerekli olması için birincil numaradaki tek bir son harf atlandı.
  • D: Adres, yalnızca birincil numara için DPV onaylıydı ve ikincil numara bilgileri eksikti.
  • R: Adres onaylandı ancak hayali rota R777 ve R779'a atandı ve USPS teslimatı sağlanmıyor.
carrierRoute

string

Kargo şirketinin rota kodu. Bir harfli ön ek ve üç haneli rota tanımlayıcısı içeren dört karakterli bir kod.

Önekler:

  • C: Kargo rotası (veya şehir rotası)
  • R: Kırsal rota
  • H: Otoyol Sözleşmesi Rotası
  • B: Posta Kutusu Bölümü
  • G: Genel teslimat birimi
carrierRouteIndicator

string

Kargo şirketi rota ücreti sıralama göstergesi.
ewsNoMatch

boolean

Teslimat adresi eşleşebilir ancak EWS dosyası, yakında tam eşleşmenin bulunacağını gösterir.
postOfficeCity

string

Ana posta ofisi şehri.
postOfficeState

string

Ana posta ofisi durumu.
abbreviatedCity

string

Kısaltılmış şehir.
fipsCountyCode

string

FIPS ilçe kodu.
county

string

İlçe adı.
elotNumber

string

Gelişmiş Seyahat Rotası (eLOT) numarası.
elotFlag

string

eLOT Artan/Azalan İşareti (A/D).
poBoxOnlyPostalCode

boolean

Yalnızca posta kutusu posta kodu.
pmbDesignator

string

PMB (Özel Posta Kutusu) birim tanımlayıcısı.
pmbNumber

string

PMB (Özel Posta Kutusu) numarası;
addressRecordType

string

Giriş adresiyle eşleşen adres kaydının türü.

  • F: FİRMA. Bu, bir firma kaydıyla eşleşmedir. Bu, bir adres için kullanılabilen en hassas eşleşme düzeyidir.
  • G: GENEL TESLİMAT. Bu, genel teslimat kaydıyla eşleşmedir.
  • H: BİNA / APARTMAN. Bu, bir bina veya daire kaydıyla eşleşmedir.
  • P: POSTA KUTUSU. Bu, bir posta kutusuyla eşleşmedir.
  • R: KÖY YOLU veya KARAYOLU SÖZLEŞMESİ: Bu, bir Köy Yolu veya Karayolu Sözleşmesi kaydıyla eşleşmedir. Her ikisinin de ilişkili Posta Kutusu Numarası aralıkları olabilir.
  • S: SOKAK KAYDI: Bu, geçerli bir birincil numara aralığı içeren bir sokak kaydıyla eşleşmedir.
defaultAddress

boolean

Varsayılan bir adresin bulunduğunu ancak daha spesifik adreslerin bulunduğunu gösteren gösterge.
errorMessage

string

USPS verilerinin alınmasıyla ilgili hata mesajı. Bu alan, yapay olarak oluşturulmuş adreslerin algılanması nedeniyle USPS işleme işlemi askıya alındığında doldurulur.

Bu hata mevcut olduğunda USPS veri alanları doldurulmayabilir.
cassProcessed

boolean

İsteğin CASS ile işlendiğini gösteren gösterge.

UspsAddress

ABD adresinin USPS temsili.

JSON gösterimi 
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
Alanlar
firstAddressLine

string

İlk adres satırı.
firm

string

Firma adı.
secondAddressLine

string

İkinci adres satırı.
urbanization

string

Porto Riko'daki kentleşme adı.
cityStateZipAddressLine

string

Şehir + eyalet + posta kodu.
city

string

Şehir adı.
state

string

2 harfli eyalet kodu.
zipCode

string

Posta kodu (ör. 10009).
zipCodeExtension

string

4 haneli posta kodu uzantısı (ör. 5023).