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ılmıştı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, öğesinin kalitesine bağlı olarak çeşitli alanlar döndürebilir.
çıkış adresi. Örneğin, aşağıda birverdict
olacaktır. Bu değer, 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
özelliğindeki tüm alanlar özetlenmektedir.
Görüntüleyin Referans kılavuzundaki sonuç'u inceleyebilirsiniz. |
Adresin ayrıntı düzeyi
Adres ayrıntı düzeyi,
belirlilik düzeyinden emin olmaktır. validationGranularity
yanıtındaki adres özgünlüğü, bir adresin teslim edilip edilemeyeceğine dair önemli bir sinyaldir.
verdict
özelliği şu ayrıntı düzeyi sinyallerini döndürür:
inputGranularity
— Bağlantının Address Validation API'ye gönderilmesini sağlayın. URL'deki adres ayrıntı düzeyi isteği, doğrulama yanıtındaki adres ayrıntısı 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
: Address Validation API, adresini tam olarak doğrulayabilir. Çoğu durumda,PREMISE
veyaSUB_PREMISE
ayrıntı düzeyi, kalite adresini gösterir teslimat da yapabilirsiniz.geocodeGranularity
— Coğrafi kodun ayrıntı düzeyini tanımlar adresle ilişkilidir. Örneğin, Google kayıtları bir daire numarası olup olmadığı (buna ait tam konum değil) veya kompleks olarak değişti. Böyle bir durumda,validationGranularity
SUB_PREMISE
ancakgeocodeGranularity
is
PREMISE" durumunda.
Görüntüleyin Ayrıntı düzeyi inceleyebilirsiniz. |
Adresin eksiksiz olması
Sonuç, addressComplete
özelliğini
yani hiçbir eksik olmadığından emin olmak için
bitmemiş veya
beklenmedik bileşenler içerir:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Adreste eksik, çözümlenmemiş veya beklenmeyen bileşenler varsa alan
false
olarak ayarlandı.
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ılavuzunda bkz. Address . |
addressComponent
özelliği, address
alt bileşenidir ve
adresteki öğelerin veya bileşenlerinin ayrıntılı bir listesini
Address Validation API işlendi. API her bileşeni tanımlar
alanı, adına, türüne ve onay düzeyine göre gösterilir.
Referans kılavuzunda bkz. addressComponent . |
geocode
mülkü
geocode
özelliği, girişle ilişkilendirilen coğrafi kodlu konumu gösterir.
girin. Bu tesis, konumun kendisi hakkında ayrıntılı bilgi sağlar. Örneğin:
içerir.
Referans kılavuzunda bkz. Geocode . |
metadata
mülkü
Bu özellik, Address Validation API (Adres Doğrulama API'si), ancak adresin konut türünde olup olmadığını gösterir. ya da Posta Kutusu'na gönderebilirsiniz.
Adres Doğrulama API'si kapsamı bölümünü ve Address metadata referansını inceleyin.
|
uspsData
mülkü
Bu özellik, 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 ve UspsData referansını inceleyin.
|