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

İ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 aracılığıyla 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 yok sayı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 yoksayar. Bu alanlardaki tüm 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 tamamen 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ındaki ilk yanıttan itibaren 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 özellikli isteklerde address bir google.type.PostalAddress.region_code, "PR" olarak, address bir google.type.PostalAddress.administrative_area ise "Porto Riko" (büyük/küçük harfe duyarlı değil) ya da "PR" olarak sağlanmalıdır.

Bileşenlere ayrılmış bir address kullanmanız veya alternatif olarak en az iki google.type.PostalAddress.address_lines belirtmeniz önerilir. İlk satır sokak numarası ve adı, ikinci satır ise şehir, eyalet ve posta kodunu içerir.

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. 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şaması 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 bir URL ve dosya adı güvenli base64 dizesi olmalıdır. Aksi takdirde bir GEÇERSİZ_BAĞ_DEĞ_SAY hatası döndürülür.

Oturum, kullanıcı Otomatik Tamamlama sorgusu yaptığında başlar ve bir yer seçip Yer Ayrıntıları ya da 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. Oturum sona erdiğinde jeton artık geçerli olmaz. Bu nedenle 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, herhangi bir oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Not: Adres Doğrulama yalnızca Otomatik Tamamlama (Yeni) API'si olan oturumlarda kullanılabilir; Otomatik Tamamlama API'si ile kullanılamaz. Daha ayrıntılı 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ğinin 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 yeni isteğe bu UUID'nin eşlik etmesi gerekir.

PostalAddress

Bir posta adresini (ör. posta teslimatı veya ödeme adresleri için) temsil eder. Bir posta hizmeti, posta adresi verildiğinde bir yere, posta kutusuna veya benzer bir yere ürün teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemesi amaçlanmamıştır.

Normal kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi aracılığıyla ya da mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi / düzenleme ile ilgili öneri: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın) - Kullanıcılara, alanın kullanıldığı ülkeler dışındaki alanların girilmesi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla yardım için lütfen bkz: 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 inceleyin. Örnek: İsviçre için "CH". Bölge kodu sağlanmazsa adresten belirlenir. En iyi performans için, biliyorsanız bölge kodunu eklemeniz önerilir. Tutarsız veya tekrarlanan bölgeler olması düşük performansa yol açabilir. Örneğin, addressLines zaten bölgeyi içeriyorsa bu alanda bölge kodunu tekrar girmeyin. 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. Bazı ülkeler posta kodlarını kullanmaz veya gerekli kılmaz, ancak kullanıldıkları yerde adresin diğer kısımlarında 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 ad ç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 bölüm. Ö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 ülke, posta adreslerinde idari bölge kullanmaz. Ör. İsviçre'de bu alan doldurulmamalıdır.

locality

string

İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT komünü, Birleşik Krallık posta şehri. Dünyada yerlerin iyi tanımlanmadığı veya bu yapıya pek uygun olmadığı bölgelerde, locality alanını boş bırakın ve addressLines kullanın.

sublocality

string

İsteğe bağlı. Adresin alt konumu. Örneğin; mahalle, kaza, ilçe olabilir.

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ğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebileceğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır.

Bir adresin yapısal olarak izin verilen minimum 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şturup coğrafi kodlamayı kullanarak tamamen yapılandırılmamış adresleri işleyebilirsiniz (adresin hangi bölümlerinin yerel bölgeler veya idari bölgeler olması gerektiğini tahmin etmek yerine).

recipients[]

string

Lütfen bu alanı ayarlamaktan kaçının. Address Validation API şu anda bu özelliği kullanmıyor. Şu anda API bu alan ayarlandığında istekleri reddetmeyecek olsa da bilgiler silinecek ve yanıtta döndürülmeyecektir.

organization

string

Lütfen bu alanı ayarlamaktan kaçının. Address Validation API şu anda bu özelliği kullanmıyor. Şu anda API bu alan ayarlandığında istekleri reddetmeyecek olsa da bilgiler silinecek ve yanıtta döndürülmeyecektir.

LanguageOptions

Önizleme: Bu özellik önizleme aşamasındadır (GKST öncesi). GKST öncesi ürün 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şaması açıklamalarını inceleyin.

Yanıta ek bilgiler eklemek için Address Validation API'yi 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ını ziyaret edin.

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 olarak kodlandığı konum ve yer hakkında bilgiler.

metadata

object (AddressMetadata)

Teslimatla ilgili diğer bilgiler. metadata öğesinin, Address Validation API'ye gönderilen her adres için tamamen 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. 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şaması açıklamalarını inceleyin.

İngilizceye çevrilen adres.

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

Adresin bir bölümünün İngilizce çevirisi yoksa hizmet, söz konusu bölümü Latin alfabesini 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 bölümünün Latin alfabesinin kullanıldığı bir dilde çeviri veya harf çevirisi yoksa hizmet, söz konusu bölümü 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 alanındaki google.maps.addressvalidation.v1.Address.unconfirmed_component_types alanı, 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ından kaynaklanır ve herhangi bir doğrulama sinyali sağlamaz. Doğrulama sinyalleri için aşağıdaki validationGranularity bölümüne bakın.

Örneğin girilen adres belirli bir apartman numarası içeriyorsa buradaki inputGranularity değeri SUB_PREMISE olur. Veritabanlarındaki apartman numarasını eşleştiremezsek veya apartman numarası geçersizse validationGranularity büyük olasılıkla PREMISE veya daha düşük olur.

validationGranularity

enum (Granularity)

API'nin adresi tam olarak validate ayrıntı düzeyi. Örneğin, PREMISE için validationGranularity değeri, PREMISE veya daha genel 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 olarak kodlanan konumun ne kadar kalın ya da hassas olduğunun anlamsal anlamı olarak anlaşılabilir.

Bu, zaman zaman yukarıdaki validationGranularity'dan 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ş simge ya da beklenmedik veya eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa 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 edilemez veya doğrulanamıyor. Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components sayfasına bakın.

hasInferredComponents

boolean

Girişte olmayan 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 adresine göz atı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, "Vatan Caddesi No: 123, İstanbul, 34110" gibi bir adres PREMISE adresini, "Kadıköy, Türkiye, 94061" gibi bir adres ise LOCALITY öğesini tanımlar. Ancak, Redwood City'deki "123 Main Street" için bir coğrafi kod bulamazsak, döndürülen coğrafi kod, adres daha ayrıntılı olmasına rağmen LOCALITY ayrıntı düzeyinde olabilir.

Sıralamalar
GRANULARITY_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
SUB_PREMISE Apartman dairesi gibi bina altı seviyesi.
PREMISE Bina düzeyinde sonuç.
PREMISE_PROXIMITY Adresin bina düzeyindeki konumunu tahmin eden 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, sokak, yol veya otoyol gibi ayrıntılı rota bilgileri içeriyor.
OTHER Teslim edilebilir olmadıkları için bir arada toplanan diğer tüm ayrıntı düzeyiler.

Adres

İşlenen adresin ayrıntıları. İşleme sonrası adres, adresin yanlış yazılmış bölümlerinin düzeltilmesini, yanlış parçalarının değiştirilmesini ve eksik parçalarla ilgili çıkarımda bulunulmasını içerir.

JSON gösterimi
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
Alanlar
formattedAddress

string

Sonradan işlenmiş adres; adresin bulunduğu bölgenin adres biçimlendirme kurallarına göre tek satırlık bir adres olarak biçimlendirilmiştir.

postalAddress

object (PostalAddress)

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

addressComponents[]

object (AddressComponent)

Sırasız liste. Biçimlendirilmiş ve düzeltilmiş adresin doğrulama bilgileriyle birlikte tek tek adres bileşenleri. Bu, her 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ı 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 mevcut değildir. "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 amacıyla sağlanmıştır: confirmationLevel öğesinin CONFIRMED olmadığı veya inferred işaretinin true değerine ayarlanmadığı tüm bileşenlerin türlerini bulmak için addressComponents aracılığıyla yineleme yapmaya eşdeğerdir. Olası türlerin listesini burada bulabilirsiniz.

unresolvedTokens[]

string

Girişteki çözümlenemeyen jetonlar. Bu, adresin geçerli bir parçası olarak tanınmayan bir giriş olabilir (örneğin, "123235253253 Main St, San Francisco, CA, 94105" gibi bir girişte, geçerli bir sokak numarası gibi görünmediğinden çözümlenmemiş jetonlar ["123235253253"] şeklinde 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ğundan emin 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üzeltilmesini gösterir. Bu API, "orta" yerine "orta" kullanımında olduğu gibi, bir yazım varyantından diğerine yapılan değişiklikleri her zaman işaretlemez. Ayrıca, "Amfiteatr Pkwy"nin "Amfiteatr Pkwy" olarak değiştirilmesi gibi yaygın yazım hataları da her zaman işaretlenmez.

replaced

boolean

Bileşen adının tamamen farklı bir adla değiştirildiğini belirtir (örneğin, adres için doğru olan bir posta kodunun yerini alması). Bu görünümle ilgili bir değişiklik değil. Giriş bileşeni farklı bir bileşenle değiştirildi.

unexpected

boolean

Belirli bir bölgenin posta adresinde bulunması beklenmeyen bir adres bileşenini belirtir. 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 sokak numarası için "1253".

languageCode

string

BCP-47 dil kodu. Bileşen adı, sokak numarası gibi bir dille ilişkilendirilmemişse bu öğe 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 mevcut olduğunu ve adresin geri kalanında mantıklı 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ış olabilir. Örneğin, adresin geri kalanına uymayan bir mahalle.

Coğrafi kod

Girişin coğrafi olarak 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 olarak kodlanmış konumu.

Adresler, enlem/boylam koordinatları veya artı kodlarını kullanmak yerine yer kimliklerinin kullanılması tercih edilir. Güzergah belirleme veya sürüş yol tariflerini hesaplarken koordinatların kullanılması, her zaman, noktanın söz konusu koordinatlara en yakın yola tutturulmasını sağlar. Bu yol, hedefe hızlı veya güvenli bir şekilde ulaşacak bir yol olmayabilir ve mülke erişim noktasına yakın bir yerde olmayabilir. Ayrıca, bir konuma ters coğrafi kod eklendiğinde, döndürülen adresin orijinal adresle eşleşeceği konusunda herhangi bir garanti verilmez.

plusCode

object (PlusCode)

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

bounds

object (Viewport)

Coğrafi kodlu 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 olarak kodlandığı yerin PlaceID değeridir.

Yer kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz.

placeTypes[]

string

Girişin coğrafi olarak kodlandığı yer türleri. Örneğin, ['locality', 'political']. Türlerin tam listesini burada bulabilirsiniz.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çift olarak 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: 14mx14 m (derecenin 1/8000'i) veya daha küçük bir dikdörtgen tanımlayan genel kod ve ön eki bir referans konumuyla değiştiren bileş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 "33GV+HQ, Ramberg, Norveç" gibi bir bileşik kodudur. Global kodun son ekini içeren ve öneki, bir referans varlığına ait biçimlendirilmiş adla değiştirir.

Görüntü alanı

low ve high noktasının çapraz olarak iki yönünde çapraz olarak gösterilen enlem-boylam görüntü alanı. Görüntü alanı, kapalı bir bölge olarak kabul edilir. Yani kendi sınırlarını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (her ikisi de dahil) arasında olmalıdır. Çeşitli durumlar şunlardır:

  • low = high olursa, görüntü alanı bu tek 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ş olur.

  • low.latitude > high.latitude ise enlem aralığı boş olur.

Hem low hem de high doldurulmalı ve gösterilen kutu (yukarıdaki tanımlarda belirtildiği gibi) boş bırakılamaz. Boş görüntü alanı hatayla sonuçlanır.

Ö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 düşük noktası.

high

object (LatLng)

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

AddressMetadata

Adresin meta verileri. metadata öğesinin, Address Validation API'ye gönderilen her adres için tamamen doldurulacağı garanti edilmez.

JSON gösterimi
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
Alanlar
business

boolean

Bunun bir işletmenin adresi olduğunu belirtir. Ayarlanmadan bırakılırsa değerin bilinmediğini belirtir.

poBox

boolean

Bir posta kutusunun adresini belirtir. Ayarlanmadan bırakılırsa değerin bilinmediğini belirtir.

residential

boolean

Bunun bir ikamet adresi olduğunu belirtir. Ayarlanmadan bırakılırsa değerin bilinmediğini belirtir.

UspsData

Adrese ilişkin USPS verileri. uspsData adresinin, Address Validation API'ye gönderilen her ABD veya Halkla İlişkiler adresi için tamamen 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'nin standartlaştırılmış adresi.

deliveryPointCode

string

2 haneli teslimat noktası kodu

deliveryPointCheckDigit

string

Teslimat noktası kontrol basamağı. Bu numara, mekanik olarak taranan postalar için delivery_point_barcode 'un sonuna eklenir. delivery_point_barcode, deliveryPointCheckDigit, posta kodu ve ZIP+4 değerlerinin tüm hanelerini eklediğinizde 10'a bölünen bir sayı elde edersiniz.

dpvConfirmation

string

DPV onayı için olası değerler. Tek bir karakter döndürür veya değer döndürmez.

  • N: DPV onaylayamadı birincil ve ikincil numara bilgileri.
  • D: Adres yalnızca birincil numara için DPV onaylandı 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 onaylandı.
  • Boş: Yanıt bir dpvConfirmation değeri içermiyorsa adres DPV onayı için gönderilmemiştir.
dpvFootnote

string

Teslim noktası doğrulamasındaki dipnotlar. Birden çok dipnot aynı dizede birleştirilebilir.

  • 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şen (tüm bileşenler)
  • CC: İkincil numara eşleşmiyor ve gerekli değil
  • C1: İkincil numara eşleşmiyor ancak zorunlu
  • N1: Çok katlı adresin ikincil numarası eksik
  • M1: Birincil numara eksik
  • M3: Birincil numara geçersiz
  • P1: Giriş adresi PO, RR veya HC kutusu numarası eksik
  • P3: Giriş adresi PO, RR veya HC Box numarası geçersiz
  • F1: Askeri bir adresle eşleşen giriş adresi
  • 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: Bilgilendirilen Adres tanımlandı
  • TA: Sondaki alfa sürümü bırakarak eşleşen birincil sayı
dpvCmra

string

Adresin bir CMRA (Ticari Posta Alma Ajansı), yani 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
  • N: Adres bir CMRA değil
dpvVacant

string

Bu yer boş mu? Tek bir karakter döndürür.

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

string

Bu, resmi olmayan bir adres mi yoksa etkin bir adres mi? Hiçbir istatistik adresi, sürekli olarak boş 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ü 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 teslim edilebilir hale gelmemiş adresler. Örneğin, arsa ve birincil sayıların belirlendiği ancak doluluk için henüz bir yapı bulunmayan yeni bir alt bölüm gösterilebilir.
  • 3: Çarpışma - Gerçekte DPV'nin geçerli olmadığı adresler.
  • 4: CMZ (Üniversite, Askeri ve Diğer Türler): ZIP + 4 kayıt USPS'nin verilere dahil ettiği kayıtlar.
  • 5: Normal: Teslimat almayan adresleri ve adreslerin olası teslimat olarak sayılmadığını belirtir.
  • 6: İkincil Zorunlu - Adres için ikincil bilgi gereklidir.
dpvDrop

string

İşaret, postaların 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, sitedeki tek bir alıcıya teslim edilmez.
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ü yapılmadığını gösterir. Tek bir karakter döndürür.

  • Y: Posta teslimatı, haftanın her günü gerçekleştirilmez.
  • N: Posta teslimatının haftanın her günü yapılmadığına dair herhangi bir gösterge yoktur.
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, yayınlanmama günüdür 0x10 – Salı, yayınlanmama günüdür 0x08 – Çarşamba günü teslimat yapılmaz günüdür 0x04 – Perşembe günü teslimat yapılmaz 0x02 – Cuma günü teslim edilmedidir 0x0

dpvNoSecureLocation

string

Bayrak, kapının erişilebilir olduğunu ancak güvenlik nedeniyle pakete bırakılamayacağını gösterir. Tek bir karakter döndürür.

  • Y: Paket, güvenlikle ilgili nedenlerden dolayı bırakılmayacaktır.
  • 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ş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

İş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şilemiyor.
  • N: Kapıya erişilemediğini belirten bir gösterge yok.
dpvEnhancedDeliveryCode

string

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

  • Y: Adres, birincil ve ikincil numaralar için DPV onaylandı.
  • N: DPV onaylayamadı birincil ve ikincil numara bilgileri.
  • S: Adres, yalnızca birincil numara için DPV onaylandı. İkincil numara bilgisi mevcut ancak onaylanmadı. DPV eşleşmesinin sağlanması ve ikincil bilgilerin zorunlu kılınması için birincil numarada sondaki tek bir alfa kaldırıldı.
  • D: Adres yalnızca birincil numara için DPV onaylandı ve ikincil numara bilgileri eksikti.
  • R: Adres onaylandı ancak hayali rota R777 ve R779'a ve USPS teslimatına atanmış.
carrierRoute

string

Kargo şirketi rota kodu. Bir harf öneki ve üç basamaklı rota tanımlayıcısından oluşan dört karakterli kod.

Önekler:

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

string

Operatör rota ücreti sıralama göstergesi.

ewsNoMatch

boolean

Teslimat adresi eşleştirilebilir ancak EWS dosyası, tam eşlemenin yakında kullanıma sunulacağını belirtiyor.

postOfficeCity

string

Ana postane şehri.

postOfficeState

string

Ana postane eyaleti.

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) 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 YAYINLAMA. Bu, bir Genel Teslim kaydı ile eşleşiyor.
  • H: Bina / Apartman. Bu, bir Bina veya Apartman kaydı ile eşleşiyor.
  • P: POSTA OFİS KUTUSU. Bu bir Posta Kutusu ile eşleşme.
  • R: KURAL GÜZEL veya ARAÇ SÖZLEŞMESİ: Bu, bir Kırsal Güzergah veya Otoyol Sözleşme kaydı ile eşleşmedir; her ikisi de ilişkili Kutu Numarası aralıklarına sahip olabilir.
  • S: SOKAK KAYDI: Bu, geçerli bir birincil numara aralığı içeren sokak kaydı ile eşleşmedir.
defaultAddress

boolean

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

errorMessage

string

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

Bu hata mevcut olduğunda USPS veri alanları doldurulmayabilir.

cassProcessed

boolean

İsteğin CASS işlendiğini gösteren 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 kentleşme adı.

cityStateZipAddressLine

string

Şehir + eyalet + posta kodu.

city

string

Şehir adı.

state

string

2 harfli durum kodudur.

zipCode

string

Posta kodu ör. 10009.

zipCodeExtension

string

4 haneli posta kodu uzantısı (ör. 5023).