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 gövdesi aşağıdaki yapıya sahip 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, belirtilen adres için sistem tarafından tanımlandığı şekilde 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 tam olarak 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, yalnızca google.maps.addressvalidation.v1.ValidationResult öğesinin google.maps.addressvalidation.v1.ValidationResult.usps_data alanını 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 aşamasındadır (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca, bu ürün ve özelliklerde yapılan değişiklikler GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Yanıta ek bilgiler eklemek için Address Validation API'yi etkinleştirir.
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 bir GEÇERSİZ_BAĞ_DEĞ_SAY 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

Bir posta adresini (ör. posta teslimatı veya ödeme adresleri için) temsil eder. Posta hizmetleri, posta adresi verilen bir tesise, posta kutusuna veya benzeri bir yere ürün 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/düzenlemeyle ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararası kullanıma 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 lütfen 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ğlamayınız. 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 bugün yok sayılır. API, adresin bulunduğu konuma uygun dildeki adresi 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 (ör. ABD'de eyalet/posta kodu doğrulaması) tetiklenebilir.
sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu, çoğu bölgede kullanılmaz. Kullanıldığı durumlarda değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya yalnızca "sektör kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malavi) veya "postane göstergesi"ni (ör. Fildişi Sahili) 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 vilayet olabilir. Özellikle, İ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/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ığı dünyanın bölgelerinde, locality alanını boş bırakın ve addressLines alanını kullanın.
sublocality

string

İsteğe bağlı. Adresin alt konumu. Örneğin, mahalleler, ilçeler, semtler bu kapsamdadır.
addressLines[]

string

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

addressLines içindeki değerler tür bilgisi içermediği ve bazen tek bir alanda birden fazla değer içerebileceğ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.

Adres Doğrulama API'sinin 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.

İngilizceye çevrilen adres.

Çevrilmiş adresler API girişi olarak yeniden kullanılamaz. Hizmet, kullanıcının orijinal olarak sağlanan 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 ve englishLatinAddress.address_components içindeki google.maps.addressvalidation.v1.AddressComponent.confirmation_level alanları doldurulmaz.

Sonuç

Adres doğrulama sonucu ve coğrafi koda 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 düşük olur.
validationGranularity

enum (Granularity)

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

Adrese göre bileşen doğrulama sonucu google.maps.addressvalidation.v1.Address.address_components içinde bulunabilir.
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, veritabanımız bir apartman numarasının varlığını kaydedebilir, ancak büyük bir apartman kompleksindeki dairenin tam konumu olmayabilir. Bu durumda, validationGranularity SUB_PREMISE, geocodeGranularity ise PREMISE olur.
addressComplete

boolean

Çözümlenmemiş jeton, beklenmedik veya eksik adres bileşeni yoksa adres tamamlanmış kabul edilir. Ayarlanmamışsa değerin false olduğunu gösterir. Daha fazla ayrıntı 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 bir posta hedefini tanımlama ne kadar ayrıntılı olduğunu 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 adreslemenin olduğu 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ıralı değil. 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 bileşen türleri VE çıkarılamadı. Bu tür bileşenler formattedAddress, postalAddress veya addressComponents içinde bulunmaz. "Boulder, Colorado, 80301, ABD" gibi bir giriş için ['street_number', 'route'] buna örnek olarak verilebilir. Olası türlerin listesini burada bulabilirsiniz.
unconfirmedComponentTypes[]

string

addressComponents içinde bulunan ancak doğru olduğu onaylanamayan bileşenlerin 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 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 parçası olmadığını, ancak adres konumu için tahmin ettiğimizi ve tam bir adres için sağlanması gerektiğini düşünüyoruz.
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ştirilir. 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. Bunu yalnızca girişin bir parçası olduğu için sakladık.

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 mevcut olması muhtemel. Örneğin, belirli ev numaralarının bilinmediği bir sokaktaki bilinen geçerli numara aralığında yer alan sokak numarası.
UNCONFIRMED_AND_SUSPICIOUS Bu bileşen onaylanmadı ve yanlış olması muhtemel. Ö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 kullanılması 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 konum ters coğrafi kodlandığı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 kodlu yerin metre cinsinden boyutu. Bu, coğrafi olarak kodlanan konumun ne kadar kalın olduğunun başka bir ölçüsüdür, ancak anlam açısından değil fiziksel boyutuyla ilgilidir.
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, enlem 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

Derece cinsinden enlem. [-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

Yerin 1/8.000 x 1/8.000 derecelik bir alanı (~14 x 14 metre) temsil eden "9FWM33GV+HQ" gibi global (tam) kodu.
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. Bu tür durumlara örnek olarak şunlar verilebilir:

  • 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 derecelik 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 City'yi tamamen kapsar:

{ "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

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

boolean

Bir posta kutusunun adresini 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 parçası olarak uspsData kullanıyorsanız yedek adres alanlarını yanıta entegre etmeniz ö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 öğesinin 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 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 onaylandı. İkincil numara bilgisi mevcuttu ancak onaylanmadı.
  • 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. Birden çok dipnot aynı dizeye sıralanabilir.

  • 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şmiyor ancak zorunlu
  • 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: Genel teslimat adresiyle eşleşen giriş adresi
  • U1: Benzersiz bir posta koduyla eşleşen adres girin
  • PB: PBSA kaydıyla eşleşen giriş adresi
  • RR: DPV, PMB bilgileriyle onaylanmış adres
  • R1: DPV onaylı adres PMB bilgisi içermiyor
  • R7: Operatör Rotası R777 veya R779 kaydı
  • IA: Bildirilen adres tanımlandı
  • 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
  • N: Adres CMRA değildir
dpvVacant

string

Bu yer 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? Statik adresler, 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ü gösterir. Neden kodunu int olarak döndürür.

  • 1: IDA (Dahili Varsayılan Adres) – Doğrudan USPS'den posta almayan ancak bu hizmetlerin sunulduğu bir teslim 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 doğrulaması yapılmayan adresler.
  • 4: CMZ (Üniversite, Askeri ve Diğer Türler): ZIP + 4 kayıt USPS'nin verilere dahil ettiği kayıtlar.
  • 5: Normal: Yayınlanmayan adresleri gösterir ve bu adresler olası yayınlar 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, sitedeki tek bir alıcıya 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, 0x20 günü yayınlanmama günüdür - Pazartesi günü yayınlanmama günüdür 0x10 - Salı, yayınlanmama günüdür 0x08 - Salı günü yayınlanmama günüdür 0x04 - Perşembe günü yayınlanmama günüdür 0x02 - Cuma günü teslim edilmez 0x0 günüdür 0x0
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üvenlikle ilgili endişeler nedeniyle paketin bırakılmayacağına dair bir gösterge yoktur.
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şti.
  • N: Adres, PBSA kaydıyla eşleşmedi.
dpvDoorNotAccessible

string

İşaret, USPS'nin posta teslim etmek için kapıyı açamayacağı adresleri gösterir. Tek bir karakter döndürür.

  • Y: Kapıya erişilemez.
  • 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 ve USPS teslimatına atanmış.
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: Operatör 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 postane eyaleti.
abbreviatedCity

string

Kısaltılmış şehir.
fipsCountyCode

string

FIPS ilçe kodu.
county

string

İlçe adı.
elotNumber

string

Geliştirilmiş Seyahat Hattı (eLOT) numarası.
elotFlag

string

eLOT Artan/Azalan İşaret (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: FIRM. Bu, bir adres için mümkün olan en yüksek eşleşme düzeyi olan Kesin Kayıt ile eşleşmedir.
  • G: GENEL TESLİMAT. Bu, genel teslimat kaydıyla eşleşmedir.
  • H: BİNA / APARTMAN. Bu, bir Bina veya Apartman kaydı ile eşleşiyor.
  • 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şmenin 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).