Method: validateAddress

Bir 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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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 yoluyla 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 bugün yoksayılmaktadır. Doğrulanan adres sonucu, sistem tarafından tanımlanan belirtilen adres için tercih edilen dile göre doldurulur.

Address Validation API, recipients ve organization içindeki değerleri yoksayar. Bu alanlardaki değerler silinir ve döndürülmez. Lütfen bunları ayarlamayın.

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 gerekiyorsa (örneğin, kullanıcının ilk doğrulamadan sonra yaptığı değişikliklerin yeniden doğrulanması gerekiyorsa) her takip isteğinde bu alanı doğrulama sırasındaki ilk yanıttan itibaren responseId ile doldurmalıdır.

enableUspsCass

boolean

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

Bileşenleştirilmiş bir address kullanmanız veya alternatif olarak, ilk satırda sokak numarası ve ad, ikinci satırda ise şehir, eyalet ve posta kodu olacak şekilde en az iki google.type.PostalAddress.address_lines belirtmeniz önerilir.

languageOptions

object (LanguageOptions)

İsteğe bağlı. Önizleme: Bu özellik Önizleme aşamasındadır (GKST öncesi). GKST öncesi ürün ve özelliklere verilen destek sınırlı olabilir ve 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.

Address Validation API'yi yanıta ek bilgiler dahil edecek şekilde 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 bir URL ve dosya adı güvenli base64 dizesi olmalıdır. Aksi takdirde bir 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 gelebilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdiğinde jeton artık geçerli olmaz; uygulamanızın her oturum için yeni bir jeton oluşturması gerekir. sessionToken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Not: Adres Doğrulama yalnızca Otomatik Tamamlama (Yeni) API'sinin bulunduğu oturumlarda kullanılabilir, Otomatik Tamamlama API'si ile kullanılamaz. Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/session-pricing sayfasına bakın.

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'nin yeni isteğe eşlik etmesi gerekir.

PostalAddress

Örneğin posta teslimatı veya ödeme adresleri için bir posta adresini temsil eder. Bir posta adresi belirtildiğinde, posta hizmeti, öğeleri bir tesise (posta kutusu veya benzeri) teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.

Tipik kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılması yoluyla oluşturulur.

Adres girişi / düzenleme konusunda tavsiye: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın.) - Bu alanın kullanıldığı ülkelerin dışındaki ülkelerde giriş veya düzenleme işlemleri için kullanıcılara kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağı hakkında daha fazla yardım için lütfen şu adresi ziyaret edin: https://support.google.com/business/answer/6397478

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 değerler API'nin INVALID_ARGUMENT hatası döndürmesine neden olur.

regionCode

string

İsteğe bağlı. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Ayrıntılı bilgi için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html sayfalarına bakın. Örnek: İsviçre için "CH". Bölge kodu sağlanmazsa URL, adresten tahmin edilir. En iyi performans için, biliyorsanız bölge kodunu eklemeniz önerilir. Tutarsız veya tekrarlanan bölgelere sahip olmak düşük performansa yol açabilir. Örneğin, addressLines zaten bölgeyi içeriyorsa bu alana bölge kodunu tekrar sağlamayın. Desteklenen bölgeler SSS sayfasında bulunabilir.

languageCode

string

Giriş adresindeki dil kodu ileride kullanılmak üzere ayrılmıştır ve şu anda yoksayılmaktadır. API, adresin bulunduğu dil için uygun dili döndürür.

postalCode

string

İsteğe bağlı. Adresin posta kodu. Bazı ülkeler, posta kodlarının kullanmaz veya kullanılmasını zorunlu kılmaz ancak posta kodlarının kullanıldığı yerlerde adresin diğer bölümleriyle ek doğrulamayı (ör. ABD'de eyalet/posta kodu doğrulaması) tetikleyebilir.

sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu özellik çoğu bölgede kullanılmaz. Kullanıldığı yerlerde, değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya yalnızca bir sayıdır ve "sektör kodu" (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi"ni (ör. Fildişi Sahili) temsil eder.

administrativeArea

string

İsteğe bağlı. Bir ülkenin veya bölgenin posta adresleri için kullanılan en yüksek idari alt bölüm. Örneğin bu bir eyalet, il, il veya vilayet olabilir. Özellikle, İspanya için bu, özerk topluluk değil idari bölgedir (ör. "Katalonya" değil, "Barselona"). Birçok ülkede, posta adreslerinde idari bölge kullanılmaz. Örneğin, İsviçre'de bu alan boş bırakılmalıdır.

locality

string

İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü belirtir. Örnekler: ABD şehri, BT topluluğu, İngiltere posta şehri. Dünyanın iyi tanımlanmadığı veya bu yapıya tam olarak uymadığı bölgelerde yerel birimi boş bırakın ve addressLines kullanın.

sublocality

string

İsteğe bağlı. Adresin semti. Örneğin; mahalleler, ilçeler, semtler olabilir.

addressLines[]

string

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

AddressLines'taki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden fazla değer içerebileceğinden (ör. "Austin, Teksas") satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır.

Bir adresin izin verilen minimum yapısal temsili, addressLines içine yerleştirilen tüm bilgileri içerir. regionCode sağlanmazsa bölge, adres satırlarından tahmin edilir.

Yalnızca addressLines içeren bir adres oluşturursanız, tamamen yapılandırılmamış adresleri işlemek için önerilen yöntem, adresin hangi bölümlerinin şehirler veya idari bölgeler olacağını tahmin etmek yerine coğrafi kodlamadır.

recipients[]

string

Lütfen bu alanı ayarlamaktan kaçının. Address Validation API'de şu anda bu hizmet kullanılmıyor. Şu anda API bu alan ayarlandığında istekleri reddetmeyecek olsa da, bilgiler silinir ve yanıtta döndürülmez.

organization

string

Lütfen bu alanı ayarlamaktan kaçının. Address Validation API'de şu anda bu hizmet kullanılmıyor. Şu anda API bu alan ayarlandığında istekleri reddetmeyecek olsa da, bilgiler silinir ve yanıtta döndürülmez.

LanguageOptions

Önizleme: Bu özellik Önizleme aşamasındadır (GKST öncesi). GKST öncesi ürün ve özelliklere verilen destek sınırlı olabilir ve 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.

Address Validation API'yi yanıta ek bilgiler dahil edecek şekilde etkinleştirir.

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

boolean

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

ValidationResult

Adres doğrulamanı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 kodlamanın aksine, adresin kendisiyle ilgili bilgiler.

geocode

object (Geocode)

Adresin coğrafi kodlaması yapılan konum ve yerle ilgili bilgiler.

metadata

object (AddressMetadata)

Teslimatla ilgili diğer bilgiler. metadata adresinin, Address Validation API'ye gönderilen her adres için tam olarak doldurulacağı garanti edilmez.

uspsData

object (UspsData)

USPS tarafından sağlanan ekstra teslimat işaretleri. Yalnızca US ve PR bölgelerinde sağlanır.

englishLatinAddress

object (Address)

Önizleme: Bu özellik Önizleme aşamasındadır (GKST öncesi). GKST öncesi ürün ve özelliklere verilen destek sınırlı olabilir ve 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.

Adres İngilizceye çevrilmiştir.

Çevrilen adresler API girişi olarak yeniden kullanılamaz. Hizmet, kullanıcının orijinal dilinde sağlanan adresin doğrulanmasını onaylamak veya reddetmek için kendi ana dilini kullanabilmesini sağlar.

Adresin bir kısmının İngilizce çevirisi yoksa hizmet, söz konusu bölümü Latin alfabesi kullanan alternatif bir dilde döndürür. Alternatif dilin nasıl seçildiğiyle ilgili açıklama için buraya bakın. Adresin bir kısmında Latin alfabesi kullanılan bir dilde çeviri veya harf çevirisi yoksa hizmet, adresle ilişkili yerel dilde o bölümü 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ı doldurulmamış.

Sonuç

Adres doğrulama sonucu ve coğrafi koda üst düzey 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ından kaynaklanır ve herhangi bir doğrulama sinyali sağlamaz. Doğrulama sinyalleri için aşağıdaki validationGranularity politikasına bakın.

Örneğin, giriş adresi belirli bir apartman numarasını içeriyorsa buradaki inputGranularity, SUB_PREMISE olacaktır. Veritabanındaki daire numarasını eşleştiremezsek ya da daire numarası geçersizse validationGranularity büyük olasılıkla PREMISE veya daha küçük bir rakam olacaktır.

validationGranularity

enum (Granularity)

API'nin adresi tamamen validate ayrıntı düzeyi. Örneğin, validationGranularity değeri PREMISE değeri, PREMISE veya daha genel düzeyindeki tüm adres bileşenlerinin doğrulanabileceğini gösterir.

Adres başına 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 kodlaması yapılan konumun ne kadar yüzeysel veya hassas olduğunun semantik anlamı olarak anlaşılabilir.

Bu, zaman zaman 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 kesin konumunu belirleyemeyebilir. Bu durumda, validationGranularity değeri SUB_PREMISE, geocodeGranularity değeri ise PREMISE olur.

addressComplete

boolean

Çözümlenmemiş jeton veya beklenmedik ya da eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa false değeri gösterilir. 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 sayfasına bakın.

hasInferredComponents

boolean

Girişte yer almayan en az bir adres bileşeni tahmin edildi (eklendi). Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components sayfasına göz atın.

hasReplacedComponents

boolean

En az bir adres bileşeni değiştirildi. Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components sayfasına göz atın.

Ayrıntı düzeyi

Bir adresin veya coğrafi kodun sahip olabileceği çeşitli ayrıntı düzeyidir. Bir adres için ayrıntı düzeyini belirtmek amacıyla kullanıldığında bu değerler, adresin bir posta hedefini ne kadar ayrıntılı tanımladığını gösterir. Örneğin, "123 Main Street, Redwood City, CA, 94061" gibi bir adres PREMISE tanımlarken, "Redwood City, CA, 94061" gibi bir adres LOCALITY tanımlar. Bununla birlikte, Redwood City'de "123 Main Street" için coğrafi kodu bulamazsak, adres daha ayrıntılı olmasına rağmen döndürülen coğrafi kodlama LOCALITY ayrıntı düzeyinde olabilir.

Sıralamalar
GRANULARITY_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
SUB_PREMISE Bina seviyesinin altı sonucu (ör. apartman dairesi).
PREMISE Bina düzeyinde sonuç.
PREMISE_PROXIMITY Adresin bina düzeyindeki konumunu yaklaşık olarak gösteren bir coğrafi kod.
BLOCK Adres veya coğrafi kod bir bloğu belirtir. Yalnızca blok düzeyinde adreslemenin bulunduğu bölgelerde (ör. Japonya) kullanılır.
ROUTE Coğrafi kod veya adres, cadde, yol veya otoyol gibi ayrıntılı bir rotadır.
OTHER Teslimat olmadıkları için bir arada gruplanan diğer tüm ayrıntı düzeyleri.

Adres

İşlenen adresin ayrıntıları. Adresin yanlış yazılmış kısımlarının düzeltilmesi, yanlış parçaların değiştirilmesi ve eksik parçalarla ilgili çıkarımların yapılması, işleme sonrası sürecine dahildir.

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 göre tek satırlı bir adres olarak biçimlendirilmiş ve işlendikten sonra olduğu adres.

postalAddress

object (PostalAddress)

Posta adresi olarak gösterilen, sonradan işlenmiş adres.

addressComponents[]

object (AddressComponent)

Sırasız liste. Doğrulama bilgileriyle birlikte biçimlendirilmiş ve düzeltilmiş adresin bağımsız adres bileşenleri. Bu, her bir bileşenin doğrulama durumu hakkında bilgi sağlar.

Adres bileşenleri belirli bir şekilde sıralanmamıştır. Listedeki adres bileşenlerinin sıralamasıyla ilgili varsayımlarda bulunmayın.

missingComponentTypes[]

string

Doğru biçimlendirilmiş bir posta adresinde olması beklenen ancak girişte bulunmayan bileşenlerin türleri tahmin edilemedi. Bu tür bileşenler formattedAddress, postalAddress veya addressComponents içinde mevcut değil. "Boulder, Colorado, 80301, ABD" gibi bir giriş için ['street_number', 'route'] verilebilir. Olası türlerin listesine buradan ulaşabilirsiniz.

unconfirmedComponentTypes[]

string

addressComponents içinde bulunan ancak doğruluğu onaylanamayan bileşenlerin türleri. Bu alan, kolaylık sağlamak amacıyla verilmiştir: Bu alanın içeriği, confirmationLevel öğesinin CONFIRMED olmadığı veya inferred işaretinin true olarak ayarlanmadığı tüm bileşenlerin türlerini bulmak için addressComponents üzerinden yineleme yapılması eşdeğerdir. Olası türlerin listesine buradan ulaşabilirsiniz.

unresolvedTokens[]

string

Girişteki çözümlenemeyen tüm jetonlar. Bu, bir adresin geçerli bölümü olarak tanınmayan bir giriş olabilir (örneğin, "123235253253 Main St, San Francisco, CA, 94105" gibi bir girişte çözümlenmemiş jetonlar ["123235253253"] şeklinde görünebilir, çünkü bu, geçerli bir sokak numarası gibi görünmemektedir.

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 kesinlik düzeyini gösterir.

inferred

boolean

Bileşenin, girişin bir parçası olmadığını ancak adres konumu için tahmin ettiğimizi ve tam adres için sağlanması gerektiğini düşündüğümüzü belirtir.

spellCorrected

boolean

Bileşen adındaki bir yazım hatasının düzeltmesini gösterir. API, "orta"nın "orta" olarak değiştirilmesi gibi farklı yazım biçimlerindeki değişiklikleri her zaman işaretlemez. Ayrıca, "Pkwy" ifadesinin "Amfiteatr Pkwy" olarak değiştirilmesi gibi sık karşılaşılan yazım hataları her zaman işaretlenmez.

replaced

boolean

Bileşen adının tamamen farklı bir adla değiştirildiğini (örneğin, yanlış bir posta kodunun adres için doğru olan bir posta koduyla değiştirilmesi) gösterir. Bu bir görünüm değişikliği değildir. Giriş bileşeni farklı bir bileşenle değiştirildi.

unexpected

boolean

Belirli bir bölge için posta adresinde mevcut olması beklenmeyen bir adres bileşenini gösterir. Bu bilgiyi yalnızca girişin bir parçası olduğu için sakladık.

ComponentName

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

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

string

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

languageCode

string

BCP-47 dil kodu. Bileşen adı sokak numarası gibi bir dille ilişkilendirilmemişse bu uyarı görünmez.

ConfirmationLevel

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

Sıralamalar
CONFIRMATION_LEVEL_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
CONFIRMED Bu bileşenin var olduğunu ve adresin geri kalanında mantıklı olduğunu doğrulayabildik.
UNCONFIRMED_BUT_PLAUSIBLE Bu bileşen onaylanamadı, ancak mevcut olması muhtemeldir. Örneğin, belirli ev numaralarının bilinmediği bir caddedeki bilinen geçerli bir numara aralığındaki sokak numarası.
UNCONFIRMED_AND_SUSPICIOUS Bu bileşen onaylanmadı ve muhtemelen yanlış olabilir. Örneğin, adresin geri kalanına uymayan bir mahalle.

Coğrafi kod

Girişin coğrafi kodlamasının yapıldığı yer hakkında bilgi 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 olarak kodlanmış konumu.

Adres, enlem/boylam koordinatları veya artı kodları yerine yer kimliklerinin kullanılması tercih edilir. Arabayla yol tariflerinin rotasını belirlerken veya hesaplarken koordinatlar kullanıldığında, nokta her zaman bu koordinatlara en yakın yola tutturulur. Bu yol, hedefe hızlı veya güvenli bir şekilde giden bir yol olmayabilir ve tesise erişim noktasının yakınında olmayabilir. Ayrıca bir konumun coğrafi kodlaması ters olduğunda, döndürülen adresin orijinal adresle eşleşeceğine dair bir garanti yoktur.

plusCode

object (PlusCode)

location öğesine karşılık gelen artı kodu.

bounds

object (Viewport)

Coğrafi olarak kodlanan yerin sınırları.

featureSizeMeters

number

Coğrafi olarak kodlanan yerin metre cinsinden boyutu. Bu, coğrafi kodlaması yapılmış konumun yüzeysellik düzeyinin başka bir ölçüsüdür, ancak semantik anlam yerine fiziksel boyuttadır.

placeId

string

Bu girişin coğrafi olarak kodlandığı yerin PlaceID.

Yer Kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz.

placeTypes[]

string

Girişin coğrafi kodlamasını yaptığınız yerin türleri. Örneğin, ['locality', 'political']. Türlerin tam listesini burada bulabilirsiniz.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu değer, enlem ve boylam derece ve boylam derecelerini temsil eden bir çift çiftle ifade edilir. Aksi belirtilmedikçe 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

Artı kodu (http://plus.codes), iki biçime sahip bir konum referansıdır: 14mx14m (1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan global kod ve ön eki referans konumuyla değiştiren bileşik kod.

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

string

Yerin, 1/8000 x 1/8000 derecelik bir alanı (~14x14 metre) temsil eden, "9FWM33GV+HQ" gibi global (tam) kodu.

compoundCode

string

Yerin bileşik kodu. Örneğin, "33GV+HQ, Ramberg, Norveç". Global kodun son ekini içerir ve ön eki, referans varlığın biçimlendirilmiş adıyla değiştirir.

Görüntü alanı

low ve high puntonun çapraz olarak iki noktasıyla temsil edilen enlem-boylam görüntü alanı. Bir görüntü alanı, kapalı bir bölge olarak kabul edilir, yani sınırını içerir. Enlem sınırları -90 ile 90 derece dahil, boylam sınırları ise -180 ile 180 derece (bu değerler dahil) arasında olmalıdır. Bazı durumlar şunlardır:

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

  • low.longitude > high.longitude ise boylam aralığı ters ç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ş olur.

  • 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ş görüntü alanı hataya neden olur.

Örneğin, bu görünüm 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 alçak noktası.

high

object (LatLng)

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

AddressMetadata

Adresin meta verileri. metadata adresinin, 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

Bir işletmenin adresi olduğunu belirtir. Ayarlanmaması, değerin bilinmediğini gösterir.

poBox

boolean

Bir posta kutusunun adresini belirtir. Ayarlanmaması, değerin bilinmediğini gösterir.

residential

boolean

Bunun bir konut adresi olduğunu belirtir. Ayarlanmaması, değerin bilinmediğini gösterir.

UspsData

Adrese ait USPS verileri. uspsData adresinin, Address Validation API'ye gönderilen her US veya PR adresi için tam olarak doldurulacağı garanti edilmez. Yanıtın birincil parçası olarak uspsData'yı 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ış adres.

deliveryPointCode

string

2 haneli teslimat noktası kodu

deliveryPointCheckDigit

string

Teslimat noktası kontrol basamağı. Bu sayı, mekanik olarak taranan postalar için delivery_point_barcode öğesinin sonuna eklenir. Delivery_point_barcode, deliveryPointCheckDigit, posta kodu ve ZIP+4 öğelerinin tüm rakamları 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 doğrulanamadı.
  • D: Adres yalnızca birincil numara için DPV olarak onaylandı ve ikincil numara bilgileri eksikti.
  • S: Adres DPV yalnızca birincil numara için onaylandı ve ikincil numara bilgisi mevcut ancak onaylanmadı.
  • Y: Adres, birincil ve ikincil numaralar için DPV olarak onaylandı.
  • Boş: Yanıt bir dpvConfirmation değeri içermiyorsa adres, DPV onayı için gönderilmemiş demektir.
dpvFootnote

string

Teslim noktası doğrulamasındaki dipnotlar. Birden çok dipnot aynı dize içinde birbirine dökülebilir.

  • 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şti (tüm bileşenler)
  • CC: İkincil numara eşleşmedi ve gerekli değil
  • C1: İkincil numara eşleşmedi ancak gerekli
  • N1: Çok katlı adreste ikincil numara eksik
  • M1: Birincil numara eksik
  • M3: Birincil numara geçersiz
  • P1: Giriş adresi PO, RR veya HC kutu numarası eksik
  • P3: Giriş adresi PO, RR veya HC Box numarası geçersiz
  • F1: Askeri adresle eşleşen giriş adresi
  • G1: Genel teslimat adresiyle eşleşen giriş adresi
  • U1: Benzersiz bir posta koduyla eşleşen giriş adresi
  • PB: Giriş adresi, PBSA kaydıyla eşleşti
  • RR: PMB bilgilerine sahip DPV onaylı adres
  • R1: PMB bilgisi içermeyen DPV onaylı adres
  • R7: Operatör Rotası R777 veya R779 kaydı
  • IA: Bilgi verilen adres tespit edildi
  • TA: Sondaki alfa çıkarılarak eşleştirilen birincil sayı
dpvCmra

string

Adresin bir CMRA (Ticari Posta Alma Ajansı) (müşteriler için posta alan özel bir işletme) olup olmadığını belirtir. Tek bir karakter döndürür.

  • Y: Adres bir CMRA'dır
  • N: Adres bir CMRA değil
dpvVacant

string

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

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

string

Bu istatistik adresi yok mu yoksa etkin bir adres mi? Hiçbir istatistik adresi, sürekli dolu olmayan veya USPS'nin hizmet vermediği adresler değildir. 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 Açılır Adres) – Doğrudan USPS'den posta almayan ancak kendilerine hizmet veren bir gönderim adresine teslim edilen adresler.
  • 2: CDS - Henüz yayınlanabilir hale gelmemiş adresler. Örneğin, partilerin ve birincil sayıların belirlendiği yeni bir alt bölüm, ancak henüz doluluk için yapının bulunmadığı bir bölüm.
  • 3: Çarpışma - DPV doğrulaması yapmayan adresler.
  • 4: CMZ (Üniversite, Askeri ve Diğer Türler) - USPS'nin verilere dahil ettiği ZIP + 4 kayıt.
  • 5: Normal - Adresin teslim alınmadığını ve bu adreslerin olası teslimat olarak sayılmadığını belirtir.
  • 6: İkincil Zorunlu - Adres için ikincil bilgi gerekiyor.
dpvDrop

string

İşaret, postaları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 alıcıya teslim edilir.
  • N: Posta, bir sitedeki tek bir alıcıya teslim edilmiyor.
dpvThrowback

string

Postanın açık adrese teslim edilmediğini belirtir. Tek bir karakter döndürür.

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

string

İşaret, posta tesliminin haftanın her günü gerçekleştirilmediğini gösterir. Tek bir karakter döndürür.

  • Y: Posta teslimi haftanın her günü gerçekleştirilmez.
  • N: Posta tesliminin haftanın her günü yapılmadığını göstermez.
dpvNonDeliveryDaysValues

integer

Teslim edilmeyen günleri tanımlayan tam sayı. Bit işaretleri kullanılarak sorgulanabilir: 0x40 – Pazar teslimat yapılmayan bir günü ifade eder 0x20 – Pazartesi teslimat yapılmayan bir günü temsil eder 0x10 – Salı teslimat yapılmayan bir gündür 0x08 – Çarşamba günü teslimat yapılmayan bir gündür 0x04 – Perşembe, teslimat yapılmayan bir gün 0x02 – Cuma 0x02 teslimat yapılmayan bir gündür 01 Cumartesi, teslimat yapılmayan bir gündür

dpvNoSecureLocation

string

Bayrak, kapının erişilebilir olduğunu ancak güvenlikle ilgili nedenlerden dolayı paket bırakılmayacaktır. Tek bir karakter döndürür.

  • Y: Güvenlikle ilgili nedenlerden dolayı paket bırakılmayacak.
  • N: Güvenlikle ilgili endişeler nedeniyle paketin bırakılmayacağına dair bir işaret yok.
dpvPbsa

string

Adresin PBSA kaydıyla eşleştirildiğini belirtir. 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

Bayrak, USPS'nin posta teslim etmek için bir kapıyı çalamayacağı adresleri belirtir. Tek bir karakter döndürür.

  • Y: Kapıya erişilemiyor.
  • N: Kapının erişilebilir olmadığını belirten bir uyarı yok.
dpvEnhancedDeliveryCode

string

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

  • Y: Adres, birincil ve ikincil numaralar için DPV olarak onaylandı.
  • N: Birincil ve ikincil numara bilgileri DPV doğrulanamadı.
  • S: Adresin DPV yalnızca birincil numara için olduğu onaylanmıştır ve ikincil numara bilgisi "onaylanmadı" şeklinde mevcuttur veya DPV eşleşmesi ve ikincil bilgiler sağlanması amacıyla birincil numaranın sonundaki tek bir alfa kaldırılmıştır.
  • D: Adres yalnızca birincil numara için DPV olarak onaylandı ve ikincil numara bilgileri eksikti.
  • R: Adres onaylandı, ancak R777 ve R779 hayali karayoluna atanmış ve USPS teslimatı sağlanmadı.
carrierRoute

string

Operatörün rota kodu. Bir harfli ön ek ve üç basamaklı bir güzergah göstergesinden oluşan dört karakterli bir kod.

Ön ekler:

  • C: Taşıyıcı rotası (veya şehir karayolu)
  • R: Kırsal karayolu
  • H: Otoyol Sözleşme Rotası
  • B: Posta Kutusu Bölümü
  • G: Genel teslimat birimi
carrierRouteIndicator

string

Kargo şirketi rota hızı sıralama göstergesi.

ewsNoMatch

boolean

Teslim adresi eşleşiyor, ancak EWS dosyası, kısa bir süre içinde tam eşleşmenin hazır olacağını gösteriyor.

postOfficeCity

string

Ana postane şehri.

postOfficeState

string

Ana postane eyaletidir.

abbreviatedCity

string

Kısaltılmış şehir.

fipsCountyCode

string

FIPS ülke 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) birimi belirteci.

pmbNumber

string

PMB (Özel Posta Kutusu) numarası;

addressRecordType

string

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

  • F: SABİT. Bu, bir adres için mevcut en iyi eşleşme düzeyi olan Tam Kayıt ile eşleşmedir.
  • G: GENEL TESLİM. Bu, Genel Teslim kaydı ile eşleşiyor.
  • H: YAPI / Daire. Bu değer, bir Bina veya Apartman kaydı ile eşleşiyor.
  • P: RESMİ KUTUSU. Bu, bir Postane Kutusu ile eşleşmedir.
  • R: KÖTÜ AMAÇLI ROTA veya YOL TARİHİ: Bu, her ikisi de ilişkili kutu numarası aralıklarına sahip olabilecek Kırsal Rota veya Otoyol Sözleşme kaydı ile eşleşir.
  • S: SOKAK KAYDI: Bu, geçerli bir birincil numara aralığı içeren bir Street kaydıyla eşleşmesidir.
defaultAddress

boolean

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

errorMessage

string

USPS veri alımı için hata mesajı. Bu alan, yapay olarak oluşturulmuş adreslerin algılanması nedeniyle USPS işlemesi askıya alındığında doldurulur.

Bu hata oluştuğunda USPS veri alanları doldurulmayabilir.

cassProcessed

boolean

İsteğin CASS tarafından işlendiğine dair gösterge.

UspsAddress

ABD'deki bir adresin 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).