- HTTP isteği
- İstek metni
- 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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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 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 |
enableUspsCass |
USPS CASS uyumlu modunu etkinleştirir. Bu durum yalnızca Bileşenleştirilmiş 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 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 |
İ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. 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 ( |
Alanlar | |
---|---|
result |
Adres doğrulamasının sonucu. |
responseId |
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 |
|
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 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, |
languageCode |
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 |
İ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 |
İ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 |
İ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 |
İ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 |
İsteğe bağlı. Adresin semti. Örneğin; mahalleler, ilçeler, semtler olabilir. |
addressLines[] |
Zorunlu. Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. |
recipients[] |
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 |
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 |
Önizleme: İngilizce olarak bir |
ValidationResult
Adres doğrulamanın sonucu.
JSON gösterimi |
---|
{ "verdict": { object ( |
Alanlar | |
---|---|
verdict |
Genel karar işaretleri |
address |
Coğrafi kodlamanın aksine, adresin kendisiyle ilgili bilgiler. |
geocode |
Adresin coğrafi kodlaması yapılan konum ve yerle ilgili 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 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.
Not: |
Sonuç
Adres doğrulama sonucu ve coğrafi koda üst düzey 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, giriş adresi belirli bir apartman numarasını içeriyorsa buradaki |
validationGranularity |
API'nin adresi tamamen validate ayrıntı düzeyi. Örneğin, Adres başına bileşen doğrulama sonucu |
geocodeGranularity |
Bu, zaman zaman yukarıdaki |
addressComplete |
Çözümlenmemiş jeton veya beklenmedik ya da eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa |
hasUnconfirmedComponents |
En az bir adres bileşeni kategorize edilemiyor veya doğrulanamıyor. Ayrıntılar için |
hasInferredComponents |
Girişte yer almayan 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ü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 ( |
Alanlar | |
---|---|
formattedAddress |
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 |
Posta adresi olarak gösterilen, sonradan işlenmiş adres. |
addressComponents[] |
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[] |
Doğru biçimlendirilmiş bir posta adresinde olması beklenen ancak girişte bulunmayan bileşenlerin türleri tahmin edilemedi. Bu tür bileşenler |
unconfirmedComponentTypes[] |
|
unresolvedTokens[] |
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 |
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ğuna dair kesinlik düzeyini gösterir. |
inferred |
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 |
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 |
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 |
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 |
Ad metni. Örneğin, sokak adı için "5. Cadde" veya sokak numarası için "1253". |
languageCode |
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 ( |
Alanlar | |
---|---|
location |
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 |
|
bounds |
Coğrafi olarak kodlanan yerin sınırları. |
featureSizeMeters |
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 |
Bu girişin coğrafi olarak kodlandığı yerin PlaceID. Yer Kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz. |
placeTypes[] |
Girişin coğrafi kodlamasını yaptığınız yerin türleri. Örneğin, |
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 |
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: 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 |
Yerin, 1/8000 x 1/8000 derecelik bir alanı (~14x14 metre) temsil eden, "9FWM33GV+HQ" gibi global (tam) kodu. |
compoundCode |
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 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.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 ( |
Alanlar | |
---|---|
low |
Zorunlu. Görüntü alanının alçak noktası. |
high |
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 |
Bir işletmenin adresi olduğunu belirtir. Ayarlanmaması, değerin bilinmediğini gösterir. |
poBox |
Bir posta kutusunun adresini belirtir. Ayarlanmaması, değerin bilinmediğini gösterir. |
residential |
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 ( |
Alanlar | |
---|---|
standardizedAddress |
USPS standartlaştırılmış adres. |
deliveryPointCode |
2 haneli teslimat noktası kodu |
deliveryPointCheckDigit |
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 |
DPV onayı için olası değerler. Tek bir karakter döndürür veya hiçbir değer döndürmez.
|
dpvFootnote |
Teslim noktası doğrulamasındaki dipnotlar. Birden çok dipnot aynı dize içinde birbirine dökülebilir.
|
dpvCmra |
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.
|
dpvVacant |
Burası boş bir yer mi? Tek bir karakter döndürür.
|
dpvNoStat |
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.
|
dpvNoStatReasonCode |
NoStat türünü belirtir. Neden kodunu int olarak döndürür.
|
dpvDrop |
İşaret, postaların bir 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ü gerçekleştirilmediğini gösterir. Tek bir karakter döndürür.
|
dpvNonDeliveryDaysValues |
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 |
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.
|
dpvPbsa |
Adresin PBSA kaydıyla eşleştirildiğini belirtir. Tek bir karakter döndürür.
|
dpvDoorNotAccessible |
Bayrak, USPS'nin posta teslim etmek için bir kapıyı çalamayacağı adresleri belirtir. Tek bir karakter döndürür.
|
dpvEnhancedDeliveryCode |
Adres için birden fazla DPV dönüş kodunun geçerli olduğunu belirtir. Tek bir karakter döndürür.
|
carrierRoute |
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:
|
carrierRouteIndicator |
Kargo şirketi rota hızı sıralama göstergesi. |
ewsNoMatch |
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 |
Ana postane şehri. |
postOfficeState |
Ana postane eyaletidir. |
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 dönüş kodu. |
lacsLinkIndicator |
LACSLink göstergesi. |
poBoxOnlyPostalCode |
Yalnızca Posta Kutusu posta kodu. |
suitelinkFootnote |
Sokak veya çok katlı binaların daire bilgileriyle eşleştirilmesinden elde edilen dipnotlar. İşletme adı eşleşmesi bulunursa ikincil numara döndürülür.
|
pmbDesignator |
PMB (Özel Posta Kutusu) birimi belirteci. |
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 adreslerin mevcut olduğunu gösteren gösterge. |
errorMessage |
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 |
İ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 |
İlk adres satırı. |
firm |
Firma adı. |
secondAddressLine |
İkinci adres satırı. |
urbanization |
Porto Riko'daki kentleşme adı. |
cityStateZipAddressLine |
Şehir + eyalet + posta kodu. |
city |
Şehir adı. |
state |
2 harfli eyalet kodu. |
zipCode |
Posta kodu, ör. 10009. |
zipCodeExtension |
4 haneli posta kodu uzantısı (ör. 5023). |