Temel adres doğrulama yanıtını anlama

Address Validation API yanıtı şu üst düzey özellikleri içerir:

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // 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"
}

verdict mülkü

verdict özelliği, adres doğrulamanın sonuçlarını özetler ve adres kontrolü mantığı oluşturulurken 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 kaliteli bir adresin verdict özelliği gösterilmektedir. Bu özellik, bu istek için aşağıdaki alanları döndürür:

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

Aşağıdaki bölümlerde, verdict özelliğindeki tüm alanlar özetlenmiştir.

Referans kılavuzundaki Karar bölümüne bakın.

Adresin ayrıntı düzeyi

Adres ayrıntı düzeyi, bir adresin veya coğrafi kodun özgüllüğünü belirlemek için kullanılan ayrıntı düzeyini ifade eder. Yanıttaki validationGranularity adres özgüllüğü, bir adresin teslim edilebilir olup olmadığına dair önemli bir sinyaldir.

verdict özelliği şu ayrıntı düzeyi sinyallerini döndürür:

  • inputGranularity: Maps JavaScript API'deki Address Validation'a gönderilen adresten alınan ayrıntı düzeyini açıklar. İstekteki adres ayrıntısı düzeyi, doğrulama yanıtındaki adres ayrıntısı düzeyini etkiler. Örneğin, PREMISE seviyesinin altında inputGranularity olan bir adres genellikle PREMISE seviyesine validationGranularity ile sonuçlanmaz.
  • validationGranularity: Maps JavaScript API'deki Address Validation'ın adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Çoğu durumda, PREMISE veya SUB_PREMISE ayrıntı düzeyi, adresin kaliteli ve muhtemelen teslimat yapılabilir olduğunu gösterir.
  • geocodeGranularity: Adresle ilişkili coğrafi kodun ayrıntı düzeyini açıklar. Örneğin, Google kayıtları bir apartman dairesi numarasının varlığını gösterebilir ancak büyük bir apartman kompleksindeki bu dairenin tam konumunu göstermeyebilir. Bu durumda, validationGranularity SUB_PREMISE, geocodeGranularity ise PREMISE olur.
Referans kılavuzundaki Ayrıntı düzeyi bölümüne bakın.

Adresin eksiksiz olması

Karar, yüksek kaliteli bir adres için sinyal olarak addressComplete özelliğini döndürür. Bu, özellikle eksik, çözümlenmemiş veya beklenmedik bileşenlerin olmadığı anlamına gelir:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

Adreste eksik, çözümlenmemiş veya beklenmeyen bileşenler olduğunda alan false olarak ayarlanır.

Referans kılavuzunda Karar ve Adres altındaki addressComplete bölümüne bakın.

Adres kalitesi

Olası alanlardan bazıları, adres bileşenleriyle ilgili sorunları veya bunlarda yapılan düzenlemeleri (ör. tahmin edilen veya eksik adres bileşenleri) gösterir. Örneğin, aşağıdaki verdict özelliği, onaylanmamış bileşenleri olan ve addressComplete alanı eksik bir adresi gösterir:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}
Referans kılavuzundaki Karar bölümüne bakın.

Sonraki olası işlem

possibleNextAction değerlendirme alanı, API yanıtının yorumlayıcı bir özetini sunar. Bu özet, daha sonra gerçekleştirilebilecek olası bir işlemin belirlenmesine 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.

address ve addressComponent özellikleri

address özelliği, istekte sağlanan işlenmiş adres için biçimlendirme sağlar. Ayrıca adresin yanlış yazılmış kısımları, değiştirilen yanlış kısımları ve eksik kısımları dahil olmak üzere adresin bileşen düzeyinde özetlerini sunar.

Referans kılavuzundaki Address bölümüne bakın.

addressComponent özelliği, address özelliğinin bir alt bileşenidir. Bu özellik, Maps JavaScript API'deki Address Validation tarafından işlenen adres öğelerinin veya bileşenlerinin ayrıntılı bir listesini sağlar. API, her bileşen alanını adı, türü ve onay düzeyiyle tanımlar.

Referans kılavuzundaki addressComponent bölümüne bakın.

geocode mülkü

geocode özelliği, giriş adresiyle ilişkili coğrafi kodlu konumu belirtir. Bu özellik, konumun kendisiyle ilgili ayrıntıları (ör. yer kimliği) sağlar.

Referans kılavuzundaki Geocode bölümüne bakın.

metadata mülkü

Bu özellik, Maps JavaScript API'deki Address Validation tarafından işlenen her adres için doldurulmayabilir ancak adresin konut, işletme veya posta kutusu türünde olup olmadığını gösterir.

Address Validation API kapsamı ve Address metadata referansına bakın.

uspsData mülkü

Bu özellik, ABD posta adresleri için yararlı bilgiler sağlar. Ancak hizmet tarafından doğrulanan her adres için bu alanın tamamen doldurulacağı garanti edilmez. Bu nedenle, adresleri doğrulamak için yalnızca bu özelliğe güvenmemeli, verdict ve address özelliklerini de kontrol etmelisiniz.

ABD adreslerini işleme ve USPSData referansına bakın.