Address Validation API, JSON biçiminde bir yanıt gövdesi sağlar iki üst düzey özellik içeren nesne:
result
,ValidationResult
türündeki bir nesneresponseID
{
"result": {
// Validation verdict.
"verdict": {},
// Address details determined by the API.
"address": {},
// The geocode generated for the input address.
"geocode": {},
// Information indicating if the address is a business, residence, etc.
"metadata": {},
// Information about the address from the US Postal Service
// ("US" and "PR" addresses only).
"uspsData": {},
},
// A unique identifier generated for every request to the API.
"responseId": "ID"
}
Bu dokümanda result
nesnesine odaklanılmaktadır. Daha fazla bilgi için
responseID
için Güncellenen adresleri işleme başlıklı makaleye göz atın.
verdict
mülkü
verdict
özelliği, adres doğrulamasının sonuçlarını özetler ve
adres denetimi mantığı oluştururken değerlendirilecek ilk özellik olmalıdır.
Özellik, çıkış adresinin kalitesine bağlı olarak çeşitli alanlar döndürebilir. Örneğin, aşağıdaki örnekte iyi kalitede bir adresin verdict
mülkü gösterilmektedir. Bu mülk, söz konusu istek için 4 alan döndürür:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Aşağıdaki bölümlerde, verdict
mülkünde bulunan tüm alanlar özetlenmiştir.
Görüntüleyin Referans kılavuzundaki sonuç'u inceleyebilirsiniz. |
Adresin ayrıntı düzeyi
Adres ayrıntı düzeyi, bir adresin veya coğrafi kodun özgünlüğünü belirlemek için kullanılan ayrıntı düzeyini ifade eder.
validationGranularity
yanıtı, bir adresin olup olmadığına dair önemli bir sinyaldir
teslimat olabilir.
verdict
mülkü aşağıdaki ayrıntı düzeyi sinyallerini döndürür:
inputGranularity
— Bağlantının Address Validation API'ye gönderilmesini sağlayın. İstekte belirtilen adres ayrıntı düzeyi, doğrulama yanıtındaki adres ayrıntı düzeyini etkiler. Örneğin,inputGranularity
değerininPREMISE
altında olan bir adres düzeyi genelliklePREMISE
değerinevalidationGranularity
ile sonuçlanmaz. seviyesinde olmalıdır.validationGranularity
: Adres Doğrulama API'sinin adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Çoğu durumda,PREMISE
veyaSUB_PREMISE
ayrıntı düzeyi, kalite adresini gösterir teslimat da yapabilirsiniz.geocodeGranularity
: Adresle ilişkili coğrafi kodla ilgili ayrıntı düzeyini belirtir. Örneğin, Google kayıtları bir daire numarası olup olmadığı (buna ait tam konum değil) veya kompleks olarak değişti. Bu durumda,validationGranularity
SUB_PREMISE
olur ancakgeocodeGranularity
is
PREMISE` olur.
Referans kılavuzundaki Ayrıntı düzeyi bölümüne bakın. |
Adresin eksiksiz olması
Sonuç, addressComplete
mülkünü yüksek kaliteli bir adres sinyali olarak döndürür. Bu, adresin eksik, çözülmemiş veya beklenmedik bileşenleri olmadığı anlamına gelir:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Adreste eksik, çözülmemiş veya beklenmedik bileşenler varsa alan false
olarak ayarlanır.
addressComplete sayfasını inceleyin
Sonuç ve
Başvuru kılavuzunda Adres. |
Adres kalitesi
Bazı olası alanlar, adres bileşenleriyle ilgili sorunları gösterir veya
(ör. tahmin edilen veya eksik adres bileşenleri) Örneğin,
örnek, aşağıdaki verdict
özelliği onaylanmamış olan bir adresi gösterir
bileşenler ve eksik addressComplete
alanı:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true,
"hasInferredComponents": true
}
Referans kılavuzunda Sonuç'a bakın. |
address
ve addressComponent
özellikleri
address
özelliği, aşağıda sağlanan işlenmiş adres için biçimlendirme sağlar:
aşağıdaki bilgiler dahil olmak üzere adresin bileşen düzeyindeki özetleriyle birlikte,
adresin yanlış yazılmış kısımları, yanlış kısımları değiştirildi ve çıkarımda bulunulan eksik adres
parçalar.
Referans kılavuzundaki Address bölümüne bakın. |
addressComponent
mülkü, Address Validation API'nin işlediği adresin öğelerinin (veya bileşenlerinin) ayrıntılı bir listesini sağlayan address
'nin bir alt bileşenidir. API, her bileşen alanını adı, türü ve onay düzeyine göre tanımlar.
Referans kılavuzundaki addressComponent bölümüne bakın. |
geocode
mülkü
geocode
mülkü, giriş adresiyle ilişkili coğrafi kodlanmış konumu gösterir. Bu tesis, konumun kendisi hakkında ayrıntılı bilgi sağlar. Örneğin:
içerir.
Referans kılavuzundaki Geocode bölümüne bakın. |
metadata
mülkü
Bu özellik, Address Validation API tarafından işlenen her adres için doldurulmayabilir ancak adresin ikamet, işletme veya posta kutusu türü olup olmadığını belirtir.
Address Validation API kapsamına ve Address metadata referansına bakın.
|
uspsData
mülkü
Bu mülk, ABD posta adresleri için yararlı bilgiler sağlar.
Ancak, doğrulanan her adres için bu alanın tam olarak doldurulacağı garanti edilmez.
hizmet alır. Bu nedenle,
yalnızca adresleri doğrulamak anlamına gelir, ancak bunun yerine verdict
ve
address
tane de var.
ABD adreslerini işleme bölümüne ve UspsData referansına bakın.
|