Dizin
AddressValidation
(arayüz)Address
(message)AddressComponent
(message)AddressComponent.ConfirmationLevel
(enum)AddressMetadata
(message)ComponentName
(message)Geocode
(message)LanguageOptions
(message)PlusCode
(message)ProvideValidationFeedbackRequest
(message)ProvideValidationFeedbackRequest.ValidationConclusion
(enum)ProvideValidationFeedbackResponse
(message)UspsAddress
(message)UspsData
(message)ValidateAddressRequest
(message)ValidateAddressResponse
(message)ValidationResult
(message)Verdict
(message)Verdict.Granularity
(enum)
AddressValidation
Adresleri doğrulayan hizmet.
ProvideValidationFeedback |
---|
Doğrulama denemelerinin sonucuyla ilgili geri bildirim. Bu, aynı adres için yapılan bir dizi doğrulama çağrısından sonra yapılan son çağrı olmalı ve işlem tamamlandıktan sonra çağrılmalıdır. Bu e-posta, bir adresin tam olarak doğrulanması için gereken |
ValidateAddress |
---|
Bir adresi doğrular. |
Adres
İşlenen adresin ayrıntıları. İşleme sonrası, adresin yanlış yazılan kısımlarının düzeltilmesi, yanlış kısımların değiştirilmesi ve eksik kısımların tahmin edilmesi işlemlerini içerir.
Alanlar | |
---|---|
formatted_ |
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. Not: Bu adresin biçimi, |
postal_ |
Posta adresi olarak temsil edilen, son işleme tabi tutulan adres. |
address_ |
Sırasız liste. Biçimlendirilmiş ve düzeltilmiş adresin doğrulama bilgileriyle birlikte tek tek adres bileşenleri. Bu sayfada, bileşenlerin doğrulama durumu hakkında bilgi verilir. Adres bileşenleri belirli bir şekilde sıralanmamalıdır. Listede adres bileşenlerinin sıralaması hakkında herhangi bir varsayımda bulunmayın. |
missing_ |
Doğru biçimlendirilmiş bir posta adresinde bulunması beklenen ancak girişte bulunmayan VE çıkarılamayan bileşen türleri. Bu tür bileşenler |
unconfirmed_ |
|
unresolved_ |
Girişteki çözülemeyen jetonlar. Bu, bir adresin geçerli bir parçası olarak tanınmayan bir giriş olabilir. Örneğin, "Parsel 0000123123 ve 0000456456 Cadde # Guthrie Center IA 50115 ABD" gibi bir giriş için çözülmemiş jetonlar |
AddressComponent
Sokak, şehir veya eyalet gibi bir adres bileşenini temsil eder.
Alanlar | |
---|---|
component_ |
Bu bileşenin adı. |
component_ |
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. |
confirmation_ |
Bileşenin doğru olduğundan emin olduğumuz kesinlik düzeyini gösterir. |
inferred |
Bileşenin girişin bir parçası olmadığını ancak adres konumu için tahmin edildiğini ve tam bir adres için sağlanmasının gerektiğini gösterir. |
spell_ |
Bileşen adındaki bir yazım hatasının düzeltilmesini gösterir. API, her zaman bir yazım varyantından diğerine yapılan değişiklikleri işaretlemez (ör. "centre" yerine "center"). Ayrıca, "Amphitheater Pkwy"nin "Amphitheatre Pkwy" olarak değiştirilmesi gibi yaygın yazım hatalarını her zaman işaretlemez. |
replaced |
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ğildir. Giriş bileşeni farklı bir bileşenle değiştirilmiştir. |
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. |
ConfirmationLevel
Onay düzeyleri için olası farklı değerler.
Sıralamalar | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
Varsayılan değer. Bu değer kullanılmamaktadır. |
CONFIRMED |
Bu bileşenin mevcut olduğunu ve adresin geri kalanıyla uyumlu olduğunu doğrulayabildik. |
UNCONFIRMED_BUT_PLAUSIBLE |
Bu bileşen doğrulanamadı ancak var olduğu varsayılabilir. Örneğin, belirli ev numaralarının bilinmediği bir sokaktaki bilinen geçerli numara aralığında yer alan sokak numarası. |
UNCONFIRMED_AND_SUSPICIOUS |
Bu bileşen onaylanmadı ve yanlış olması muhtemel. Örneğin, adresin geri kalanına uymayan bir mahalle. |
AddressMetadata
Adresin meta verileri. metadata
değerinin, Address Validation API'ye gönderilen her adres için tam olarak doldurulacağı garanti edilmez.
Alanlar | |
---|---|
business |
Bunun bir işletmenin adresi olduğunu belirtir. Ayarlanmadan bırakılırsa değerin bilinmediğini belirtir. |
po_ |
Adresin posta kutusuna ait olduğunu belirtir. Ayarlanmamışsa değerin bilinmediğini gösterir. |
residential |
Bu adresin bir konutun adresini belirtir. Ayarlanmamışsa değerin bilinmediğini gösterir. |
ComponentName
Bileşenin adı için bir sarmalayıcı.
Alanlar | |
---|---|
text |
Ad metni. Örneğin, sokak adı için "5. Cadde" veya bina numarası için "1253". |
language_ |
BCP-47 dil kodu. Bileşen adı bir dil (ör. bina numarası) ile ilişkilendirilmemişse bu alan gösterilmez. |
Coğrafi kod
Girişin coğrafi kodlandığı yerle ilgili bilgileri içerir.
Alanlar | |
---|---|
location |
Girişin coğrafi kodlanmış konumu. Adresler, enlem/boylam koordinatları veya plus code'lar yerine yer kimlikleri 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 konum ters coğrafi kodlandığında döndürülen adresin orijinal adresle eşleşeceği garanti edilmez. |
plus_ |
|
bounds |
Coğrafi olarak kodlanmış yerin sınırları. |
feature_ |
Coğrafi kodlu yerin metre cinsinden boyutu. Bu, coğrafi kodlanmış konumun kabalığının başka bir ölçümüdür ancak semantik anlam yerine fiziksel boyuttadır. |
place_ |
Bu girişin coğrafi kodladığı yerin PlaceID'si. Yer kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz. |
place_ |
Girişin coğrafi olarak kodlandığı yer türleri. Örneğin, |
LanguageOptions
Önizleme: Bu özellik önizleme sürümündedir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.
Address Validation API'nin yanıta ek bilgiler eklemesini sağlar.
Alanlar | |
---|---|
return_ |
Önizleme: İngilizce bir |
PlusCode
Plus code (http://plus.codes), iki biçime sahip bir konum referansı: 14 m x 14 m (derecenin 1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan genel kod ve ön eki referans konumla değiştiren birleşik kod.
Alanlar | |
---|---|
global_ |
"9FWM33GV+HQ" gibi yerin küresel (tam) kodu. 1/8000 ile 1/8000 derecelik bir alanı (~14x14 metre) temsil eder. |
compound_ |
Yerin birleşik kodu ("33GV+HQ, Ramberg, Norveç" gibi). Bu kod, genel kodun son ekini içerir ve ön eki, referans öğenin biçimlendirilmiş adıyla değiştirir. |
ProvideValidationFeedbackRequest
Doğrulama geri bildirimi gönderme isteği.
Alanlar | |
---|---|
conclusion |
Zorunlu. Doğrulama denemelerinin sonucu. Bu alan |
response_ |
Zorunlu. Bu geri bildirimin gönderildiği yanıtın kimliği. Bu, bir dizi adres doğrulama denemesinde ilk yanıttaki [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] olmalıdır. |
ValidationConclusion
Bir adresi doğrulamak için gereken adres doğrulama isteği dizisinin olası nihai sonuçları.
Sıralamalar | |
---|---|
VALIDATION_CONCLUSION_UNSPECIFIED |
Bu değer kullanılmamaktadır. ProvideValidationFeedbackRequest.conclusion alanı VALIDATION_CONCLUSION_UNSPECIFIED olarak ayarlanırsa INVALID_ARGUMENT hatası döndürülür. |
VALIDATED_VERSION_USED |
İşlem için Address Validation API tarafından döndürülen adresin sürümü kullanıldı. |
USER_VERSION_USED |
İşlem için kullanıcı tarafından sağlanan adresin sürümü kullanıldı |
UNVALIDATED_VERSION_USED |
Adresin, son doğrulama denemesinden sonra girilen ancak yeniden doğrulanmamış bir sürümü işlem için kullanıldı. |
UNUSED |
İşlem iptal edildi ve adres kullanılmadı. |
ProvideValidationFeedbackResponse
Bu türde alan yoktur.
Doğrulama geri bildiriminin yanıtı.
Geri bildirim başarıyla gönderilirse yanıt boş olur.
UspsAddress
ABD adresinin USPS temsili.
Alanlar | |
---|---|
first_ |
İlk adres satırı. |
firm |
Firma adı. |
second_ |
İkinci adres satırı. |
urbanization |
Porto Riko'daki kentleşmenin adı. |
city_ |
Şehir + eyalet + posta kodu. |
city |
Şehir adı. |
state |
2 harfli durum kodudur. |
zip_ |
Posta kodu ör. 10009. |
zip_ |
4 haneli posta kodu uzantısı (ör. 5023). |
UspsData
Adresin USPS verileri. Address Validation API'ye gönderilen her ABD veya PR adresi için uspsData
değerinin tam olarak doldurulacağı garanti edilmez. Yanıtın birincil kısmı olarak uspsData öğesini kullanıyorsanız yedek adres alanlarını yanıta entegre etmeniz önerilir.
Alanlar | |
---|---|
standardized_ |
USPS standartlaştırılmış adresi. |
delivery_ |
2 haneli teslimat noktası kodu |
delivery_ |
Teslimat noktası kontrol basamağı. Bu numara, mekanik olarak taranan posta için delivery_point_barcode değerinin sonuna eklenir. delivery_point_barcode, delivery_point_check_digit, postal_code ve ZIP+4 değerlerinin tüm basamakları birlikte eklendiğinde 10'a bölünebilen bir sayı elde edilmelidir. |
dpv_ |
DPV onayı için olası değerler. Tek bir karakter döndürür veya hiçbir değer döndürmez.
|
dpv_ |
Teslim noktası doğrulamasındaki dipnotlar. Birden fazla dipnot aynı dizeye bağlanabilir.
|
dpv_ |
Adresin CMRA (Ticari Posta Alma Ajansı) olup olmadığını belirtir. CMRA, müşteriler için posta alan özel bir işletmedir. Tek bir karakter döndürür.
|
dpv_ |
Bu yer boş mu? Tek bir karakter döndürür.
|
dpv_ |
Bu adres istatistikleri olmayan bir adres mi yoksa etkin bir adres mi? Statik adresler, sürekli olarak kullanılmayan veya USPS'nin hizmet vermediği adreslerdir. Tek bir karakter döndürür.
|
dpv_ |
NoStat türünü belirtir. Neden kodunu int olarak döndürür.
|
dpv_ |
İşaret, postanın bir sitedeki tek bir alıcıya teslim edildiğini gösterir. Tek bir karakter döndürür.
|
dpv_ |
Postanın sokak adresine teslim edilmediğini gösterir. Tek bir karakter döndürür.
|
dpv_ |
İşaret, posta tesliminin haftanın her günü yapılmadığını gösterir. Tek bir karakter döndürür.
|
dpv_ |
Yayınlanmayan günleri tanımlayan tam sayı. Bit işaretleri kullanılarak sorgulanabilir: 0x40 – Pazar teslimat yapılmayan gündür 0x20 – Pazartesi teslimat yapılmayan gündür 0x10 – Salı teslimat yapılmayan gündür 0x08 – Çarşamba teslimat yapılmayan gündür 0x04 – Perşembe teslimat yapılmayan gündür 0x02 – Cuma teslimat yapılmayan gündür 0x01 – Cumartesi teslimat yapılmayan gündür |
dpv_ |
İşaret, kapıya erişilebildiğini ancak güvenlik nedeniyle paketin bırakılmayacağını gösterir. Tek bir karakter döndürür.
|
dpv_ |
Adresin PBSA kaydıyla eşleştiğini gösterir. Tek bir karakter döndürür.
|
dpv_ |
İşaret, USPS'nin posta teslim etmek için kapıyı açamayacağı adresleri gösterir. Tek bir karakter döndürür.
|
dpv_ |
Adres için birden fazla DPV dönüş kodu geçerli olduğunu gösterir. Tek bir karakter döndürür.
|
carrier_ |
Kargo şirketinin rota kodu. Bir harfli ön ek ve üç haneli rota tanımlayıcısı içeren dört karakterli bir kod. Önekler:
|
carrier_ |
Operatör rota ücreti sıralama göstergesi. |
ews_ |
Teslimat adresi eşleştirilebilir ancak EWS dosyası, bir tam eşlemenin yakında kullanıma sunulacağını belirtiyor. |
post_ |
Ana posta ofisi şehri. |
post_ |
Ana posta ofisi durumu. |
abbreviated_ |
Kısaltılmış şehir. |
fips_ |
FIPS ilçe kodu. |
county |
İlçe adı. |
elot_ |
Geliştirilmiş Seyahat Hattı (eLOT) numarası. |
elot_ |
eLOT Artan/Azalan İşaret (A/D). |
lacs_ |
LACSLink dönüş kodu. |
lacs_ |
LACSLink göstergesi. |
po_ |
Yalnızca posta kutusu posta kodu. |
suitelink_ |
Bir sokak veya yüksek bina kaydının daire bilgileriyle eşleşmesinden oluşan dipnotlar. İşletme adı eşleşmesi bulunursa ikincil numara döndürülür.
|
pmb_ |
PMB (Özel Posta Kutusu) birimi tanımlayıcısı. |
pmb_ |
PMB (Özel Posta Kutusu) numarası; |
address_ |
Giriş adresiyle eşleşen adres kaydının türü.
|
default_ |
Varsayılan bir adresin bulunduğunu ancak daha spesifik adreslerin bulunduğunu gösteren gösterge. |
error_ |
USPS veri alımıyla ilgili hata mesajı. Bu alan, yapay olarak oluşturulmuş adreslerin algılanması nedeniyle USPS işleme işlemi askıya alındığında doldurulur. Bu hata mevcut olduğunda USPS veri alanları doldurulmayabilir. |
cass_ |
İsteğin CASS ile işlendiğini gösteren gösterge. |
ValidateAddressRequest
Adres doğrulama isteği.
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, |
previous_ |
İlk adres doğrulama isteği için bu alan boş olmalıdır. Tek bir adresi tam olarak doğrulamak için daha fazla istek gerekirse (örneğin, kullanıcının ilk doğrulamadan sonra yaptığı değişikliklerin yeniden doğrulanması gerekiyorsa) her takip isteği bu alanı doğrulama sırasının ilk yanıtındaki |
enable_ |
USPS CASS uyumlu modu etkinleştirir. Bu durum, Bileşenli bir |
language_ |
İsteğe bağlı. Önizleme: Bu özellik önizleme aşamasındadır (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin. Adres Doğrulama API'sinin yanıta ek bilgiler eklemesini sağlar. |
session_ |
İsteğe bağlı. Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan dize. En fazla 36 ASCII karakter uzunluğunda, URL ve dosya adı için güvenli bir base64 dizesi olmalıdır. Aksi takdirde 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 olabilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. Not: Adres Doğrulama, yalnızca Autocomplete API ile değil, Autocomplete (Yeni) API ile olan oturumlarda kullanılabilir. Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/session-pricing adresini ziyaret edin. |
ValidateAddressResponse
Adres doğrulama isteğine verilen yanıt.
Alanlar | |
---|---|
result |
Adres doğrulamasının sonucu. |
response_ |
Bu yanıtı tanımlayan UUID. Adresin yeniden doğrulanması gerekiyorsa bu UUID yeni isteğe eklenmelidir. |
ValidationResult
Bir adresin doğrulanmasının sonucu.
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. |
usps_ |
USPS tarafından sağlanan ek teslim edilebilirlik işaretleri. Yalnızca |
english_ |
Önizleme: Bu özellik önizleme sürümündedir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca, bu ürün ve özelliklerde yapılan değişiklikler GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin. Adresin İngilizceye çevrilmiş hali. Çevrilmiş adresler API girişi olarak yeniden kullanılamaz. Hizmet, kullanıcının orijinal olarak sağlanan adresin doğrulanmasını onaylamak veya reddetmek için kendi ana dilini kullanabilmesi amacıyla bu seçenekleri sunar. Adresin bir kısmının İngilizce çevirisi yoksa hizmet bu kısmı Latin alfabesi kullanan alternatif bir dilde döndürür. Alternatif dilin nasıl seçildiğiyle ilgili açıklama için burayı inceleyin. Adresin bir kısmının Latin alfabesi kullanan bir dilde çevirisi veya transliterasyonu yoksa hizmet bu kısmı adresle ilişkili yerel dilde döndürür.
Not: |
Sonuç
Adres doğrulama sonucuna ve coğrafi kodlamaya genel bakış.
Alanlar | |
---|---|
input_ |
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 daire numarasını içeriyorsa buradaki |
validation_ |
API'nin adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Örneğin, Adres bileşeni başına doğrulama sonucunu |
geocode_ |
Bu, zaman zaman yukarıdaki |
address_ |
Çözümlenmemiş simge ya da beklenmedik veya eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa değerin |
has_ |
En az bir adres bileşeni kategorize edilemiyor veya doğrulanamıyor. Ayrıntılar için |
has_ |
Girişte bulunmayan en az bir adres bileşeni çıkarıldı (eklendi). Ayrıntılar için |
has_ |
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 posta adresini ne kadar ayrıntılı bir şekilde tanımladığını gösterir. Örneğin, "123 Ana Cadde, Redwood City, CA, 94061" gibi bir adres PREMISE
'ü, "Redwood City, CA, 94061" gibi bir adres ise LOCALITY
'ü tanımlar. Ancak Redwood City'deki "123 Main Street" için coğrafi kod bulamıyorsak adres daha ayrıntılı olsa bile döndürülen coğrafi kod LOCALITY
ayrıntı düzeyinde olabilir.
Sıralamalar | |
---|---|
GRANULARITY_UNSPECIFIED |
Varsayılan değer. Bu değer kullanılmıyor. |
SUB_PREMISE |
Apartman gibi bina düzeyinin altındaki sonuç. |
PREMISE |
Bina düzeyinde sonuç. |
PREMISE_PROXIMITY |
Adresin bina düzeyindeki konumuna yaklaşık olarak karşılık gelen bir coğrafi kod. |
BLOCK |
Adres veya coğrafi kod bir bloğu gösterir. Yalnızca Japonya gibi blok düzeyinde adresleme bulunan bölgelerde kullanılır. |
ROUTE |
Coğrafi kod veya adres, cadde, yol veya otoyol gibi rotaya göre ayrıntılıdır. |
OTHER |
Teslim edilebilir olmadıkları için bir arada toplanan diğer tüm ayrıntı düzeyiler. |