- HTTP isteği
- İstek gövdesi
- Yanıt metni
- PostalAddress
- LanguageOptions
- ValidationResult
- Sonuç
- Ayrıntı düzeyi
- Adres
- AddressComponent
- ComponentName
- ConfirmationLevel
- Coğrafi kod
- LatLng
- PlusCode
- Görünüm
- AddressMetadata
- UspsData
- UspsAddress
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 ( |
Alanlar | |
---|---|
address |
Zorunlu. Doğrulanan adres. Biçimlendirilmemiş adresler Bu girişteki alanların toplam uzunluğu 280 karakteri aşmamalıdır. Desteklenen bölgeleri burada bulabilirsiniz. Giriş adresindeki Address Validation API, |
previousResponseId |
İ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 |
enableUspsCass |
USPS CASS uyumlu modu etkinleştirir. Bu, yalnızca Bileşenlere ayrılmış bir |
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 |
İ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. Uygulamanız her oturum için yeni bir jeton oluşturmalıdı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 ( |
Alanlar | |
---|---|
result |
Adres doğrulamasının sonucu. |
responseId |
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 temsil eder, ör. veya ödeme adresleri için de geçerlidir. Posta adresi sayesinde, posta hizmetleri bir binaya ürün teslim edebilir. Kutu veya benzeri. 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 |
|
regionCode |
İ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 bakın. Örnek: "CH" kullanmaya başladım. 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, |
languageCode |
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 |
İ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 |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu ad çoğu bölgede kullanılmaz. Kullanıldığı yerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya "sektör kodunu" temsil eden yalnızca tek bir sayıdır (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili). |
administrativeArea |
İ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 doldurulmadan bırakılmalıdır. |
locality |
İ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 |
İsteğe bağlı. Adresin alt konumu. Örneğin; mahalle, kaza, ilçe olabilir. |
addressLines[] |
Zorunlu. Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. |
recipients[] |
Lütfen bu alanı ayarlamayı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 |
Lütfen bu alanı ayarlamayı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 |
Önizleme: İngilizce olarak bir |
ValidationResult
Bir adresin doğrulanmasının sonucu.
JSON gösterimi |
---|
{ "verdict": { object ( |
Alanlar | |
---|---|
verdict |
Genel karar işaretleri |
address |
Coğrafi kod yerine adresin kendisiyle ilgili bilgiler. |
geocode |
Adresin coğrafi olarak kodlandığı konum ve yer hakkında bilgiler. |
metadata |
Teslimatla ilgili diğer bilgiler. |
uspsData |
USPS tarafından sağlanan ekstra teslimat işaretleri. Yalnızca |
englishLatinAddress |
Ö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.
Not: |
Sonuç
Adres doğrulama sonucu ve coğrafi koda genel bakış.
JSON gösterimi |
---|
{ "inputGranularity": enum ( |
Alanlar | |
---|---|
inputGranularity |
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 Örneğin girilen adres belirli bir apartman numarası içeriyorsa buradaki |
validationGranularity |
API'nin adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Örneğin, Adrese göre bileşen doğrulama sonucu |
geocodeGranularity |
Bu, zaman zaman yukarıdaki |
addressComplete |
Çözümlenmemiş simge ya da beklenmedik veya eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa değerin |
hasUnconfirmedComponents |
En az bir adres bileşeni kategorize edilemez veya doğrulanamıyor. Ayrıntılar için |
hasInferredComponents |
Girişte olmayan en az bir adres bileşeni tahmin edildi (eklendi). Ayrıntılar için |
hasReplacedComponents |
En az bir adres bileşeni değiştirildi. Ayrıntılar için |
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, Beşiktaş, İstanbul, 34111" gibi bir adres bir PREMISE
tanımlarken "Redwood City, CA, 94061" gibi bir şey belirtir bir LOCALITY
tanımlar. Ancak, "Ana Cadde No: 123" için bir coğrafi kod bulamazsak Redwood City'de döndürülen coğrafi kod, adres daha ayrıntılı olsa bile LOCALITY
ayrıntı düzeyine sahip 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 ( |
Alanlar | |
---|---|
formattedAddress |
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 |
Posta adresi olarak gösterilen, işlenmiş sonradan adres. |
addressComponents[] |
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[] |
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 |
unconfirmedComponentTypes[] |
|
unresolvedTokens[] |
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 |
AddressComponent
Sokak, şehir veya eyalet gibi bir adres bileşenini temsil eder.
JSON gösterimi |
---|
{ "componentName": { object ( |
Alanlar | |
---|---|
componentName |
Bu bileşenin adı. |
componentType |
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 |
Bileşenin doğru olduğundan emin olduğumuz kesinlik düzeyini gösterir. |
inferred |
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 |
Bileşen adındaki bir yazım hatasının düzeltilmesini gösterir. Bu API, bir yazım varyantından diğerine yapılan değişiklikleri her zaman işaretlemez (örneğin, "orta" ifadesinin değiştirilmesi gibi). "ortaya" getirin. Ayrıca, "Amfiteatr Pkwy" değiştirilirken olduğu gibi yaygın yazım hataları da her zaman işaretlenmez. "Amfiteatr Pkwy" olarak değiştirin. |
replaced |
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 |
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 |
Ad metni. Örneğin, "5. Cadde" sokak adı veya "1253" için sokak numarası anlamına gelir. |
languageCode |
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 ( |
Alanlar | |
---|---|
location |
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 |
|
bounds |
Coğrafi kodlu yerin sınırları. |
featureSizeMeters |
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 |
Bu girişin coğrafi olarak kodlandığı yerin PlaceID değeridir. Yer kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz. |
placeTypes[] |
Girişin coğrafi olarak kodlandığı yer türleri. Örneğin, |
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 |
Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır. |
longitude |
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 |
Yerin 1/8.000 x 1/8.000 derecelik bir alanı (~14 x 14 metre) temsil eden "9FWM33GV+HQ" gibi global (tam) kodu. |
compoundCode |
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.Eğer
low.longitude
>high.longitude
ise, boylam aralığı tersine çevrilir (görüntü alanı 180 derecelik boylam çizgisini geçer).low.longitude
= -180 derece vehigh.longitude
= 180 derece ise görüntü alanı tüm boylamları içerir.low.longitude
= 180 derece vehigh.longitude
= -180 derece ise boylam aralığı boş olur.Eğer
low.latitude
>high.latitude
, enlem aralığı boş.
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 ( |
Alanlar | |
---|---|
low |
Zorunlu. Görüntü alanının düşük noktası. |
high |
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 |
Bunun bir işletmenin adresi olduğunu belirtir. Ayarlanmadan bırakılırsa değerin bilinmediğini belirtir. |
poBox |
Bir posta kutusunun adresini belirtir. Ayarlanmadan bırakılırsa değerin bilinmediğini belirtir. |
residential |
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 ( |
Alanlar | |
---|---|
standardizedAddress |
USPS'nin standartlaştırılmış adresi. |
deliveryPointCode |
2 haneli teslimat noktası kodu |
deliveryPointCheckDigit |
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 |
DPV onayı için olası değerler. Tek bir karakter döndürür veya değer döndürmez.
|
dpvFootnote |
Teslim noktası doğrulamasındaki dipnotlar. Birden çok dipnot aynı dizede birleştirilebilir.
|
dpvCmra |
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.
|
dpvVacant |
Bu yer boş mu? Tek bir karakter döndürür.
|
dpvNoStat |
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.
|
dpvNoStatReasonCode |
NoStat türünü gösterir. Neden kodunu int olarak döndürür.
|
dpvDrop |
İşaret, postaların sitedeki tek bir alıcıya teslim edildiğini gösterir. Tek bir karakter döndürür.
|
dpvThrowback |
Postanın açık adrese teslim edilmediğini belirtir. Tek bir karakter döndürür.
|
dpvNonDeliveryDays |
İşaret, posta tesliminin haftanın her günü yapılmadığını gösterir. Tek bir karakter döndürür.
|
dpvNonDeliveryDaysValues |
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ü yayınlanmama günüdür 0x0 |
dpvNoSecureLocation |
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.
|
dpvPbsa |
Adresin PBSA kaydıyla eşleştirildiğini belirtir. Tek bir karakter döndürür.
|
dpvDoorNotAccessible |
İşaret, USPS'nin posta teslim etmek için kapıyı açamayacağı adresleri gösterir. Tek bir karakter döndürür.
|
dpvEnhancedDeliveryCode |
Adres için birden fazla DPV iade kodunun geçerli olduğunu belirtir. Tek bir karakter döndürür.
|
carrierRoute |
Kargo şirketi rota kodu. Bir harf öneki ve üç basamaklı rota tanımlayıcısından oluşan dört karakterli kod. Önekler:
|
carrierRouteIndicator |
Operatör rota ücreti sıralama göstergesi. |
ewsNoMatch |
Teslimat adresi eşleştirilebilir ancak EWS dosyası, tam eşlemenin yakında kullanıma sunulacağını belirtiyor. |
postOfficeCity |
Ana postane şehri. |
postOfficeState |
Ana postane eyaleti. |
abbreviatedCity |
Kısaltılmış şehir. |
fipsCountyCode |
FIPS ülke kodu. |
county |
İlçe adı. |
elotNumber |
Geliştirilmiş Seyahat Hattı (eLOT) numarası. |
elotFlag |
eLOT Artan/Azalan İşaret (A/D). |
lacsLinkReturnCode |
LACSLink iade kodu. |
lacsLinkIndicator |
LACSLink göstergesi. |
poBoxOnlyPostalCode |
Yalnızca posta kutusu posta kodu. |
suitelinkFootnote |
Bir sokak veya yüksek düzey kaydı eşleştirmeden bina bilgilerine ait dipnotlar. İşletme adı eşleşmesi bulunursa ikincil numara döndürülür.
|
pmbDesignator |
PMB (Özel Posta Kutusu) birim tanımlayıcısı. |
pmbNumber |
PMB (Özel Posta Kutusu) numarası; |
addressRecordType |
Giriş adresiyle eşleşen adres kaydının türü.
|
defaultAddress |
Varsayılan bir adresin bulunduğunu, ancak daha spesifik bir adresin olduğunu belirten gösterge. |
errorMessage |
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 |
İ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 |
İlk adres satırı. |
firm |
Firma adı. |
secondAddressLine |
İkinci adres satırı. |
urbanization |
Porto Riko kentleşme adı. |
cityStateZipAddressLine |
Şehir + eyalet + posta kodu. |
city |
Şehir adı. |
state |
2 harfli durum kodudur. |
zipCode |
Posta kodu, ör. 10009. |
zipCodeExtension |
4 haneli posta kodu uzantısı, ör. 5023. |